eG Monitoring
 

Measures reported by DFSSerAPIreqTest

The management tools (eg., DFS Management UI, DFS BPA, DFS Namespaces Windows PowerShell cmdlets, File Server Resource Manager) used by administrators to manage DFS typically employ NetDfs API functions to perform critical management tasks – eg., creating/removing namespaces, adding roots and links, viewing/configuring information about roots and links, and so on. In the process, these tools impose a significant amount of operational load on the namespace server. If the server is not sized right to handle this load, API requests may either fail frequently or may end-up being processed slowly by the server, thus increasing the DFS management challenges of administrators. This in turn will impact the user experience with DFS. If such situations are to be avoided, administrators should use the DFSSerAPIreqTest test to track the number and type of API requests to the namespace server, measure how quickly the server processes requests of each type, identify request types that failed often, and accordingly, decide whether/not the server should be resized to improve its processing ability.

The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Avg_response_time Indicates the average time taken by the DFS namespace server to respond to API requests of this type. Secs Ideally, the value of this measure should be low. A consistent increase in the value of this measure is indicative of poor responsiveness of the DFS namespace service.

Compare the value of this measure across request types to know which API requests are being processed slowly by the server.

Requests_processed Indicates the number of API requests of this type processed by the server since the last measurement period. Number  
Requests_failed Indicates the number of API requests of this type that failed during the last measurement period. Number Ideally, the value of this measure should be 0.
Req_fail_percent Indicates the percentage of API requests of this type that failed. Percent The value 0 is desired for this measure. A high value is a cause for concern. Compare the value of this measure across types to know which type of requests is prone to failures.
Requests_processed_sec Indicates the rate at which the API requests of this type are processed. Requests/Sec A high value is desired for this measure. A steady dip in this value is indicative of a processing bottleneck. Compare the value of this measure across types to know the requests that are being serviced very slowly.