---
title: ''
description: Telegraf plugin for collecting metrics from MD RAID Statistics
url: https://docs.influxdata.com/telegraf/v1/input-plugins/mdstat/
estimated_tokens: 688
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/mdstat/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.20.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.40.0/plugins/inputs/mdstat/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.40.0/plugins/inputs/mdstat/sample.conf)

# MD RAID Statistics Input Plugin

This plugin gathers statistics about any [Linux MD RAID arrays](https://docs.kernel.org/admin-guide/md.html)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](http://man7.org/linux/man-pages/man5/proc.5.html). For
details on the fields check the [mdstat wiki](https://raid.wiki.kernel.org/index.php/Mdstat).

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

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# 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

```text
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
```