AIMS Telegraf agent

The Couchbase input plugin reads per-node and per-bucket metrics from Couchbase.

The CouchDB input plugin gathers metrics of CouchDB using _stats endpoint.

The CPU input plugin gathers metrics about cpu usage.

The Disk input plugin gathers metrics about disk usage by mount point.

The DiskIO input plugin gathers metrics about disk IO by device.

The Disque input plugin gathers metrics from one or more Disque servers.

The DMCache input plugin provides a native collection for dmsetup-based statistics for dm-cache.

The DNS Query input plugin gathers DNS query times in milliseconds - like Dig.

The Docker input plugin uses the Docker Engine API to gather metrics on running Docker containers. The Docker plugin uses the Official Docker Client to gather stats from the Engine API library documentation.

The Dovecot input plugin uses the dovecot Stats protocol to gather metrics on configured domains. For more information, see the Dovecot documentation.

The Elasticsearch input plugin queries endpoints to obtain node and optionally cluster-health or cluster-stats metrics.

The Ethtool plugin gathers ethernet device statistics. The network device and driver determine what fields are gathered.

The Exec input plugin parses supported Telegraf input data formats (line protocol, JSON, Graphite, Value, Nagios, Collectd, and Dropwizard) into metrics. Each Telegraf metric includes the measurement name, tags, fields, and timestamp.

The Fail2ban input plugin gathers the count of failed and banned IP addresses using fail2ban.

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.

The Filecount input plugin reports the number and total size of files in directories that match certain criteria.

The Filestat input plugin gathers metrics about file existence, size, and other stats.

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.

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).

Gathers repository information from GitHub-hosted repositories.

The Google Cloud PubSub input plugin ingests metrics from Google Cloud PubSub and creates metrics using one of the supported input data formats.

The Google Cloud PubSub Push (cloud_pubsub_push) input plugin listens for messages sent using HTTP POST requests from Google Cloud PubSub. The plugin expects messages in Google’s Pub/Sub JSON Format ONLY. 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.

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.

The Hddtemp input plugin reads data from hddtemp daemons.

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. Each data format has its own unique set of configuration options which can be added to the input configuration.

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.

The Icinga 2 input plugin gather status on running services and hosts using the Icinga 2 API.

The Interrupts input plugin gathers metrics about IRQs, including interrupts (from /proc/interrupts) and soft_interrupts (from /proc/softirqs).

The IPMI Sensor input plugin queries the local machine or remote host sensor statistics using the ipmitool utility.

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.

The IPtables input plugin gathers packets and bytes counters for rules within a set of table and chain from the Linux iptables firewall.

The IPVS input plugin uses the Linux kernel netlink socket interface to gather metrics about IPVS virtual and real servers.

The Jolokia2 Agent input plugin reads JMX metrics from one or more Jolokia agent REST endpoints using the JSON-over-HTTP protocol.

The Jolokia2 Proxy input plugin reads JMX metrics from one or more targets by interacting with a Jolokia proxy REST endpoint using the Jolokia JSON-over-HTTP protocol.

The JTI OpenConfig Telemetry input plugin reads Juniper Networks implementation of OpenConfig telemetry data from listed sensors using the Junos Telemetry Interface. Refer to openconfig.net for more details about OpenConfig and Junos Telemetry Interface (JTI).

The Kapacitor input plugin will collect metrics from the given Kapacitor instances.

The Kernel input plugin gathers kernel statistics from /proc/stat.

The Kernel VMStat input plugin gathers kernel statistics from /proc/vmstat.

The Kibana input plugin queries the Kibana status API to obtain the health status of Kibana and some useful metrics.

The Kubernetes input plugin talks to the kubelet API using the /stats/summary endpoint to gather metrics about the running pods and containers for a single host. 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.

The LeoFS input plugin gathers metrics of LeoGateway, LeoManager, and LeoStorage using SNMP. See System monitoring in the LeoFS documentation for more information.

The Linux Sysctl FS input plugin provides Linux system level file (sysctl fs) metrics. The documentation on these fields can be found here.

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.

The Logstash input plugin reads metrics exposed by the Logstash Monitoring API. The plugin supports Logstash 5 and later.

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.

The Mailchimp input plugin gathers metrics from the /3.0/reports MailChimp API.

The MarkLogic input plugin gathers health status metrics from one or more MarkLogic hosts.

The Mcrouter input plugin gathers statistics data from a mcrouter instance. Mcrouter is a memcached protocol router, 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.

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.

The Memcached input plugin gathers statistics data from a Memcached server.

The Mesosphere DC/OS input plugin gathers metrics from a DC/OS cluster’s metrics component.

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.

The MongoDB input plugin collects MongoDB stats exposed by serverStatus and few more and create a single measurement containing values.

The MQTT Consumer input plugin reads from specified MQTT topics and adds messages to InfluxDB. Messages are in the Telegraf input data formats.

The MySQL input plugin gathers the statistics data from MySQL servers.

The NATS Consumer input plugin reads from specified NATS subjects and adds messages to InfluxDB. Messages are expected in the Telegraf input data formats. A Queue Group is used when subscribing to subjects so multiple instances of Telegraf can read from a NATS cluster in parallel.

The NATS Server Monitoring input plugin gathers metrics when using the NATS Server monitoring server.

The Neptune Apex input plugin collects real-time data from the Apex status.xml page. The Neptune Apex controller family allows an aquarium hobbyist to monitor and 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.

The Net input plugin gathers metrics about network interface usage (Linux only).

The Netstat input plugin gathers TCP metrics such as established, time-wait and sockets counts by using lsof.

The Network Response input plugin tests UDP and TCP connection response time. It can also check response text.

The NGINX input plugin reads NGINX basic status information (ngx_http_stub_status_module).

