mdstat

README

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.

⭐ Telegraf v1.20.0 🏷️ system 💻 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

Documentation

Index

• type Mdstat
  • func (k *Mdstat) Gather(acc telegraf.Accumulator) error
  • func (*Mdstat) SampleConfig() string

Types

type Mdstat

type Mdstat struct {
	FileName string `toml:"file_name"`
}

func (*Mdstat) Gather

func (k *Mdstat) Gather(acc telegraf.Accumulator) error

func (*Mdstat) SampleConfig

func (*Mdstat) SampleConfig() string