---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from MD RAID Statistics
url: https://docs.influxdata.com/telegraf/v1/input-plugins/mdstat/
estimated_tokens: 1015
product: Telegraf
version: v1
---

-   Telegraf v1.20.0+

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

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [MD RAID Statistics Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/mdstat/README.md)