Add nginx_sts input plugin (influxdata#7205)

plugins/inputs/all/all.go

@@ -108,6 +108,7 @@ import (
 	_ "github.com/influxdata/telegraf/plugins/inputs/nginx"
 	_ "github.com/influxdata/telegraf/plugins/inputs/nginx_plus"
 	_ "github.com/influxdata/telegraf/plugins/inputs/nginx_plus_api"
+	_ "github.com/influxdata/telegraf/plugins/inputs/nginx_sts"
 	_ "github.com/influxdata/telegraf/plugins/inputs/nginx_upstream_check"
 	_ "github.com/influxdata/telegraf/plugins/inputs/nginx_vts"
 	_ "github.com/influxdata/telegraf/plugins/inputs/nsq"

plugins/inputs/nginx_sts/README.md

@@ -0,0 +1,99 @@
+# Telegraf Plugin: nginx_sts
+
+This plugin gathers Nginx status using external virtual host traffic status module -  https://github.com/vozlt/nginx-module-sts. This is an Nginx module that provides access to stream host status information. It contains the current status such as servers, upstreams, caches. This is similar to the live activity monitoring of Nginx plus.
+For module configuration details please see its [documentation](https://github.com/vozlt/nginx-module-sts#synopsis).
+
+### Configuration:
+
+```
+# Read nginx status information using nginx-module-sts module
+[[inputs.nginx_sts]]
+  ## An array of Nginx status URIs to gather stats.
+  urls = ["http://localhost/stream_traffic_status/status/format/json"]
+```
+
+### Measurements & Fields:
+
+- nginx_sts_connections
+  - active
+  - reading
+  - writing
+  - waiting
+  - accepted
+  - handled
+  - requests
+- nginx_sts_server, nginx_sts_filter
+  - connects
+  - in_bytes
+  - out_bytes
+  - response_1xx_count
+  - response_2xx_count
+  - response_3xx_count
+  - response_4xx_count
+  - response_5xx_count
+  - session_msec_counter
+  - session_msec
+- nginx_sts_upstream
+  - connects
+  - in_bytes
+  - out_bytes
+  - response_1xx_count
+  - response_2xx_count
+  - response_3xx_count
+  - response_4xx_count
+  - response_5xx_count
+  - session_msec_counter
+  - session_msec
+  - upstream_session_msec_counter
+  - upstream_session_msec
+  - upstream_connect_msec_counter
+  - upstream_connect_msec
+  - upstream_firstbyte_msec_counter
+  - upstream_firstbyte_msec
+  - weight
+  - max_fails
+  - fail_timeout
+  - backup
+  - down
+
+### Tags:
+
+- nginx_sts_connections
+  - source
+  - port
+- nginx_sts_server
+  - source
+  - port
+  - zone
+- nginx_sts_filter
+  - source
+  - port
+  - filter_name
+  - filter_key
+- nginx_sts_upstream
+  - source
+  - port
+  - upstream
+  - upstream_address
+
+### Example Output:
+
+Using this configuration:
+```
+[[inputs.nginx_sts]]
+  ## An array of Nginx status URIs to gather stats.
+  urls = ["http://localhost/stream_traffic_status/status/format/json"]
+```
+
+When run with:
+```
+./telegraf -config telegraf.conf -input-filter nginx_sts -test
+```
+
+It produces:
+```
+nginx_sts_upstream,host=localhost,port=80,source=127.0.0.1,upstream=backend_cluster,upstream_address=1.2.3.4:8080 upstream_connect_msec_counter=0i,out_bytes=0i,down=false,connects=0i,session_msec=0i,upstream_session_msec=0i,upstream_session_msec_counter=0i,upstream_connect_msec=0i,upstream_firstbyte_msec_counter=0i,response_3xx_count=0i,session_msec_counter=0i,weight=1i,max_fails=1i,backup=false,upstream_firstbyte_msec=0i,in_bytes=0i,response_1xx_count=0i,response_2xx_count=0i,response_4xx_count=0i,response_5xx_count=0i,fail_timeout=10i 1584699180000000000
+nginx_sts_upstream,host=localhost,port=80,source=127.0.0.1,upstream=backend_cluster,upstream_address=9.8.7.6:8080 upstream_firstbyte_msec_counter=0i,response_2xx_count=0i,down=false,upstream_session_msec_counter=0i,out_bytes=0i,response_5xx_count=0i,weight=1i,max_fails=1i,fail_timeout=10i,connects=0i,session_msec_counter=0i,upstream_session_msec=0i,in_bytes=0i,response_1xx_count=0i,response_3xx_count=0i,response_4xx_count=0i,session_msec=0i,upstream_connect_msec=0i,upstream_connect_msec_counter=0i,upstream_firstbyte_msec=0i,backup=false 1584699180000000000
+nginx_sts_server,host=localhost,port=80,source=127.0.0.1,zone=* response_2xx_count=0i,response_4xx_count=0i,response_5xx_count=0i,session_msec_counter=0i,in_bytes=0i,out_bytes=0i,session_msec=0i,response_1xx_count=0i,response_3xx_count=0i,connects=0i 1584699180000000000
+nginx_sts_connections,host=localhost,port=80,source=127.0.0.1 waiting=1i,accepted=146i,handled=146i,requests=13421i,active=3i,reading=0i,writing=2i 1584699180000000000
+```