Adding upstream version 1.34.4.

Signed-off-by: Daniel Baumann <daniel@debian.org>

plugins/inputs/mdstat/README.md

@@ -0,0 +1,63 @@
+# 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
+```