MicroSoft DFS
Introduction
Microsoft Distributed File System (MS DFS) is a network file system technology that allows users to group shared folders located on different servers into a single logical namespace. DFS enhances file sharing and replication across multiple servers, providing improved data availability, fault tolerance, and scalability. It simplifies file access for users by presenting a unified view of the file system, regardless of the physical location of the files. Additionally, DFS supports load balancing and can automatically redirect users to alternate servers in case of a failure, making it a robust solution for managing distributed file systems in enterprise environments. With its integration into Microsoft Windows Server, DFS is widely adopted for enhancing data management and streamlining network resource access.
Getting Started
Compatibility
The MS DFS (Microsoft Distributed File System) O11ySource is expected to work with all versions of Windows Server that support DFS. It is recommended to use the latest updates for optimal performance and compatibility.
Data Collection Method
vuSmartMaps collects health and performance data for MS DFS using VuNet's Healthbeat agent. This agent collects data based on the source configuration.
Prerequisites
Inputs for Configuring Data Source
- DFS Host: The IP Address/FQDN of the MS DFS server. This field is the key to identify each server you add here.
- Period [in seconds]: How frequently data is gathered. The period should be between 60 seconds – 3000 seconds.
Firewall Requirement
To collect data from this O11ySource, ensure the following ports are opened:
| Source IP | Destination IP | Destination Port | Protocol | Direction |
|---|---|---|---|---|
| IP address of the Domain Controller | vuSmartMaps Data Collector End Point | 9092* | TCP | Inbound |
*Before providing the firewall requirements, please update the port based on the customer environment.
Configuring the Target
To gather DFS performance metrics, ensure DFS Namespace and Replication services are enabled on the Windows Server.
Configuration Steps
Enablethe MS DFS O11ySource.- Select the Sources tab and press the
+button to add a new MS DFS instance to be monitored. - Add the required details and then click on
Next. - The following packages will be available for download:Download Healthbeat Installation Binary - Downloads the full Healthbeat package with required configurations for a fresh installationDownload Healthbeat Update Configuration - Downloads the agent configuration package to update an existing Healthbeat installation
- Download the agent installation or update package, then click
Finishto close the data source window.
Metrics Collected
| Name | Description | Data Type |
|---|---|---|
| timestamp | Timestamp | DateTime64 |
| target | The target system or environment for the metric data. | String |
| host | The hostname of the server where the event was logged. | String |
| hostname | The hostname of the machine sending the metric data. | String |
| tenant_id | Unique identifier for the tenant or customer within a multi-tenant environment. Typically used for segregating data in multi-tenant systems. | String |
| bu_id | Represents the Business Unit ID. This is used to identify different business units within an organization for metric tracking and analysis. | String |
| @timestamp | The timestamp in string format. | String |
| topic_name | The topic or category associated with the metric data. | String |
| metricset_name | The name of the metric set being collected. | String |
| event_module | The module or component name where the event or metric originated. This helps in categorizing data for more detailed analysis. | String |
| OS | The operating system of the machine where the metric was collected. This field helps in understanding the environment from which the data is sourced. | String |
| Owner | The owner or administrator responsible for the server or system generating the metrics. This is useful for identifying the point of contact for any issues or insights related to the data. | String |
| Role | The role or function of the server/system (e.g., "File Server", "Database Server"). It helps in categorizing and analyzing metrics based on system functions. | String |
| dfs_perfmon_instance | The specific DFS Performance Monitor instance from which the metric data is collected. This field provides clarity on the particular DFS instance being monitored. | String |
| dfs_perfmon_metrics_referral_requests_processed | The total number of referral requests processed by the DFS instance. | UInt32 |
| dfs_perfmon_metrics_referral_requests_processed_per_sec | The average number of referral requests processed per second by the DFS instance. | Float64 |
| dfs_perfmon_metrics_referral_requests_failed | The total number of failed referral requests for the DFS instance. | UInt32 |
| dfs_perfmon_metrics_referral_avg_response_time | The average response time for referral requests in the DFS instance. | Float64 |
| dfs_perfmon_object | The total number of folders managed by the DFS instance. | String |
| dfs_perfmon_metrics_folder_count | The average number of DFS requests processed per second. | Float64 |
| dfs_perfmon_metrics_requests_processed_per_sec | The total number of DFS requests processed by the instance. | UInt32 |
| dfs_perfmon_metrics_requests_processed | The average response time for DFS requests. | Float64 |
| dfs_perfmon_metrics_avg_response_time | The total number of failed DFS requests. | UInt32 |
| dfs_perfmon_metrics_requests_failed | The number of database commits made by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_service_database_commits | The percentage of unread USN journal entries by the DFS Replication service. | Float64 |
| dfs_perfmon_metrics_dfs_replication_service_usn_journal_unread_percentage | The number of database lookups made by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_service_database_lookups | The number of USN journal records accepted by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_service_usn_journal_records_accepted | The number of USN journal records read by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_service_usn_journal_records_read | The total number of conflict bytes cleaned by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_bytes_cleaned | The total number of updates dropped by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_updates_dropped | The total bandwidth savings achieved by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_bandwidth_savings | The total number of staging bytes cleaned by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_staging_bytes_cleaned | The total number of staging bytes cleaned by the DFS Replication service. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_compressed_size | The total compressed size of data for the DFS replication instance. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_rdc_compressed_size | The size of RDC-compressed data for the DFS replication process. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_space_in_use | The total space currently occupied by conflict files for DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_staging_files_generated | The total number of staging files generated during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_files_generated | The total number of conflict files generated during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_staging_bytes_generated | The total number of bytes generated in the staging area for DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_file_installs_retried | The number of file installations that were retried during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_staging_files_cleaned | The total number of staging files that were cleaned up during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_deleted_bytes_cleaned | The total number of deleted bytes that were cleaned up during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_deleted_bytes_generated | The total number of bytes that were generated for deletion during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_cleanups_completed | The total number of conflict cleanups completed during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_rdc_bytes_received | The total number of RDC bytes received during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_total_files_received | The total number of files received during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_deleted_space_in_use | The total amount of space in use for deleted files during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_files_cleaned | The total number of conflict files that were cleaned up during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_conflict_bytes_generated | The total number of bytes generated by conflict files during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_size_received | The total size of files received during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_staging_space_in_use | The amount of space currently in use for staging files during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_rdc_size_received | The total size of RDC data received during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_rdc_files_received | The total number of RDC files received during DFS replication. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_bandwidth_savings | The bandwidth savings achieved for DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_bytes_received_per_sec | The rate of bytes received per second for DFS replication connections. | Float64 |
| dfs_perfmon_metrics_dfs_replication_connections_compressed_size | The total compressed size of data for DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_rdc_bytes_received | The total RDC bytes received over DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_rdc_compressed_size | The compressed size of RDC data received over DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_rdc_files_received | The total number of RDC files received over DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_rdc_size_received | The total size of RDC data received over DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_size_received | The total size of all data received over DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_total_bytes_received | The total number of bytes received over all DFS replication connections. | UInt32 |
| dfs_perfmon_metrics_dfs_replication_connections_total_files_received | The total number of files received over all DFS replication connections. | UInt32 |
