From 34a184c7aa5b2a8532ff264cb68e4cd37acf0356 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Thu, 29 Aug 2019 09:23:29 -0600 Subject: [PATCH 1/6] various flux function fixes --- .../flux/functions/built-in/misc/intervals.md | 1 + .../transformations/aggregates/histogramquantile.md | 2 +- .../built-in/transformations/aggregates/increase.md | 13 +++++++------ .../built-in/transformations/aggregates/quantile.md | 2 +- 4 files changed, 10 insertions(+), 8 deletions(-) diff --git a/content/v2.0/reference/flux/functions/built-in/misc/intervals.md b/content/v2.0/reference/flux/functions/built-in/misc/intervals.md index d36acade3..9d585b9c0 100644 --- a/content/v2.0/reference/flux/functions/built-in/misc/intervals.md +++ b/content/v2.0/reference/flux/functions/built-in/misc/intervals.md @@ -8,6 +8,7 @@ menu: name: intervals parent: built-in-misc weight: 401 +draft: true --- The `intervals()` function generates a set of time intervals over a range of time. diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/histogramquantile.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/histogramquantile.md index 7b135a9d8..84edae201 100644 --- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/histogramquantile.md +++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/histogramquantile.md @@ -75,7 +75,7 @@ _**Data type:** String_ The assumed minimum value of the dataset. When the quantile falls below the lowest upper bound, interpolation is performed between `minValue` and the lowest upper bound. When `minValue` is equal to negative infinity, the lowest upper bound is used. -Defaults to `0`. +Defaults to `0.0`. _**Data type:** Float_ diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md index b948fb865..b7fabe52c 100644 --- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md +++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md @@ -10,7 +10,8 @@ menu: weight: 501 --- -The `increase()` function calculates the total non-negative difference between values in a table. +The `increase()` function calculates the total non-negative difference between +subsequent values in a table. A main use case is tracking changes in counter values which may wrap over time when they hit a threshold or are reset. In the case of a wrap/reset, we can assume that the absolute delta between two @@ -20,16 +21,16 @@ _**Function type:** Aggregate_ _**Output data type:** Float_ ```js -increase(column: "_values") +increase(columns: ["_value"]) ``` ## Parameters -### column -The column for which the increase is calculated. -Defaults to `"_value"`. +### columns +The columns for which the increase is calculated. +Defaults to `["_value"]`. -_**Data type:** Strings_ +_**Data type:** Array of strings_ ## Examples ```js diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/quantile.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/quantile.md index c9c41436e..a322e83c7 100644 --- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/quantile.md +++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/quantile.md @@ -66,7 +66,7 @@ A selector method that returns the data point for which at least `q` points are ### compression Indicates how many centroids to use when compressing the dataset. A larger number produces a more accurate result at the cost of increased memory requirements. -Defaults to 1000. +Defaults to `1000.0`. _**Data type:** Float_ From e5ed4171afe37238763f40a43e8f6330660153cf Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Thu, 29 Aug 2019 09:25:55 -0600 Subject: [PATCH 2/6] minor update to increase function doc --- .../functions/built-in/transformations/aggregates/increase.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md index b7fabe52c..1865d9a6e 100644 --- a/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md +++ b/content/v2.0/reference/flux/functions/built-in/transformations/aggregates/increase.md @@ -11,7 +11,7 @@ weight: 501 --- The `increase()` function calculates the total non-negative difference between -subsequent values in a table. +subsequent values. A main use case is tracking changes in counter values which may wrap over time when they hit a threshold or are reset. In the case of a wrap/reset, we can assume that the absolute delta between two @@ -27,7 +27,7 @@ increase(columns: ["_value"]) ## Parameters ### columns -The columns for which the increase is calculated. +The columns to use in the operation. Defaults to `["_value"]`. _**Data type:** Array of strings_ From 5d02e0d9473c27b57bc266ba373da07d812988e6 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Tue, 3 Sep 2019 10:27:39 -0600 Subject: [PATCH 3/6] added Telegraf 1.12 plugins and updated telegraf version --- data/telegraf_plugins.yml | 591 ++++++++++++++++++++++---------------- data/versions.yaml | 2 +- 2 files changed, 352 insertions(+), 241 deletions(-) diff --git a/data/telegraf_plugins.yml b/data/telegraf_plugins.yml index 8ed2882a8..01a64fb04 100644 --- a/data/telegraf_plugins.yml +++ b/data/telegraf_plugins.yml @@ -5,12 +5,22 @@ ############## %%%%%% %% %% %% %%%% %% %%%% ############## input: + - name: AMQP Consumer + id: amqp_consumer + description: | + The AMQP Consumer input plugin provides a consumer for use with AMQP 0-9-1, + a prominent implementation of this protocol + being RabbitMQ. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/amqp_consumer/README.md + introduced: 1.3.0 + tags: [linux, macos, windows, messaging] + - name: ActiveMQ id: activemq description: | The ActiveMQ input plugin gathers queues, topics, and subscriber metrics using the ActiveMQ Console API. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/activemq/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/activemq/README.md introduced: 1.8.0 tags: [linux, macos, windows, messaging] @@ -19,7 +29,7 @@ input: description: | The Aerospike input plugin queries Aerospike servers and gets node statistics and statistics for all configured namespaces. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/aerospike/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/aerospike/README.md introduced: 0.2.0 tags: [linux, macos, windows, data-stores] @@ -27,7 +37,7 @@ input: id: cloudwatch description: | The Amazon CloudWatch Statistics input plugin pulls metric statistics from Amazon CloudWatch. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cloudwatch/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cloudwatch/README.md introduced: 0.12.1 tags: [linux, macos, windows, cloud] @@ -36,25 +46,16 @@ input: description: | The Amazon Kinesis Consumer input plugin reads from a Kinesis data stream and creates metrics using one of the supported [input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kinesis_consumer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kinesis_consumer/README.md introduced: 1.10.0 tags: [linux, macos, windows, cloud, messaging] - - name: AMQP Consumer - id: amqp_consumer - description: | - The AMQP Consumer input plugin provides a consumer for use with AMQP 0-9-1, - a prominent implementation of this protocol being RabbitMQ. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/amqp_consumer/README.md - introduced: 1.3.0 - tags: [linux, macos, windows, messaging] - - name: Apache Aurora id: aurora description: | The Aurora input plugin gathers metrics from [Apache Aurora](https://aurora.apache.org/) schedulers. For monitoring recommendations, see [Monitoring your Aurora cluster](https://aurora.apache.org/documentation/latest/operations/monitoring/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/aurora/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/aurora/README.md introduced: 1.7.0 tags: [linux, macos, windows, applications, containers] @@ -70,7 +71,7 @@ input: option must be enabled in order to collect all available fields. For information about how to configure your server reference, see the [module documentation](https://httpd.apache.org/docs/2.4/mod/mod_status.html#enable). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/apache/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/apache/README.md introduced: 1.8.0 tags: [linux, macos, windows, servers, web] @@ -82,7 +83,7 @@ input: [Consumer Group](http://godoc.org/github.com/wvanbergen/kafka/consumergroup) is used to talk to the Kafka cluster so multiple instances of Telegraf can read from the same topic in parallel. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kafka_consumer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kafka_consumer/README.md introduced: 0.2.3 tags: [linux, macos, windows, messaging] @@ -91,7 +92,7 @@ input: description: | The Apache Mesos input plugin gathers metrics from Mesos. For more information, please check the [Mesos Observability Metrics](http://mesos.apache.org/documentation/latest/monitoring/) page. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mesos/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mesos/README.md introduced: 0.10.3 tags: [linux, macos, windows, containers] @@ -100,7 +101,7 @@ input: id: solr description: | The Apache Solr input plugin collects stats using the MBean Request Handler. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/solr/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/solr/README.md introduced: 1.5.0 tags: [linux, macos, windows, data-stores] @@ -112,7 +113,7 @@ input: Using `XML=true` returns XML data. See the [Apache Tomcat documentation](https://tomcat.apache.org/tomcat-9.0-doc/manager-howto.html#Server_Status) for details on these statistics. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/tomcat/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/tomcat/README.md introduced: 1.4.0 tags: [linux, macos, windows, servers, web] @@ -124,7 +125,7 @@ input: > This plugin is experimental. Its data schema may be subject to change based on > its main usage cases and the evolution of the OpenTracing standard. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/zipkin/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/zipkin/README.md introduced: 1.4.0 tags: [linux, macos, windows, networking] @@ -133,15 +134,23 @@ input: description: | The Apache Zookeeper input plugin collects variables output from the `mntr` command [Zookeeper Admin](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/zookeeper/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/zookeeper/README.md introduced: 0.2.0 tags: [linux, macos, windows, build-deploy] + - name: Apcupsd + id: apcupsd + description: | + The Apcupsd input plugin reads data from an apcupsd daemon over its NIS network protocol. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/apcupsd/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, systems] + - name: Bcache id: bcache description: | The Bcache input plugin gets bcache statistics from the `stats_total` directory and `dirty_data` file. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/bcache/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/bcache/README.md introduced: 0.2.0 tags: [linux, macos, windows, systems] @@ -150,15 +159,15 @@ input: description: | The Beanstalkd input plugin collects server stats as well as tube stats (reported by `stats` and `stats-tube` commands respectively). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/beanstalkd/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/beanstalkd/README.md introduced: 1.8.0 tags: [linux, macos, windows, messaging] - name: BIND 9 Nameserver Statistics id: bind description: | - The BIND 9 input plugin decodes JSON or XML statistics provided by BIND 9 nameservers. - links: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/bind/README.md + plugin decodes the JSON or XML statistics provided by BIND 9 nameservers. + links: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/bind/README.md introduced: 1.11.0 tags: [linux, macos, windows, netoworking] @@ -168,7 +177,7 @@ input: The Bond input plugin collects network bond interface status, bond's slaves interfaces status and failures count of bond's slaves interfaces. The plugin collects these metrics from `/proc/net/bonding/*` files. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/bond/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/bond/README.md introduced: 1.5.0 tags: [linux, macos, windows, networking] @@ -178,7 +187,7 @@ input: The Burrow input plugin collects Apache Kafka topic, consumer, and partition status using the [Burrow](https://github.com/linkedin/Burrow) [HTTP Endpoint](https://github.com/linkedin/Burrow/wiki/HTTP-Endpoint). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/burrow/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/burrow/README.md introduced: 1.7.0 tags: [linux, macos, windows, messaging] @@ -200,7 +209,7 @@ input: id: ceph description: | The Ceph Storage input plugin collects performance metrics from the MON and OSD nodes in a Ceph storage cluster. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ceph/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ceph/README.md introduced: 0.13.1 tags: [linux, macos, windows, data-stores] @@ -208,7 +217,7 @@ input: id: cgroup description: | The CGroup input plugin captures specific statistics per cgroup. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cgroup/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cgroup/README.md introduced: 1.0.0 tags: [linux, macos, windows, systems] @@ -216,27 +225,27 @@ input: id: chrony description: | The Chrony input plugin gets standard chrony metrics, requires chronyc executable. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/chrony/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/chrony/README.md introduced: 0.13.1 tags: [linux, macos, windows, networking, systems] - name: Cisco GNMI Telemetry id: cisco_telemetry_gnmi description: | - The Cisco GNMI Telemetry input plugin consumes telemetry data similar to the GNMI specification. + Cisco GNMI Telemetry is an input plugin that consumes telemetry data similar to the GNMI specification. This GRPC-based protocol can utilize TLS for authentication and encryption. This plugin has been developed to support GNMI telemetry as produced by Cisco IOS XR (64-bit) version 6.5.1 and later. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cisco_telemetry_gnmi/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cisco_telemetry_gnmi/README.md introduced: 1.11.0 tags: [linux, macos, windows, applications] - name: Cisco Model-driven Telemetry (MDT) id: cisco_telemetry_mdt description: | - The Cisco model-driven telemetry (MDT) input plugin consumes telemetry data from Cisco IOS XR, IOS XE and NX-OS platforms. + Cisco model-driven telemetry (MDT) is an input plugin that consumes telemetry data from Cisco IOS XR, IOS XE and NX-OS platforms. It supports TCP & GRPC dialout transports. GRPC-based transport can utilize TLS for authentication and encryption. Telemetry data is expected to be GPB-KV (self-describing-gpb) encoded. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cisco_telemetry_mdt/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cisco_telemetry_mdt/README.md introduced: 1.11.0 tags: [linux, macos, windows, applications] @@ -252,7 +261,7 @@ input: or `/proc/sys/net/netfilter` and will be prefixed with either `ip_` or `nf_`. This plugin reads the files specified in its configuration and publishes each one as a field, with the prefix normalized to `ip_`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/conntrack/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/conntrack/README.md introduced: 1.0.0 tags: [linux, macos, windows, networking] @@ -262,7 +271,7 @@ input: The Consul input plugin will collect statistics about all health checks registered in the Consul. It uses Consul API to query the data. It will not report the telemetry but Consul can report those stats already using StatsD protocol, if needed. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/consul/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/consul/README.md introduced: 1.0.0 tags: [linux, macos, windows, build-deploy, containers] @@ -270,7 +279,7 @@ input: id: couchbase description: | The Couchbase input plugin reads per-node and per-bucket metrics from Couchbase. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/couchbase/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/couchbase/README.md introduced: 0.12.0 tags: [linux, macos, windows, data-stores] @@ -278,7 +287,7 @@ input: id: couchdb description: | The CouchDB input plugin gathers metrics of CouchDB using `_stats` endpoint. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/couchdb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/couchdb/README.md introduced: 0.10.3 tags: [linux, macos, windows, data-stores] @@ -286,7 +295,7 @@ input: id: cpu description: | The CPU input plugin gathers metrics about cpu usage. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cpu/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cpu/README.md introduced: 0.1.5 tags: [linux, macos, windows, systems] @@ -294,7 +303,7 @@ input: id: disk description: | The Disk input plugin gathers metrics about disk usage by mount point. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/disk/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/disk/README.md introduced: 0.1.1 tags: [linux, macos, windows, systems] @@ -302,7 +311,7 @@ input: id: diskio description: | The DiskIO input plugin gathers metrics about disk IO by device. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/diskio/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/diskio/README.md introduced: 0.10.0 tags: [linux, macos, windows, systems] @@ -310,7 +319,7 @@ input: id: disque description: | The Disque input plugin gathers metrics from one or more [Disque](https://github.com/antirez/disque) servers. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/disque + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/disque introduced: 0.10.0 tags: [linux, macos, windows, messaging] @@ -318,7 +327,7 @@ input: id: dmcache description: | The DMCache input plugin provides a native collection for dmsetup-based statistics for dm-cache. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/dmcache/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/dmcache/README.md introduced: 1.3.0 tags: [linux, macos, windows, systems] @@ -327,7 +336,7 @@ input: description: | The DNS Query input plugin gathers DNS query times in milliseconds - like [Dig](https://en.wikipedia.org/wiki/Dig_(command)). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/dns_query/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/dns_query/README.md introduced: 1.4.0 tags: [linux, macos, windows, networking] @@ -337,25 +346,36 @@ input: The Docker input plugin uses the Docker Engine API to gather metrics on running Docker containers. The Docker plugin uses the [Official Docker Client](https://github.com/moby/moby/tree/master/client) to gather stats from the [Engine API](https://docs.docker.com/engine/api/v1.20/) library documentation. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/docker/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/docker/README.md introduced: 0.1.9 tags: [linux, macos, windows, build-deploy, containers] + - name: Docker Log + id: docker_log + description: | + The Docker Log input plugin uses the Docker Engine API to collect logs from running Docker containers. + The plugin uses the [Official Docker Client](https://github.com/moby/moby/tree/master/client) + to gather logs from the [Engine API](https://docs.docker.com/engine/api/v1.24/). + + > This plugin works only for containers with the local or `json-file` or `journald` logging driver. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/docker_log/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, build-deploy, containers, logging] + - name: Dovecot id: dovecot description: | The Dovecot input plugin uses the dovecot Stats protocol to gather metrics on configured domains. For more information, see the [Dovecot documentation](http://wiki2.dovecot.org/Statistics). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/dovecot/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/dovecot/README.md introduced: 0.10.3 tags: [linux, macos, windows, applications, web] - name: ECS id: ecs description: | - The ECS (Fargate compatible) input plugin uses the ECS v2 metadata and stats API - endpoints to gather stats on running containers in a Task. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ecs/README.md + ECS, Fargate compatible, input plugin which uses the ECS v2 metadata and stats API endpoints to gather stats on running containers in a Task. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ecs/README.md introduced: 1.11.0 tags: [linux, macos, windows, cloud, containers] @@ -365,7 +385,7 @@ input: The Elasticsearch input plugin queries endpoints to obtain [node](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-nodes-stats.html) and optionally [cluster-health](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html) or [cluster-stats](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-stats.html) metrics. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/elasticsearch/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/elasticsearch/README.md introduced: 0.1.5 tags: [linux, macos, windows, data-stores] @@ -375,7 +395,7 @@ input: The Exec input plugin parses supported [Telegraf input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input/) (InfluxDB Line Protocol, JSON, Graphite, Value, Nagios, Collectd, and Dropwizard into metrics. Each Telegraf metric includes the measurement name, tags, fields, and timestamp. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/exec/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/exec/README.md introduced: 0.1.5 tags: [linux, macos, windows] @@ -384,7 +404,7 @@ input: description: | The Fail2ban input plugin gathers the count of failed and banned IP addresses using [fail2ban](https://www.fail2ban.org/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/fail2ban/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/fail2ban/README.md introduced: 1.4.0 tags: [linux, macos, windows, networking, security] @@ -393,7 +413,7 @@ input: description: | The Fibaro input plugin makes HTTP calls to the Fibaro controller API to gather values of hooked devices. Those values could be true (`1`) or false (`0`) for switches, percentage for dimmers, temperature, etc. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/fibaro/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/fibaro/README.md introduced: 1.7.0 tags: [linux, macos, windows, iot] @@ -409,7 +429,7 @@ input: > To parse metrics from multiple files that are formatted in one of the supported > [input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input), > use the [Multifile input plugin](#multifile). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/file/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/file/README.md introduced: 1.8.0 tags: [linux, macos, windows, systems] @@ -417,7 +437,7 @@ input: id: filecount description: | The Filecount input plugin reports the number and total size of files in directories that match certain criteria. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/filecount/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/filecount/README.md introduced: 1.8.0 tags: [linux, macos, windows, systems] @@ -425,24 +445,33 @@ input: id: filestat description: | The Filestat input plugin gathers metrics about file existence, size, and other stats. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/filestat/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/filestat/README.md introduced: 0.13.0 tags: [linux, macos, windows, systems] + - name: Fireboard + id: fireboard + description: | + The Fireboard input plugin gathers real time temperature data from Fireboard thermometers. + To use this input plugin, sign up to use the [Fireboard REST API](https://docs.fireboard.io/reference/restapi.html). + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/fireboard/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, cloud, iot] + - name: Fluentd id: fluentd description: | The Fluentd input plugin gathers Fluentd server metrics from plugin endpoint provided by in_monitor plugin. This plugin understands data provided by `/api/plugin.json` resource (`/api/config.json` is not covered). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/fluentd/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/fluentd/README.md introduced: 1.4.0 tags: [linux, macos, windows, servers] - name: GitHub id: github description: | - The Github input plugin gathers repository information from GitHub-hosted repositories. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/github/README.md + Gathers repository information from GitHub-hosted repositories. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/github/README.md introduced: 1.11.0 tags: [linux, macos, windows, applications] @@ -451,8 +480,8 @@ input: description: | The Google Cloud PubSub input plugin ingests metrics from [Google Cloud PubSub](https://cloud.google.com/pubsub) and creates metrics - using one of the supported [input data formats](https://github.com/influxdata/telegraf/blob/release-1.11/docs/DATA_FORMATS_INPUT.md). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cloud_pubsub/README.md + using one of the supported [input data formats](https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md). + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cloud_pubsub/README.md introduced: 1.10.0 tags: [linux, macos, windows, cloud, messaging] @@ -465,7 +494,7 @@ input: The intent of the plugin is to allow Telegraf to serve as an endpoint of the Google Pub/Sub 'Push' service. Google's PubSub service will only send over HTTPS/TLS so this plugin must be behind a valid proxy or must be configured to use TLS. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/cloud_pubsub_push/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/cloud_pubsub_push/README.md introduced: 1.10.0 tags: [linux, macos, windows, cloud, messaging] @@ -477,7 +506,7 @@ input: - multiple (e.g., `http://[graylog-server-ip]:12900/system/metrics/multiple`) - namespace (e.g., `http://[graylog-server-ip]:12900/system/metrics/namespace/{namespace}`) - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/graylog/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/graylog/README.md introduced: 1.0.0 tags: [linux, macos, windows, logging] @@ -486,7 +515,7 @@ input: description: | The HAproxy input plugin gathers metrics directly from any running HAproxy instance. It can do so by using CSV generated by HAproxy status page or from admin sockets. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/haproxy/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/haproxy/README.md introduced: 0.1.5 tags: [linux, macos, windows, networking, web] @@ -494,7 +523,7 @@ input: id: hddtemp description: | The Hddtemp input plugin reads data from `hddtemp` daemons. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/hddtemp/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/hddtemp/README.md introduced: 1.0.0 tags: [linux, macos, windows, systems] @@ -504,18 +533,18 @@ input: The HTTP input plugin collects metrics from one or more HTTP (or HTTPS) endpoints. The endpoint should have metrics formatted in one of the [supported input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input/). Each data format has its own unique set of configuration options which can be added to the input configuration. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/http/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/http/README.md introduced: 1.6.0 tags: [linux, macos, windows, servers, web] - name: HTTP JSON id: httpjson description: | - *Deprecated in Telegraf 1.6.0. Use the [HTTP input plugin](#http).* + _Deprecated in Telegraf 1.6.0. Use the [HTTP input plugin](#http)._ The HTTP JSON input plugin collects data from HTTP URLs which respond with JSON. It flattens the JSON and finds all numeric values, treating them as floats. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/httpjson/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/httpjson/README.md introduced: 0.1.6 deprecated: 1.6.0 tags: [linux, macos, windows, servers, web] @@ -526,7 +555,7 @@ input: The `http_listener` input plugin was renamed to [`influxdb_listener`](#influxdb_listener). The new name better describes the intended use of the plugin as a InfluxDB relay. For general purpose transfer of metrics in any format via HTTP, use [`http_listener_v2`](#http_listener_v2)instead. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/influxdb_listener/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/influxdb_listener/README.md introduced: 1.1.0 deprecated: 1.9.0 tags: [linux, macos, windows, servers, web] @@ -538,7 +567,7 @@ input: Messages are expected in the [InfluxDB Line Protocol input data format](https://docs.influxdata.com/telegraf/latest/data_formats/input/influx) ONLY (other [Telegraf input data formats](https://docs.influxdata.com/telegraf/latest//data_formats/input/) are not supported). This plugin allows Telegraf to serve as a proxy or router for the `/write` endpoint of the InfluxDB v2110 HTTP API. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/http_listener_v2/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/http_listener_v2/README.md introduced: 1.9.0 tags: [linux, macos, windows, servers, web] @@ -548,7 +577,7 @@ input: The HTTP Response input plugin gathers metrics for HTTP responses. The measurements and fields include `response_time`, `http_response_code`, and `result_type`. Tags for measurements include `server` and `method`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/http_response/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/http_response/README.md introduced: 0.12.1 tags: [linux, macos, windows, servers, web] @@ -557,7 +586,7 @@ input: description: | The Icinga 2 input plugin gather status on running services and hosts using the [Icinga 2 API](https://docs.icinga.com/icinga2/latest/doc/module/icinga2/chapter/icinga2-api). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/icinga2 + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/icinga2 introduced: 1.8.0 tags: [linux, macos, windows, networking, servers, systems] @@ -569,7 +598,7 @@ input: best practice and allows you to reduce the overhead associated with capturing and storing these metrics locally within the `_internal` database for production deployments. [Read more about this approach here](https://www.influxdata.com/blog/influxdb-debugvars-endpoint/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/influxdb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/influxdb/README.md introduced: 0.2.5 tags: [linux, macos, windows, data-stores] @@ -609,7 +638,7 @@ input: receive a `200 OK` response with message body `{"results":[]}` but they are not relayed. The output configuration of the Telegraf instance which ultimately submits data to InfluxDB determines the destination database. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/influxdb_listener/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/influxdb_listener/README.md introduced: 1.9.0 tags: [linux, macos, windows, data-stores] @@ -618,7 +647,7 @@ input: description: | The Interrupts input plugin gathers metrics about IRQs, including `interrupts` (from `/proc/interrupts`) and `soft_interrupts` (from `/proc/softirqs`). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/interrupts/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/interrupts/README.md introduced: 1.3.0 tags: [linux, macos, windows, systems] @@ -627,7 +656,7 @@ input: description: | The IPMI Sensor input plugin queries the local machine or remote host sensor statistics using the `ipmitool` utility. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ipmi_sensor/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ipmi_sensor/README.md introduced: 0.12.0 tags: [linux, macos, windows, iot] @@ -636,7 +665,7 @@ input: description: | The Ipset input plugin gathers packets and bytes counters from Linux `ipset`. It uses the output of the command `ipset save`. Ipsets created without the `counters` option are ignored. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ipset/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ipset/README.md introduced: 1.6.0 tags: [linux, macos, windows, networking, security, systems] @@ -645,7 +674,7 @@ input: description: | The IPtables input plugin gathers packets and bytes counters for rules within a set of table and chain from the Linux iptables firewall. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/iptables/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/iptables/README.md introduced: 1.1.0 tags: [linux, macos, windows, systems] @@ -654,7 +683,7 @@ input: description: | The IPVS input plugin uses the Linux kernel netlink socket interface to gather metrics about IPVS virtual and real servers. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ipvs/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ipvs/README.md introduced: 1.9.0 tags: [linux, macos, windows, systems] @@ -666,15 +695,15 @@ input: This plugin does not require a plugin on Jenkins and it makes use of Jenkins API to retrieve all the information needed. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/jenkins/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jenkins/README.md introduced: 1.9.0 tags: [linux, macos, windows, build-deploy] - name: Jolokia id: jolokia description: | - *Deprecated in Telegraf 1.5.0. Use the [Jolokia2 input plugin](#jolokia2_agent).* - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/jolokia/README.md + _Deprecated in Telegraf 1.5.0. Use the [Jolokia2 input plugin](#jolokia2_agent)._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jolokia/README.md introduced: 0.2.1 deprecated: 1.5.0 tags: [linux, macos, windows, networking] @@ -685,7 +714,7 @@ input: The Jolokia2 Agent input plugin reads JMX metrics from one or more [Jolokia](https://jolokia.org/) agent REST endpoints using the [JSON-over-HTTP protocol](https://jolokia.org/reference/html/protocol.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/jolokia2/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jolokia2/README.md introduced: 1.5.0 tags: [linux, macos, windows, networking] @@ -695,7 +724,7 @@ input: The Jolokia2 Proxy input plugin reads JMX metrics from one or more targets by interacting with a [Jolokia](https://jolokia.org/) proxy REST endpoint using the [Jolokia](https://jolokia.org/) [JSON-over-HTTP protocol](https://jolokia.org/reference/html/protocol.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/jolokia2/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jolokia2/README.md introduced: 1.5.0 tags: [linux, macos, windows, networking] @@ -706,7 +735,7 @@ input: of OpenConfig telemetry data from listed sensors using the Junos Telemetry Interface. Refer to [openconfig.net](http://openconfig.net/) for more details about OpenConfig and [Junos Telemetry Interface (JTI)](https://www.juniper.net/documentation/en_US/junos/topics/concept/junos-telemetry-interface-oveview.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/jti_openconfig_telemetry/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jti_openconfig_telemetry/README.md introduced: 1.7.0 tags: [linux, macos, windows, iot] @@ -714,7 +743,7 @@ input: id: kapacitor description: | The Kapacitor input plugin will collect metrics from the given Kapacitor instances. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kapacitor/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kapacitor/README.md introduced: 1.3.0 tags: [linux, macos, windows, applications] @@ -722,7 +751,7 @@ input: id: kernel description: | The Kernel input plugin gathers kernel statistics from `/proc/stat`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kernel/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kernel/README.md introduced: 0.11.0 tags: [linux, macos, windows, systems] @@ -730,7 +759,7 @@ input: id: kernel_vmstat description: | The Kernel VMStat input plugin gathers kernel statistics from `/proc/vmstat`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kernel_vmstat/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kernel_vmstat/README.md introduced: 1.0.0 tags: [linux, macos, windows, systems] @@ -739,7 +768,7 @@ input: description: | The Kibana input plugin queries the Kibana status API to obtain the health status of Kibana and some useful metrics. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kibana/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kibana/README.md introduced: 1.8.0 tags: [linux, macos, windows, applications] @@ -754,7 +783,7 @@ input: It is assumed that this plugin is running as part of a daemonset within a Kubernetes installation. This means that Telegraf is running on every node within the cluster. Therefore, you should configure this plugin to talk to its locally running kubelet. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kubernetes/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kubernetes/README.md introduced: 1.1.0 tags: [linux, macos, windows, build-deploy, containers] @@ -772,7 +801,7 @@ input: - pods (containers) - statefulsets - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/kube_inventory/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/kube_inventory/README.md introduced: 1.10.0 tags: [linux, macos, windows, build-deploy, containers] @@ -782,7 +811,7 @@ input: The LeoFS input plugin gathers metrics of LeoGateway, LeoManager, and LeoStorage using SNMP. See [System monitoring](https://leo-project.net/leofs/docs/admin/system_admin/monitoring/) in the [LeoFS documentation](https://leo-project.net/leofs/docs/) for more information. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/leofs/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/leofs/README.md introduced: 0.1.5 tags: [linux, macos, windows, systems, data-stores] @@ -791,7 +820,7 @@ input: description: | The Linux Sysctl FS input plugin provides Linux system level file (`sysctl fs`) metrics. The documentation on these fields can be found [here](https://www.kernel.org/doc/Documentation/sysctl/fs.txt). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/linux_sysctl_fs/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/linux_sysctl_fs/README.md introduced: 1.3.0 tags: [linux, macos, windows, systems] @@ -801,17 +830,26 @@ input: The Logparser input plugin streams and parses the given log files. Currently, it has the capability of parsing "grok" patterns from log files, which also supports regular expression (regex) patterns. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/logparser/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/logparser/README.md introduced: 1.0.0 tags: [linux, macos, windows, logging] + - name: Logstash + id: logstash + description: | + The Logstash input plugin reads metrics exposed by the [Logstash Monitoring API](https://www.elastic.co/guide/en/logstash/current/monitoring-logstash.html). + The plugin supports Logstash 5 and later. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/logstash/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, logging] + - name: Lustre2 id: lustre2 description: | Lustre Jobstats allows for RPCs to be tagged with a value, such as a job's ID. This allows for per job statistics. The Lustre2 input plugin collects statistics and tags the data with the `jobid`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/lustre2 + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/lustre2 introduced: 0.1.5 tags: [linux, macos, windows, systems] @@ -819,10 +857,18 @@ input: id: mailchimp description: | The Mailchimp input plugin gathers metrics from the `/3.0/reports` MailChimp API. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mailchimp + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mailchimp introduced: 0.2.4 tags: [linux, macos, windows, cloud, web] + - name: MarkLogic + id: marklogic + description: | + The MarkLogic input plugin gathers health status metrics from one or more MarkLogic hosts. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/marklogic/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, data-stores] + - name: Mcrouter id: mcrouter description: | @@ -831,7 +877,7 @@ input: developed and maintained by Facebook, for scaling memcached (http://memcached.org/) deployments. It's a core component of cache infrastructure at Facebook and Instagram where mcrouter handles almost 5 billion requests per second at peak. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mcrouter/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mcrouter/README.md introduced: 1.7.0 tags: [linux, macos, windows, networking] @@ -841,7 +887,7 @@ input: The Mem input plugin collects system memory metrics. For a more complete explanation of the difference between used and actual_used RAM, see [Linux ate my ram](https://www.linuxatemyram.com/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mem/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mem/README.md introduced: 0.1.5 tags: [linux, macos, windows, systems] @@ -849,7 +895,7 @@ input: id: memcached description: | The Memcached input plugin gathers statistics data from a Memcached server. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/memcached/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/memcached/README.md introduced: 0.1.2 tags: [linux, macos, windows, data-stores] @@ -858,7 +904,7 @@ input: description: | The Mesosphere DC/OS input plugin gathers metrics from a DC/OS cluster's [metrics component](https://docs.mesosphere.com/1.10/metrics/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/dcos/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/dcos/README.md introduced: 1.5.0 tags: [linux, macos, windows, containers] @@ -868,7 +914,7 @@ input: The Microsoft SQL Server input plugin provides metrics for your Microsoft SQL Server instance. It currently works with SQL Server versions 2008+. Recorded metrics are lightweight and use Dynamic Management Views supplied by SQL Server. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/sqlserver/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/sqlserver/README.md introduced: 0.10.1 tags: [linux, macos, windows, data-stores] @@ -877,7 +923,7 @@ input: description: | The Minecraft input plugin uses the RCON protocol to collect statistics from a scoreboard on a Minecraft server. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/minecraft/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/minecraft/README.md introduced: 1.4.0 tags: [linux, macos, windows, gaming] @@ -886,7 +932,7 @@ input: description: | The MongoDB input plugin collects MongoDB stats exposed by `serverStatus` and few more and create a single measurement containing values. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mongodb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mongodb/README.md introduced: 0.1.5 tags: [linux, macos, windows, data-stores] @@ -895,7 +941,7 @@ input: description: | The MQTT Consumer input plugin reads from specified MQTT topics and adds messages to InfluxDB. Messages are in the [Telegraf input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mqtt_consumer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mqtt_consumer/README.md introduced: 0.10.3 tags: [linux, macos, windows, messaging] @@ -909,7 +955,7 @@ input: > To parse metrics from a single file formatted in one of the supported > [input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input), > use the [file input plugin](#file). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/multifile/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/multifile/README.md introduced: 1.10.0 tags: [linux, macos, windows] @@ -917,7 +963,7 @@ input: id: mysql description: | The MySQL input plugin gathers the statistics data from MySQL servers. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/mysql/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/mysql/README.md introduced: 0.1.1 tags: [linux, macos, windows, data-stores] @@ -928,7 +974,7 @@ input: Messages are expected in the [Telegraf input data formats](https://docs.influxdata.com/telegraf/latest/data_formats/input/). A Queue Group is used when subscribing to subjects so multiple instances of Telegraf can read from a NATS cluster in parallel. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nats_consumer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nats_consumer/README.md introduced: 0.10.3 tags: [linux, macos, windows, messaging] @@ -937,7 +983,7 @@ input: description: | The NATS Server Monitoring input plugin gathers metrics when using the [NATS Server monitoring server](https://www.nats.io/documentation/server/gnatsd-monitoring/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nats/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nats/README.md introduced: 1.6.0 tags: [linux, macos, windows, messaging] @@ -949,7 +995,7 @@ input: control their tanks based on various probes. The data is taken directly from the `/cgi-bin/status.xml` at the interval specified in the `telegraf.conf` configuration file. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/neptune_apex/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/neptune_apex/README.md introduced: 1.10.0 tags: [linux, macos, windows, iot] @@ -957,7 +1003,7 @@ input: id: net description: | The Net input plugin gathers metrics about network interface usage (Linux only). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/net/NET_README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/net/NET_README.md introduced: 0.1.1 tags: [linux, macos, networking] @@ -966,7 +1012,7 @@ input: description: | The Netstat input plugin gathers TCP metrics such as established, time-wait and sockets counts by using `lsof`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/net/NETSTAT_README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/net/NETSTAT_README.md introduced: 0.2.0 tags: [linux, macos, windows, networking, systems] @@ -975,7 +1021,7 @@ input: description: | The Network Response input plugin tests UDP and TCP connection response time. It can also check response text. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/net_response/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/net_response/README.md introduced: 0.10.3 tags: [linux, macos, windows, networking] @@ -983,7 +1029,7 @@ input: id: nginx description: | The NGINX input plugin reads NGINX basic status information (`ngx_http_stub_status_module`). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nginx/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nginx/README.md introduced: 0.1.5 tags: [linux, macos, windows, servers, web] @@ -997,7 +1043,7 @@ input: This is similar to the live activity monitoring of NGINX Plus. For module configuration details, see the [NGINX VTS module documentation](https://github.com/vozlt/nginx-module-vts#synopsis). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nginx_vts/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nginx_vts/README.md introduced: 1.9.0 tags: [linux, macos, windows, servers, web] @@ -1010,7 +1056,7 @@ input: Structures for NGINX Plus have been built based on history of [status module documentation](http://nginx.org/en/docs/http/ngx_http_status_module.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nginx_plus/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nginx_plus/README.md introduced: 1.5.0 tags: [linux, macos, windows, servers, web] @@ -1018,7 +1064,7 @@ input: id: nginx_plus_api description: | The NGINX Plus API input plugin gathers advanced status information for NGINX Plus servers. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nginx_plus_api/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nginx_plus_api/README.md introduced: 1.9.0 tags: [linux, macos, windows, servers, web] @@ -1035,7 +1081,7 @@ input: The status page displays the current status of all upstreams and servers as well as number of the failed and successful checks. This information can be exported in JSON format and parsed by this input. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nginx_plus_api/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nginx_plus_api/README.md introduced: 1.10.0 tags: [linux, macos, windows, servers, web] @@ -1043,7 +1089,7 @@ input: id: nsq description: | The NSQ input plugin collects metrics from NSQD API endpoints. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nsq + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nsq introduced: 1.0.0 tags: [linux, macos, windows, messaging] @@ -1052,7 +1098,7 @@ input: description: | The NSQ Consumer input plugin polls a specified NSQD topic and adds messages to InfluxDB. This plugin allows a message to be in any of the supported data_format types. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nsq_consumer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nsq_consumer/README.md introduced: 0.10.1 tags: [linux, macos, windows, messaging] @@ -1061,7 +1107,7 @@ input: description: | The Nstat input plugin collects network metrics from `/proc/net/netstat`, `/proc/net/snmp`, and `/proc/net/snmp6` files. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nstat/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nstat/README.md introduced: 0.13.1 tags: [linux, macos, windows, networking, systems] @@ -1069,7 +1115,7 @@ input: id: ntpq description: | The NTPq input plugin gets standard NTP query metrics, requires ntpq executable. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ntpq/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ntpq/README.md introduced: 0.11.0 tags: [linux, macos, windows, networking, systems] @@ -1079,7 +1125,7 @@ input: The NVIDIA SMI input plugin uses a query on the [NVIDIA System Management Interface (`nvidia-smi`)](https://developer.nvidia.com/nvidia-system-management-interface) binary to pull GPU stats including memory and GPU usage, temp and other. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/nvidia_smi/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/nvidia_smi/README.md introduced: 1.7.0 tags: [linux, macos, windows, systems] @@ -1087,24 +1133,33 @@ input: id: openldap description: | The OpenLDAP input plugin gathers metrics from OpenLDAP's `cn=Monitor` backend. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/openldap/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/openldap/README.md introduced: 1.4.0 tags: [linux, macos, windows, data-stores] + - name: OpenNTPD + id: openntpd + description: | + The OpenNTPD input plugin gathers standard Network Time Protocol (NTP) query + metrics from OpenNTPD using the `ntpctl` command. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/openntpd/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, networking] + - name: OpenSMTPD id: opensmtpd description: | The OpenSMTPD input plugin gathers stats from [OpenSMTPD](https://www.opensmtpd.org/), a free implementation of the server-side SMTP protocol. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/opensmtpd/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/opensmtpd/README.md introduced: 1.5.0 tags: [linux, macos, windows, applications] - name: OpenWeatherMap id: openweathermap description: | - The OpenWeatherMap input plugins collects current weather and forecast data from OpenWeatherMap. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/openweathermap/README.md + Collect current weather and forecast data from OpenWeatherMap. + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/openweathermap/README.md introduced: 1.11.0 tags: [linux, macos, windows, applications] @@ -1115,7 +1170,7 @@ input: Currently it can retrive information about the state table: the number of current entries in the table, and counters for the number of searches, inserts, and removals to the table. The pf plugin retrieves this information by invoking the `pfstat` command. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/pf/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/pf/README.md introduced: 1.5.0 tags: [linux, macos, windows, networking, security] @@ -1124,7 +1179,7 @@ input: description: | The PgBouncer input plugin provides metrics for your PgBouncer load balancer. For information about the metrics, see the [PgBouncer documentation](https://pgbouncer.github.io/usage.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/pgbouncer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/pgbouncer/README.md introduced: 1.8.0 tags: [linux, macos, windows, data-stores] @@ -1133,7 +1188,7 @@ input: description: | The Phfusion 0Passenger input plugin gets Phusion Passenger statistics using their command line utility `passenger-status`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/passenger/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/passenger/README.md introduced: 0.10.1 tags: [linux, macos, windows, web] @@ -1141,7 +1196,7 @@ input: id: phpfpm description: | The PHP FPM input plugin gets phpfpm statistics using either HTTP status page or fpm socket. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/phpfpm/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/phpfpm/README.md introduced: 0.1.10 tags: [linux, macos, windows, servers, web] @@ -1150,7 +1205,7 @@ input: description: | The Ping input plugin measures the round-trip for ping commands, response time, and other packet statistics. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/ping/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/ping/README.md introduced: 0.1.8 tags: [linux, macos, windows, networking] @@ -1162,7 +1217,7 @@ input: [queues](http://www.postfix.org/QSHAPE_README.html#queues), it will report the queue length (number of items), size (bytes used by items), and age (age of oldest item in seconds). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/postfix/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/postfix/README.md introduced: 1.5.0 tags: [linux, macos, windows, services, web] @@ -1173,7 +1228,7 @@ input: It currently works with PostgreSQL versions 8.1+. It uses data from the built-in `pg_stat_database` and `pg_stat_bgwriter` views. The metrics recorded depend on your version of PostgreSQL. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/postgresql/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/postgresql/README.md introduced: 0.10.3 tags: [linux, macos, windows, data-stores] @@ -1182,7 +1237,7 @@ input: description: | This PostgreSQL Extensible input plugin provides metrics for your Postgres database. It has been designed to parse SQL queries in the plugin section of `telegraf.conf` files. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/postgresql_extensible + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/postgresql_extensible introduced: 0.12.0 tags: [linux, macos, windows, data-stores] @@ -1190,7 +1245,7 @@ input: id: powerdns description: | The PowerDNS input plugin gathers metrics about PowerDNS using UNIX sockets. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/powerdns/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/powerdns/README.md introduced: 0.10.2 tags: [linux, macos, windows, networking, web] @@ -1198,7 +1253,7 @@ input: id: powerdns_recursor description: | The PowerDNS Recursor input plugin gathers metrics about PowerDNS Recursor using UNIX sockets. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/powerdns_recursor/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/powerdns_recursor/README.md introduced: 1.11.0 tags: [linux, macos, windows, networking, web] @@ -1209,7 +1264,7 @@ input: and groups them by status (zombie, sleeping, running, etc.). On Linux, this plugin requires access to `procfs` (`/proc`); on other operating systems, it requires access to execute `ps`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/processes/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/processes/README.md introduced: 0.11.0 tags: [linux, macos, windows, systems] @@ -1229,7 +1284,7 @@ input: The Procstat input plugin will tag processes according to how they are specified in the configuration. If a pid file is used, a "pidfile" tag will be generated. On the other hand, if an executable is used an "exe" tag will be generated. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/procstat/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/procstat/README.md introduced: 0.2.0 tags: [linux, macos, windows, systems] @@ -1238,7 +1293,7 @@ input: description: | The Prometheus Format input plugin input plugin gathers metrics from HTTP servers exposing metrics in Prometheus format. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/prometheus/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/prometheus/README.md introduced: 0.2.1 tags: [linux, macos, windows, applications] @@ -1248,7 +1303,7 @@ input: The Puppet Agent input plugin collects variables outputted from the `last_run_summary.yaml` file usually located in `/var/lib/puppet/state/` Puppet Agent Runs. For more information, see [Puppet Monitoring: How to Monitor the Success or Failure of Puppet Runs](https://puppet.com/blog/puppet-monitoring-how-to-monitor-success-or-failure-of-puppet-runs) - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/puppetagent + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/puppetagent introduced: 0.2.0 tags: [linux, macos, windows, build-deploy] @@ -1257,7 +1312,7 @@ input: description: | The RabbitMQ input plugin reads metrics from RabbitMQ servers via the [Management Plugin](https://www.rabbitmq.com/management.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/rabbitmq/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/rabbitmq/README.md introduced: 0.1.5 tags: [linux, macos, windows, messaging] @@ -1267,7 +1322,7 @@ input: The Raindrops Middleware input plugin reads from the specified [Raindrops middleware](http://raindrops.bogomips.org/Raindrops/Middleware.html) URI and adds the statistics to InfluxDB. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/raindrops/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/raindrops/README.md introduced: 0.10.3 tags: [linux, macos, windows, servers, web] @@ -1280,7 +1335,7 @@ input: Additionally the plugin also calculates the hit/miss ratio (`keyspace_hitrate`) and the elapsed time since the last RDB save (`rdb_last_save_time_elapsed`). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/redis/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/redis/README.md introduced: 0.1.1 tags: [linux, macos, windows, data-stores] @@ -1289,7 +1344,7 @@ input: description: | The RethinkDB input plugin works with RethinkDB 2.3.5+ databases that requires username, password authorization, and Handshake protocol v1.0. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/rethinkdb + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/rethinkdb introduced: 0.1.3 tags: [linux, macos, windows, data-stores] @@ -1297,7 +1352,7 @@ input: id: riak description: | The Riak input plugin gathers metrics from one or more Riak instances. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/riak/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/riak/README.md introduced: 0.10.4 tags: [linux, macos, windows, data-stores] @@ -1307,7 +1362,7 @@ input: The Salesforce input plugin gathers metrics about the limits in your Salesforce organization and the remaining usage. It fetches its data from the limits endpoint of the Salesforce REST API. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/salesforce/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/salesforce/README.md introduced: 1.4.0 tags: [linux, macos, windows, applications, cloud] @@ -1316,7 +1371,7 @@ input: description: | The Sensors input plugin collects collects sensor metrics with the sensors executable from the `lm-sensor` package. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/sensors/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/sensors/README.md introduced: 0.10.1 tags: [linux, macos, windows, iot] @@ -1330,7 +1385,7 @@ input: The plugin detects and reports on various indicators of drive reliability, with the intent of enabling the anticipation of hardware failures. See [smartmontools](https://www.smartmontools.org/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/smart/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/smart/README.md introduced: 1.5.0 tags: [linux, macos, windows, systems] @@ -1338,7 +1393,7 @@ input: id: snmp description: | The SNMP input plugin gathers metrics from SNMP agents. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/snmp/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/snmp/README.md introduced: 0.10.1 tags: [linux, macos, windows, networking] @@ -1346,8 +1401,8 @@ input: id: snmp_legacy description: | The SNMP Legacy input plugin gathers metrics from SNMP agents. - *Deprecated in Telegraf 1.0.0. Use the [SNMP input plugin](#snmp).* - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/snmp_legacy/README.md + _Deprecated in Telegraf 1.0.0. Use the [SNMP input plugin](#snmp)._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/snmp_legacy/README.md introduced: 0.10.1 deprecated: 1.0.0 tags: [linux, macos, windows, networking] @@ -1358,7 +1413,7 @@ input: The Socket Listener input plugin listens for messages from streaming (TCP, UNIX) or datagram (UDP, unixgram) protocols. Messages are expected in the [Telegraf Input Data Formats](https://docs.influxdata.com/telegraf/latest/data_formats/input/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/socket_listener/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/socket_listener/README.md introduced: 1.3.0 tags: [linux, macos, windows, networking] @@ -1370,7 +1425,7 @@ input: > This plugin accesses APIs that are [chargeable](https://cloud.google.com/stackdriver/pricing#monitoring-costs). > You may incur costs. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/stackdriver/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/stackdriver/README.md introduced: 1.10.0 tags: [linux, macos, windows, cloud] @@ -1381,7 +1436,7 @@ input: `statsd` listener service while Telegraf is running. StatsD messages are formatted as described in the original [etsy statsd](https://github.com/etsy/statsd/blob/master/docs/metric_types.md) implementation. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/statsd/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/statsd/README.md introduced: 0.2.0 tags: [linux, macos, windows, applications] @@ -1394,7 +1449,7 @@ input: For more information about Linux swap spaces, see [All about Linux swap space](https://www.linux.com/news/all-about-linux-swap-space) - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/swap/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/swap/README.md introduced: 1.7.0 tags: [linux, macos, systems] @@ -1404,7 +1459,7 @@ input: The Syslog input plugin listens for syslog messages transmitted over [UDP](https://tools.ietf.org/html/rfc5426) or [TCP](https://tools.ietf.org/html/rfc5425). Syslog messages should be formatted according to [RFC 5424](https://tools.ietf.org/html/rfc5424). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/syslog/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/syslog/README.md introduced: 1.7.0 tags: [linux, macos, windows, logging, systems] @@ -1414,7 +1469,7 @@ input: The Sysstat input plugin collects [sysstat](https://github.com/sysstat/sysstat) system metrics with the sysstat collector utility `sadc` and parses the created binary data file with the `sadf` utility. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/sysstat + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/sysstat introduced: 0.12.1 tags: [linux, macos, windows, systems] @@ -1423,7 +1478,7 @@ input: description: | The System input plugin gathers general stats on system load, uptime, and number of users logged in. It is basically equivalent to the UNIX `uptime` command. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/system/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/system/README.md introduced: 0.1.6 tags: [linux, macos, windows, systems] @@ -1431,15 +1486,15 @@ input: id: tail description: | The Tail input plugin "tails" a log file and parses each log message. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/tail/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/tail/README.md introduced: 1.1.2 tags: [linux, macos, windows, logging] - name: TCP Listener id: tcp_listener description: | - *Deprecated in Telegraf 1.3.0. Use the [Socket Listener input plugin](#socket_listener).* - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/tcp_listener/README.md + _Deprecated in Telegraf 1.3.0. Use the [Socket Listener input plugin](#socket_listener)._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/tcp_listener/README.md introduced: 0.11.0 deprecated: 1.3.0 tags: [linux, macos, windows, networking, web] @@ -1449,7 +1504,7 @@ input: description: | The Teamspeak 3 input plugin uses the Teamspeak 3 ServerQuery interface of the Teamspeak server to collect statistics of one or more virtual servers. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/teamspeak/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/teamspeak/README.md introduced: 1.5.0 tags: [linux, macos, windows, applications, gaming] @@ -1458,7 +1513,7 @@ input: description: | The Telegraf v1.x input plugin collects metrics about the Telegraf v1.x agent itself. Note that some metrics are aggregates across all instances of one type of plugin. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/internal/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/internal/README.md introduced: 1.2.0 tags: [linux, macos, windows, applications] @@ -1466,7 +1521,7 @@ input: id: temp description: | The Temp input plugin collects temperature data from sensors. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/temp/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/temp/README.md introduced: 1.8.0 tags: [linux, macos, windows, iot] @@ -1476,7 +1531,7 @@ input: The Tengine Web Server input plugin gathers status metrics from the [Tengine Web Server](http://tengine.taobao.org/) using the [Reqstat module](http://tengine.taobao.org/document/http_reqstat.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/tengine/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/tengine/README.md introduced: 1.8.0 tags: [linux, macos, windows, servers, web] @@ -1484,7 +1539,7 @@ input: id: trig description: | The Trig input plugin inserts sine and cosine waves for demonstration purposes. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/trig + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/trig introduced: 0.3.0 tags: [linux, macos, windows] @@ -1494,15 +1549,15 @@ input: The Twemproxy input plugin gathers data from Twemproxy instances, processes Twemproxy server statistics, processes pool data, and processes backend server (Redis/Memcached) statistics. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/twemproxy + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/twemproxy introduced: 0.3.0 tags: [linux, macos, windows, servers, web] - name: UDP Listener id: udp_listener description: | - *Deprecated in Telegraf 1.3.0. use the [Socket Listener input plugin](#socket_listener).* - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/udp_listener/README.md + _Deprecated in Telegraf 1.3.0. use the [Socket Listener input plugin](#socket_listener)._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/udp_listener/README.md introduced: 0.11.0 deprecated: 1.3.0 tags: [linux, macos, windows, networking] @@ -1512,15 +1567,23 @@ input: description: | The Unbound input plugin gathers statistics from [Unbound](https://www.unbound.net/), a validating, recursive, and caching DNS resolver. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/unbound/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/unbound/README.md introduced: 1.5.0 tags: [linux, macos, windows, networking] + - name: uWSGI + id: uwsgi + description: | + The uWSGI input plugin gathers metrics about uWSGI using the [uWSGI Stats Server](https://uwsgi-docs.readthedocs.io/en/latest/StatsServer.html). + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/uwsgi/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, cloud] + - name: Varnish id: varnish description: | The Varnish input plugin gathers stats from [Varnish HTTP Cache](https://varnish-cache.org/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/varnish/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/varnish/README.md introduced: 0.13.1 tags: [linux, macos, windows, networking] @@ -1530,8 +1593,8 @@ input: The VMware vSphere input plugin uses the vSphere API to gather metrics from multiple vCenter servers (clusters, hosts, VMs, and data stores). For more information on the available performance metrics, see - [Common vSphere Performance Metrics](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/vsphere/METRICS.md). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/vsphere/README.md + [Common vSphere Performance Metrics](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/vsphere/METRICS.md). + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/vsphere/README.md introduced: 1.8.0 tags: [linux, macos, windows, containers] @@ -1541,17 +1604,17 @@ input: The Webhooks input plugin starts an HTTPS server and registers multiple webhook listeners. #### Available webhooks - - [Filestack](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/filestack/README.md) - - [GitHub](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/github/README.md) - - [Mandrill](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/mandrill/README.md) - - [Papertrail](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/papertrail/README.md) - - [Particle.io](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/particle/README.md) - - [Rollbar](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/rollbar) + - [Filestack](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/filestack/README.md) + - [GitHub](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/github/README.md) + - [Mandrill](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/mandrill/README.md) + - [Papertrail](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/papertrail/README.md) + - [Particle.io](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/particle/README.md) + - [Rollbar](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/rollbar) #### Add new webhooks If you need a webhook that is not supported, consider - [adding a new webhook](https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks#adding-new-webhooks-plugin). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/webhooks/README.md + [adding a new webhook](https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks#adding-new-webhooks-plugin). + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/webhooks/README.md introduced: 1.0.0 tags: [linux, macos, windows, applications, web] @@ -1560,7 +1623,7 @@ input: description: | The Windows Performance Counters input plugin reads Performance Counters on the Windows operating sytem. **Windows only**. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/win_perf_counters/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/win_perf_counters/README.md introduced: 0.10.2 tags: [windows, systems] @@ -1568,7 +1631,7 @@ input: id: win_services description: | The Windows Services input plugin reports Windows services info. **Windows only**. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/win_services/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/win_services/README.md introduced: 1.4.0 tags: [windows, servers, systems] @@ -1577,7 +1640,7 @@ input: description: | The Wireless input plugin gathers metrics about wireless link quality by reading the `/proc/net/wireless` file. **This plugin currently supports Linux only**. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/wireless/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/wireless/README.md introduced: 1.9.0 tags: [linux, networking] @@ -1586,7 +1649,7 @@ input: description: | The X.509 Certificate input plugin provides information about X.509 certificate accessible using the local file or network connection. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/x509_cert/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/x509_cert/README.md introduced: 1.8.0 tags: [linux, macos, windows, networking] @@ -1598,7 +1661,7 @@ input: The ZFS input plugin provides metrics from your ZFS filesystems. It supports ZFS on Linux and FreeBSD. It gets ZFS statistics from `/proc/spl/kstat/zfs` on Linux and from `sysctl` and `zpool` on FreeBSD. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/inputs/zfs/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/inputs/zfs/README.md introduced: 0.2.1 tags: [linux, macos, windows, systems] @@ -1614,7 +1677,7 @@ output: id: cloudwatch description: | The Amazon CloudWatch output plugin send metrics to Amazon CloudWatch. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/cloudwatch/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/cloudwatch/README.md introduced: 0.10.1 tags: [linux, macos, windows, cloud] @@ -1625,7 +1688,7 @@ output: in the early stages of development. It will batch up all of the points into one `PUT` request to Kinesis. This should save the number of API requests by a considerable level. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/kinesis/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/kinesis/README.md introduced: 0.2.5 tags: [linux, macos, windows, cloud, messaging] @@ -1639,7 +1702,7 @@ output: If the point value being sent cannot be converted to a float64 value, the metric is skipped. Metrics are grouped by converting any `_` characters to `.` in the Point Name. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/amon/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/amon/README.md introduced: 0.2.1 tags: [linux, macos, windows, databases] @@ -1651,7 +1714,7 @@ output: Metrics are written to a topic exchange using `tag`, defined in configuration file as `RoutingTag`, as a routing key. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/amqp/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/amqp/README.md introduced: 0.1.9 tags: [linux, macos, windows, messaging] @@ -1660,7 +1723,7 @@ output: description: | The Apache Kafka output plugin writes to a [Kafka Broker](http://kafka.apache.org/07/quickstart.html) acting a Kafka Producer. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/kafka/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/kafka/README.md introduced: 0.1.7 tags: [linux, macos, windows, messaging] @@ -1669,7 +1732,7 @@ output: description: | The CrateDB output plugin writes to [CrateDB](https://crate.io/), a real-time SQL database for machine data and IoT, using its [PostgreSQL protocol](https://crate.io/docs/crate/reference/protocols/postgres.html). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/cratedb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/cratedb/README.md introduced: 1.5.0 tags: [linux, macos, windows, data-stores] @@ -1679,7 +1742,7 @@ output: The Datadog output plugin writes to the [Datadog Metrics API](http://docs.datadoghq.com/api/#metrics) and requires an `apikey` which can be obtained [here](https://app.datadoghq.com/account/settings#api) for the account. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/datadog/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/datadog/README.md introduced: 0.1.6 tags: [linux, macos, windows, applications, cloud] @@ -1688,7 +1751,7 @@ output: description: | The Discard output plugin simply drops all metrics that are sent to it. It is only meant to be used for testing purposes. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/discard/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/discard/README.md introduced: 1.2.0 tags: [linux, macos, windows] @@ -1698,15 +1761,23 @@ output: The Elasticsearch output plugin writes to Elasticsearch via HTTP using [Elastic](http://olivere.github.io/elastic/). Currently it only supports Elasticsearch 5.x series. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/elasticsearch/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/elasticsearch/README.md introduced: 0.1.5 tags: [linux, macos, windows, data-stores] + - name: Exec + id: exec + description: | + The Exec output plugin sends Telegraf metrics to an external application over `stdin`. + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/exec/README.md + introduced: 1.12.0 + tags: [linux, macos, windows, systems] + - name: File id: file description: | The File output plugin writes Telegraf metrics to files. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/file/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/file/README.md introduced: 0.10.3 tags: [linux, macos, windows, systems] @@ -1715,7 +1786,7 @@ output: description: | The Google PubSub output plugin publishes metrics to a [Google Cloud PubSub](https://cloud.google.com/pubsub) topic as one of the supported [output data formats](https://docs.influxdata.com/telegraf/latest/data_formats/output). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/cloud_pubsub/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/cloud_pubsub/README.md introduced: 1.10.0 tags: [linux, macos, windows, messaging, cloud] @@ -1723,7 +1794,7 @@ output: id: graphite description: | The Graphite output plugin writes to [Graphite](http://graphite.readthedocs.org/en/latest/index.html) via raw TCP. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/graphite/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/graphite/README.md introduced: 0.10.1 tags: [linux, macos, windows, data-stores] @@ -1731,7 +1802,7 @@ output: id: graylog description: | The Graylog output plugin writes to a Graylog instance using the `gelf` format. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/graylog/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/graylog/README.md introduced: 1.0.0 tags: [linux, macos, windows, logging] @@ -1740,18 +1811,16 @@ output: description: | The HTTP output plugin sends metrics in a HTTP message encoded using one of the output data formats. For `data_formats` that support batching, metrics are sent in batch format. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/http/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/http/README.md introduced: 1.7.0 tags: [linux, macos, windows, applications] - name: Health id: health description: | - The health output plugin provides an HTTP health check resource that can be configured - to return a failure status code based on the value of a metric. - When the plugin is healthy it returns a 200 response; when unhealthy it returns a 503 response. - The default state is healthy. One or more checks must fail in order for the resource to enter the failed state. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/health/README.md + The health plugin provides a HTTP health check resource that can be configured to return a failure status code based on the value of a metric. + When the plugin is healthy it will return a 200 response; when unhealthy it will return a 503 response. The default state is healthy, one or more checks must fail in order for the resource to enter the failed state. + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/health/README.md introduced: 1.11.0 tags: [linux, macos, windows, applications] @@ -1759,7 +1828,7 @@ output: id: influxdb description: | The InfluxDB v1.x output plugin writes to InfluxDB using HTTP or UDP. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/influxdb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/influxdb/README.md introduced: 0.1.1 tags: [linux, macos, windows, data-stores] @@ -1767,7 +1836,7 @@ output: id: influxdb_v2 description: | The InfluxDB v2 output plugin writes metrics to [InfluxDB 2.0](https://github.com/influxdata/influxdb). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/influxdb_v2/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/influxdb_v2/README.md introduced: 1.8.0 tags: [linux, macos, windows, data-stores] @@ -1781,7 +1850,7 @@ output: difference being that the type of stat (gauge, increment) is the first token, separated from the metric itself by whitespace. The increment type is only used if the metric comes in as a counter through `[[inputs.statsd]]`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/instrumental/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/instrumental/README.md introduced: 0.13.1 tags: [linux, macos, windows, applications] @@ -1791,7 +1860,7 @@ output: The Librato output plugin writes to the [Librato Metrics API](http://dev.librato.com/v1/metrics#metrics) and requires an `api_user` and `api_token` which can be obtained [here](https://metrics.librato.com/account/api_tokens) for the account. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/librato/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/librato/README.md introduced: 0.2.0 tags: [linux, macos, windows, cloud] @@ -1800,7 +1869,7 @@ output: description: | The Microsoft Azure Application Insights output plugin writes Telegraf metrics to [Application Insights (Microsoft Azure)](https://azure.microsoft.com/en-us/services/application-insights/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/application_insights/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/application_insights/README.md introduced: 1.7.0 tags: [linux, macos, windows, cloud, applications] @@ -1824,7 +1893,7 @@ output: as the Azure Monitor metric name. All field values are written as a summarized set that includes `min`, `max`, `sum`, and `count`. Tags are written as a dimension on each Azure Monitor metric. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/azure_monitor/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/azure_monitor/README.md introduced: 1.8.0 tags: [linux, macos, windows, cloud] @@ -1833,7 +1902,7 @@ output: description: | The MQTT Producer output plugin writes to the MQTT server using [supported output data formats](https://docs.influxdata.com/telegraf/latest/data_formats/output/). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/mqtt/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/mqtt/README.md introduced: 0.2.0 tags: [linux, macos, windows, messaging] @@ -1841,7 +1910,7 @@ output: id: nats description: | The NATS Output output plugin writes to a (list of) specified NATS instance(s). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/nats/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/nats/README.md introduced: 1.1.0 tags: [linux, macos, windows, messaging] @@ -1850,7 +1919,7 @@ output: description: | The NSQ output plugin writes to a specified NSQD instance, usually local to the producer. It requires a server name and a topic name. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/nsq/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/nsq/README.md introduced: 0.2.1 tags: [linux, macos, windows, messaging] @@ -1863,7 +1932,7 @@ output: To use HTTP mode, set `useHttp` to true in config. You can also control how many metrics are sent in each HTTP request by setting `batchSize` in config. See the [OpenTSDB documentation](http://opentsdb.net/docs/build/html/api_http/put.html) for details. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/opentsdb/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/opentsdb/README.md introduced: 0.1.9 tags: [linux, macos, windows, data-stores] @@ -1872,7 +1941,7 @@ output: description: | The Prometheus Client output plugin starts a [Prometheus](https://prometheus.io/) Client, it exposes all metrics on `/metrics` (default) to be polled by a Prometheus server. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/prometheus_client/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/prometheus_client/README.md introduced: 0.2.1 tags: [linux, macos, windows, applications, data-stores] @@ -1880,7 +1949,7 @@ output: id: riemann description: | The Riemann output plugin writes to [Riemann](http://riemann.io/) using TCP or UDP. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/riemann/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/riemann/README.md introduced: 1.3.0 tags: [linux, macos, windows, networking, systems] @@ -1889,7 +1958,7 @@ output: description: | The Riemann Legacy output plugin will be deprecated in a future release, see [#1878](https://github.com/influxdata/telegraf/issues/1878) for more details & discussion. - link: https://github.com/influxdata/telegraf/tree/release-1.11/plugins/outputs/riemann_legacy + link: https://github.com/influxdata/telegraf/tree/master/plugins/outputs/riemann_legacy introduced: 0.2.3 deprecated: 1.3.0 tags: [linux, macos, windows, applications] @@ -1899,7 +1968,7 @@ output: description: | The Socket Writer output plugin writes to a UDP, TCP, or UNIX socket. It can output data in any of the [supported output formats](https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md). - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/socket_writer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/socket_writer/README.md introduced: 1.3.0 tags: [linux, macos, windows, networking] @@ -1915,17 +1984,16 @@ output: Metrics are grouped by the `namespace` variable and metric key, for example `custom.googleapis.com/telegraf/system/load5`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/stackdriver/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/stackdriver/README.md introduced: 1.9.0 tags: [linux, macos, windows, cloud] - name: Syslog id: syslog description: | - The syslog output plugin sends syslog messages transmitted over UDP or TCP or TLS, - with or without the octet counting framing. + The syslog output plugin sends syslog messages transmitted over UDP or TCP or TLS, with or without the octet counting framing. Syslog messages are formatted according to RFC 5424. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/syslog/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/syslog/README.md introduced: 1.11.0 tags: [linux, macos, windows, logging] @@ -1933,7 +2001,7 @@ output: id: wavefront description: | The Wavefront output plugin writes to a Wavefront proxy, in Wavefront data format over TCP. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/outputs/wavefront/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/outputs/wavefront/README.md introduced: 1.5.0 tags: [linux, macos, windows, applications, cloud] @@ -1950,7 +2018,7 @@ aggregator: description: | The BasicStats aggregator plugin gives `count`, `max`, `min`, `mean`, `s2`(variance), and `stdev` for a set of values, emitting the aggregate every period seconds. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/aggregators/basicstats/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/aggregators/basicstats/README.md introduced: 1.5.0 tags: [linux, macos, windows] @@ -1960,9 +2028,8 @@ aggregator: The final aggregator emits the last metric of a contiguous series. A contiguous series is defined as a series which receives updates within the time period in series_timeout. The contiguous series may be longer than the time interval defined by period. - This is useful for getting the final value for data sources that produce discrete time series, - such as procstat, cgroup, kubernetes, etc. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/aggregators/final/README.md + This is useful for getting the final value for data sources that produce discrete time series, such as procstat, cgroup, kubernetes, etc. + link: https://github.com/influxdata/telegraf/blob/master/plugins/aggregators/final/README.md introduced: 1.11.0 tags: [linux, macos, windows] @@ -1978,7 +2045,7 @@ aggregator: Like other Telegraf aggregator plugins, the metric is emitted every period seconds. Bucket counts, however, are not reset between periods and will be non-strictly increasing while Telegraf is running. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/aggregators/histogram/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/aggregators/histogram/README.md introduced: 1.4.0 tags: [linux, macos, windows] @@ -1987,7 +2054,7 @@ aggregator: description: | The MinMax aggregator plugin aggregates `min` and `max` values of each field it sees, emitting the aggregrate every period seconds. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/aggregators/minmax/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/aggregators/minmax/README.md introduced: 1.1.0 tags: [linux, macos, windows] @@ -2007,7 +2074,7 @@ aggregator: ValueCounter only works on fields of the type `int`, `bool`, or `string`. Float fields are being dropped to prevent the creating of too many fields. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/aggregators/valuecounter/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/aggregators/valuecounter/README.md introduced: 1.8.0 tags: [linux, macos, windows] @@ -2025,10 +2092,18 @@ processor: The Converter processor plugin is used to change the type of tag or field values. In addition to changing field types, it can convert between fields and tags. Values that cannot be converted are dropped. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/converter/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/converter/README.md introduced: 1.7.0 tags: [linux, macos, windows] + - name: Date + id: date + description: | + The Date processor plugin adds the metric timestamp as a human readable tag. + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/date/README.md + introduced: 1.12.0 + tags: [linux, macos, windows] + - name: Enum id: enum description: | @@ -2040,7 +2115,7 @@ processor: not contained in the value_mappings. The processor supports explicit configuration of a destination field. By default the source field is overwritten. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/enum/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/enum/README.md introduced: 1.8.0 tags: [linux, macos, windows] @@ -2063,7 +2138,7 @@ processor: Use case of this plugin encompass ensuring certain tags or naming conventions are adhered to irrespective of input plugin configurations, e.g., by `taginclude`. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/override/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/override/README.md introduced: 1.6.0 tags: [linux, macos, windows] @@ -2072,15 +2147,27 @@ processor: description: | The Parser processor plugin parses defined fields containing the specified data format and creates new metrics based on the contents of the field. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/parser/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/parser/README.md introduced: 1.8.0 tags: [linux, macos, windows] + - name: Pivot + id: pivot + description: | + The Pivot processor plugin rotates single-valued metrics into a multi-field metric. + This transformation often results in data that is easier to use with mathematical operators and comparisons. + It also flattens data into a more compact representation for write operations with some output data formats. + + _To perform the reverse operation use the [Unpivot](#unpivot) processor._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/pivot/README.md + introduced: 1.12.0 + tags: [linux, macos, windows] + - name: Printer id: printer description: | The Printer processor plugin simply prints every metric passing through it. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/printer/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/printer/README.md introduced: 1.1.0 tags: [linux, macos, windows] @@ -2089,7 +2176,7 @@ processor: description: | The Regex processor plugin transforms tag and field values using a regular expression (regex) pattern. If `result_key `parameter is present, it can produce new tags and fields from existing ones. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/regex/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/regex/README.md introduced: 1.7.0 tags: [linux, macos, windows] @@ -2097,7 +2184,7 @@ processor: id: rename description: | The Rename processor plugin renames InfluxDB measurements, fields, and tags. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/rename/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/rename/README.md introduced: 1.8.0 tags: [linux, macos, windows] @@ -2122,10 +2209,23 @@ processor: You can specify the `measurement`, `tag` or `field` that you want processed in each section and optionally a `dest` if you want the result stored in a new tag or field. You can specify lots of transformations on data with a single strings processor. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/strings/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/strings/README.md introduced: 1.8.0 tags: [linux, macos, windows] + - name: Tag Limit + id: tag_limit + description: | + The Tag Limit processor plugin preserves only a certain number of tags for any given metric + and chooses the tags to preserve when the number of tags appended by the data source is over the limit. + + This can be useful when dealing with output systems (e.g. Stackdriver) that impose + hard limits on the number of tags or labels per metric or where high levels of + cardinality are computationally or financially expensive. + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/tag_limit/README.md + introduced: 1.12.0 + tags: [linux, macos, windows] + - name: TopK id: topk description: | @@ -2143,6 +2243,17 @@ processor: Note that depending on the amount of metrics on each computed bucket, more than `K` metrics may be returned. - link: https://github.com/influxdata/telegraf/blob/release-1.11/plugins/processors/topk/README.md + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/topk/README.md introduced: 1.7.0 tags: [linux, macos, windows] + + - name: Unpivot + id: unpivot + description: | + The Unpivot processor plugin rotates a multi-field series into single-valued metrics. + This transformation often results in data that is easier to aggregate across fields. + + _To perform the reverse operation use the [Pivot](#pivot) processor._ + link: https://github.com/influxdata/telegraf/blob/master/plugins/processors/unpivot/README.md + introduced: 1.12.0 + tags: [linux, macos, windows] diff --git a/data/versions.yaml b/data/versions.yaml index ac8819176..74d5f45a4 100644 --- a/data/versions.yaml +++ b/data/versions.yaml @@ -1,2 +1,2 @@ stable_version: v2.0 -telegraf_version: 1.11.0 +telegraf_version: 1.12.0 From 81780e5714bd86c5486154d45144c8b90bad7d91 Mon Sep 17 00:00:00 2001 From: Scott Anderson Date: Tue, 3 Sep 2019 12:17:12 -0600 Subject: [PATCH 4/6] fixed description of date package --- content/v2.0/reference/flux/functions/date/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/v2.0/reference/flux/functions/date/_index.md b/content/v2.0/reference/flux/functions/date/_index.md index adc7cb9b5..14d49900d 100644 --- a/content/v2.0/reference/flux/functions/date/_index.md +++ b/content/v2.0/reference/flux/functions/date/_index.md @@ -2,8 +2,8 @@ title: Flux date package list_title: Date package description: > - The Flux math package provides basic constants and mathematical functions. - Import the `math` package. + The Flux date package provides date and time constants and functions. + Import the `date` package. aliases: - /v2.0/reference/flux/language/built-ins/time-constants/ menu: From 723a4ad103c2d3e02f5468836066f137669d335f Mon Sep 17 00:00:00 2001 From: timhallinflux Date: Thu, 5 Sep 2019 13:03:11 -0700 Subject: [PATCH 5/6] Create SECURITY.md --- SECURITY.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 SECURITY.md diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 000000000..79d053066 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,11 @@ +# Security Policy + +## Reporting a Vulnerability + +Reporting a Vulnerability + +InfluxData takes security and our users' trust very seriously. +If you believe you have found a security issue in any of our open source projects, +please responsibly disclose it by contacting security@influxdata.com. +More details about security vulnerability reporting, including our GPG key, +can be found here. https://www.influxdata.com/how-to-report-security-vulnerabilities/ From dcb2ba9c249897e589ddccea8ab41dac4839623b Mon Sep 17 00:00:00 2001 From: timhallinflux Date: Thu, 5 Sep 2019 13:03:57 -0700 Subject: [PATCH 6/6] Update README.md --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index 422d5004c..d12011dd0 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,13 @@ This repository contains the InfluxDB 2.x documentation published at [docs.influ ## Contributing We welcome and encourage community contributions. For information about contributing to the InfluxData documentation, see [Contribution guidelines](CONTRIBUTING.md). +## Reporting a Vulnerability +InfluxData takes security and our users' trust very seriously. +If you believe you have found a security issue in any of our open source projects, +please responsibly disclose it by contacting security@influxdata.com. +More details about security vulnerability reporting, +including our GPG key, can be found here. https://www.influxdata.com/how-to-report-security-vulnerabilities/ + ## Run the docs locally The InfluxData documentation uses [Hugo](https://gohugo.io/), a static site generator built in Go.