telegraf/plugins/inputs/mdstat
Joshua Powers 8c49ddccc3
chore: update to go1.19.1 (#11776)
2022-09-08 12:49:36 -06:00
..
README.md chore: Markdown fixes for inputs/[a-m]* (#11606) 2022-08-09 18:57:31 +02:00
mdstat.go chore: update to go1.19.1 (#11776) 2022-09-08 12:49:36 -06:00
mdstat_notlinux.go fix: run go fmt on inputs.mdstat with go1.17 (#9702) 2021-09-01 10:35:10 -06:00
mdstat_test.go fix: mdstat when sync is less than 10% (#10701) 2022-02-22 15:04:16 -07:00
sample.conf chore(inputs_m-z): migrate sample configs into separate files (#11133) 2022-05-18 11:31:34 -05:00

README.md

mdstat Input Plugin

The mdstat plugin gathers statistics about any Linux MD RAID arrays configured on the host by reading /proc/mdstat. For a full list of available fields see the /proc/mdstat section of the proc man page. For a better idea of what each field represents, see the mdstat man page.

Stat collection based on Prometheus' mdstat collection library.

Configuration

# Get kernel statistics from /proc/mdstat
[[inputs.mdstat]]
  ## Sets file path
  ## If not specified, then default is /proc/mdstat
  # file_name = "/proc/mdstat"

Metrics

  • mdstat
    • BlocksSynced (if the array is rebuilding/checking, this is the count of blocks that have been scanned)
    • BlocksSyncedFinishTime (the expected finish time of the rebuild scan, listed in minutes remaining)
    • BlocksSyncedPct (the percentage of the rebuild scan left)
    • BlocksSyncedSpeed (the current speed the rebuild is running at, listed in K/sec)
    • BlocksTotal (the total count of blocks in the array)
    • DisksActive (the number of disks that are currently considered healthy in the array)
    • DisksFailed (the current count of failed disks in the array)
    • DisksSpare (the current count of "spare" disks in the array)
    • DisksTotal (total count of disks in the array)

Tags

  • mdstat
    • ActivityState (active or inactive)
    • Devices (comma separated list of devices that make up the array)
    • Name (name of the array)

Example Output

$ telegraf --config ~/ws/telegraf.conf --input-filter mdstat --test
* Plugin: mdstat, Collection 1
> mdstat,ActivityState=active,Devices=sdm1\,sdn1,Name=md1 BlocksSynced=231299072i,BlocksSyncedFinishTime=0,BlocksSyncedPct=0,BlocksSyncedSpeed=0,BlocksTotal=231299072i,DisksActive=2i,DisksFailed=0i,DisksSpare=0i,DisksTotal=2i,DisksDown=0i 1617814276000000000
> mdstat,ActivityState=active,Devices=sdm5\,sdn5,Name=md2 BlocksSynced=2996224i,BlocksSyncedFinishTime=0,BlocksSyncedPct=0,BlocksSyncedSpeed=0,BlocksTotal=2996224i,DisksActive=2i,DisksFailed=0i,DisksSpare=0i,DisksTotal=2i,DisksDown=0i 1617814276000000000