Adding upstream version 1.34.4.

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

plugins/inputs/win_services/README.md

@@ -0,0 +1,91 @@
+# Windows Services Input Plugin
+
+Reports information about Windows service status.
+
+Monitoring some services may require running Telegraf with administrator
+privileges.
+
+## 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
+# Input plugin to report Windows services info.
+# This plugin ONLY supports Windows
+[[inputs.win_services]]
+  ## Names of the services to monitor. Leave empty to monitor all the available
+  ## services on the host. Globs accepted. Case insensitive.
+  service_names = [
+    "LanmanServer",
+    "TermService",
+    "Win*",
+  ]
+
+  # optional, list of service names to exclude
+  excluded_service_names = ['WinRM']
+```
+
+## Metrics
+
+- win_services
+  - state : integer
+  - startup_mode : integer
+
+The `state` field can have the following values:
+
+- 1 - stopped
+- 2 - start pending
+- 3 - stop pending
+- 4 - running
+- 5 - continue pending
+- 6 - pause pending
+- 7 - paused
+
+The `startup_mode` field can have the following values:
+
+- 0 - boot start
+- 1 - system start
+- 2 - auto start
+- 3 - demand start
+- 4 - disabled
+
+### Tags
+
+- All measurements have the following tags:
+  - service_name
+  - display_name
+
+## Example Output
+
+```text
+win_services,host=WIN2008R2H401,display_name=Server,service_name=LanmanServer state=4i,startup_mode=2i 1500040669000000000
+win_services,display_name=Remote\ Desktop\ Services,service_name=TermService,host=WIN2008R2H401 state=1i,startup_mode=3i 1500040669000000000
+```
+
+### TICK Scripts
+
+A sample TICK script for a notification about a not running service.  It sends a
+notification whenever any service changes its state to be not _running_ and when
+it changes that state back to _running_.  The notification is sent via an HTTP
+POST call.
+
+```shell
+stream
+    |from()
+        .database('telegraf')
+        .retentionPolicy('autogen')
+        .measurement('win_services')
+        .groupBy('host','service_name')
+    |alert()
+        .crit(lambda: "state" != 4)
+        .stateChangesOnly()
+        .message('Service {{ index .Tags "service_name" }} on Host {{ index .Tags "host" }} is in state {{ index .Fields "state" }} ')
+        .post('http://localhost:666/alert/service')
+```