Documentation

MD RAID Statistics Input Plugin

This 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 details on the fields check the mdstat wiki.

Introduced in: Telegraf v1.20.0 Tags: system OS support: linux

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

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

Metrics

  • mdstat metric
    • tags:
      • ActivityState (active or inactive)
      • Devices (comma separated list of devices that make up the array)
      • Name (name of the array)
    • fields:
      • 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)

Example Output

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

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

New in InfluxDB 3.4

Key enhancements in InfluxDB 3.4 and the InfluxDB 3 Explorer 1.2.

See the Blog Post

InfluxDB 3.4 is now available for both Core and Enterprise, which introduces offline token generation for use in automated deployments and configurable license type selection that lets you bypass the interactive license prompt. InfluxDB 3 Explorer 1.2 is also available, which includes InfluxDB cache management and other new features.

For more information, check out: