63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
# MD RAID Statistics Input Plugin
|
|
|
|
This plugin gathers statistics about any [Linux MD RAID arrays][mdraid]
|
|
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][man_proc]. For
|
|
details on the fields check the [mdstat wiki][mdstat_wiki].
|
|
|
|
⭐ Telegraf v1.20.0
|
|
🏷️ system
|
|
💻 linux
|
|
|
|
[mdraid]: https://docs.kernel.org/admin-guide/md.html
|
|
[man_proc]: http://man7.org/linux/man-pages/man5/proc.5.html
|
|
[mdstat_wiki]: https://raid.wiki.kernel.org/index.php/Mdstat
|
|
|
|
## Global configuration options <!-- @/docs/includes/plugin_config.md -->
|
|
|
|
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][CONFIGURATION.md] for more details.
|
|
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
|
|
|
## Configuration
|
|
|
|
```toml @sample.conf
|
|
# 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
|
|
```
|