Windows SMB Share Performance (latency, queue length)

Monitors SMB shares on Windows file servers per share: latency, queue length, requests, throughput, open files and connections, based on the Windows performance object "SMB Server Shares".

Values per share

• Latency per data, read, write and any request
• Average data, read and write queue length, current data queue length, pending requests
• Data, read, write and metadata requests per second
• Throughput (data, read, write)
• Open files and connections
• Intervals without any request are shown as "no requests" instead of a latency of 0, so an idle share is never mistaken for a fast one

Features

• Reads the Windows performance counters (same data as perfmon) with the English counter names - works on German and any other Windows language
• WMI only as fallback; the source in use is shown in the service details
• Rates computed on the Checkmk server according to the counter type reported by Windows - no guessed counter types
• Default levels without any rule: data/read/write latency 20/50 ms, average and current data queue length 2/5
• Optional levels for open files and connections; every default adjustable per share or switched off
• Select shares by plain local path (E:\home, D:\Shares\Public, E:* for all shares below a folder) - no share names or regular expressions needed; alternatively by name (regex)
• Hidden shares (name$) are discovered, administrative shares (C$, ADMIN$, IPC$, print$) are excluded by default
• Local path of every share shown in the service details
• Graphs: latency, queue length, requests, throughput, open files and connections; perfometer
• Agent Bakery rule: synchronous, asynchronous or do not deploy

Rules

• Agent rules: "Windows: SMB share performance (agent plug-in)" - required, deploys the plug-in
• Discovery rules: "Windows SMB share discovery" - optional, only some shares (by local path or name)
• Service monitoring rules (Storage): "Windows SMB share performance" - optional, change default levels

Installation

1. Create the agent rule "Windows: SMB share performance (agent plug-in)", bake and deploy the agents (without Bakery: copy win_smb_shares.ps1 to C:\ProgramData\checkmk\agent\plugins)
2. Run the service discovery on the file server

Requirements

• Checkmk 2.5.0 or newer (Agent Bakery rule in the commercial editions)
• Windows Server 2012 or newer, Windows PowerShell 2.0 or newer

Notes

• Values are averages between two agent runs; the first check after discovery shows current values only.
• The default WARN values follow Microsoft's rules of thumb for the matching disk counters; adjust them to your file server.

Source, README and changelog: https://github.com/Majus420/checkmk/tree/main/MKP/windows_smb_share_performance