The NGINX VTS input plugin gathers NGINX status using external virtual host traffic status module - https://github.com/vozlt/nginx-module-vts. This is an NGINX module that provides access to virtual host status information. It contains the current status such as servers, upstreams, caches. This is similar to the live activity monitoring of NGINX Plus. For module configuration details, see the NGINX VTS module documentation.

The NGINX Plus API input plugin gathers advanced status information for NGINX Plus servers.

The NSQ input plugin collects metrics from NSQD API endpoints.

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.

The Nstat input plugin collects network metrics from /proc/net/netstat, /proc/net/snmp, and /proc/net/snmp6 files.

The NTPq input plugin gets standard NTP query metrics, requires ntpq executable.

The NVIDIA SMI input plugin uses a query on the NVIDIA System Management Interface (nvidia-smi) binary to pull GPU stats including memory and GPU usage, temp and other.

The OpenLDAP input plugin gathers metrics from OpenLDAP’s cn=Monitor backend.

The OpenNTPD input plugin gathers standard Network Time Protocol (NTP) query metrics from OpenNTPD using the ntpctl command.

The OpenSMTPD input plugin gathers stats from OpenSMTPD, a free implementation of the server-side SMTP protocol.

Collect current weather and forecast data from OpenWeatherMap.

The PF input plugin gathers information from the FreeBSD/OpenBSD pf firewall. 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.

The PgBouncer input plugin provides metrics for your PgBouncer load balancer. For information about the metrics, see the PgBouncer documentation.

The Phfusion 0Passenger input plugin gets Phusion Passenger statistics using their command line utility passenger-status.

The PHP-FPM input plugin gets phpfpm statistics using either HTTP status page or fpm socket.

The Ping input plugin measures the round-trip for ping commands, response time, and other packet statistics.

The Postfix input plugin reports metrics on the postfix queues. For each of the active, hold, incoming, maildrop, and deferred queues, it will report the queue length (number of items), size (bytes used by items), and age (age of oldest item in seconds).

The PostgreSQL input plugin provides metrics for your PostgreSQL database. 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.

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.

The PowerDNS input plugin gathers metrics about PowerDNS using UNIX sockets.

The PowerDNS Recursor input plugin gathers metrics about PowerDNS Recursor using UNIX sockets.

The Processes input plugin gathers info about the total number of processes 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.

The Prometheus Format input plugin input plugin gathers metrics from HTTP servers exposing metrics in Prometheus format.

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

The RabbitMQ input plugin reads metrics from RabbitMQ servers via the Management Plugin.

The Raindrops Middleware input plugin reads from the specified Raindrops middleware URI and adds the statistics to InfluxDB.

The RethinkDB input plugin works with RethinkDB 2.3.5+ databases that requires username, password authorization, and Handshake protocol v1.0.

The Riak input plugin gathers metrics from one or more Riak instances.

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.

The Sensors input plugin collects collects sensor metrics with the sensors executable from the lm-sensor package.

The SMART input plugin gets metrics using the command line utility smartctl for SMART (Self-Monitoring, Analysis and Reporting Technology) storage devices. SMART is a monitoring system included in computer hard disk drives (HDDs) and solid-state drives (SSDs), which include most modern ATA/SATA, SCSI/SAS and NVMe disks. The plugin detects and reports on various indicators of drive reliability, with the intent of enabling the anticipation of hardware failures. See smartmontools.

The SNMP input plugin gathers metrics from SNMP agents.

The SNMP Trap plugin receives SNMP notifications (traps and inform requests). Notifications are received over UDP on a configurable port. Resolve OIDs to strings using system MIB files (just like with the SNMP input plugin).

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.

The StatsD input plugin is a special type of plugin which runs a backgrounded statsd listener service while Telegraf is running. StatsD messages are formatted as described in the original etsy statsd implementation.

The Suricata input plugin reports internal performance counters of the Suricata IDS/IPS engine, such as captured traffic volume, memory usage, uptime, flow counters, and more. It provides a socket for the Suricata log output to write JSON output to and processes the incoming data to fit Telegraf’s format.

The Swap input plugin gathers metrics about swap memory usage. For more information about Linux swap spaces, see All about Linux swap space

The Synproxy plugin gathers synproxy metrics. Synproxy is a Linux netfilter module used for SYN attack mitigation.

The Syslog input plugin listens for syslog messages transmitted over UDP or TCP. Syslog messages should be formatted according to RFC 5424.

The Sysstat input plugin collects sysstat system metrics with the sysstat collector utility sadc and parses the created binary data file with the sadf utility.

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.

The Tail input plugin “tails” a log file and parses each log message.

The Teamspeak 3 input plugin uses the Teamspeak 3 ServerQuery interface of the Teamspeak server to collect statistics of one or more virtual servers.

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.

The Temp input plugin collects temperature data from sensors.

The Tengine Web Server input plugin gathers status metrics from the Tengine Web Server using the Reqstat module.

The Trig input plugin inserts sine and cosine waves for demonstration purposes.

The Twemproxy input plugin gathers data from Twemproxy instances, processes Twemproxy server statistics, processes pool data, and processes backend server (Redis/Memcached) statistics.

The Unbound input plugin gathers statistics from Unbound, a validating, recursive, and caching DNS resolver.

The uWSGI input plugin gathers metrics about uWSGI using the uWSGI Stats Server.

The Varnish input plugin gathers stats from Varnish HTTP Cache.

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

The Windows Performance Counters input plugin reads Performance Counters on the Windows operating sytem. Windows only.

The Windows Services input plugin reports Windows services info. Windows only.

The Wireless input plugin gathers metrics about wireless link quality by reading the /proc/net/wireless file. This plugin currently supports Linux only.

The X.509 Certificate input plugin provides information about X.509 certificate accessible using the local file or network connection.

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.