telegraf/CHANGELOG.md

120 KiB

v1.6 [unreleased]

Release Notes

  • The mysql input plugin has been updated fix a number of type convertion issues. This may cause a field type error when inserting into InfluxDB due the change of types.

    To address this we have introduced a new metric_version option to control enabling the new format. For in depth recommendations on upgrading please reference the mysql plugin documentation.

    It is encouraged to migrate to the new model when possible as the old version is deprecated and will be removed in a future version.

  • The postgresql plugins now defaults to using a persistent connection to the database. In environments where TCP connections are terminated the max_lifetime setting should be set less than the collection interval to prevent errors.

  • The sqlserver input plugin has a new query and data model that can be enabled by setting query_version = 2. It is encouraged to migrate to the new model when possible as the old version is deprecated and will be removed in a future version.

  • An option has been added to the openldap input plugin that reverses metric name to improve grouping. This change is enabled when reverse_metric_names = true is set. It is encouraged to enable this option when possible as the old ordering is deprecated.

  • The new http input configured with data_format = "json" can perform the same task as the, now deprecated, httpjson input.

New Inputs

  • http - Thanks to @grange74
  • ipset - Thanks to @sajoupa
  • nats - Thanks to @mjs & @levex

New Processors

  • override - Thanks to @KarstenSchnitter

New Parsers

Features

  • #3551: Add health status mapping from string to int in elasticsearch input.
  • #3580: Add control over which stats to gather in basicstats aggregator.
  • #3596: Add messages_delivered_get to rabbitmq input.
  • #3632: Add wired field to mem input.
  • #3619: Add support for gathering exchange metrics to the rabbitmq input.
  • #3565: Add support for additional metrics on Linux in zfs input.
  • #3524: Add available_entropy field to kernel input plugin.
  • #3643: Add user privilege level setting to IPMI sensors.
  • #2701: Use persistent connection to postgresql database.
  • #2846: Add support for dropwizard input format.
  • #3666: Add container health metrics to docker input.
  • #3687: Add support for using globs in devices list of diskio input plugin.
  • #2754: Allow running as console application on Windows.
  • #3703: Add listener counts and node running status to rabbitmq input.
  • #3674: Add NATS Monitoring Input Plugin.
  • #3702: Add ability to select which queues will be gathered in rabbitmq input.
  • #3726: Add support for setting bsd source address to the ping input.
  • #3346: Add Ipset input plugin.
  • #3719: Add TLS and HTTP basic auth to prometheus_client output.
  • #3618: Add new sqlserver output data model.
  • #3559: Add native Go method for finding pids to procstat.
  • #3722: Add additional metrics and reverse metric names option to openldap.
  • #3769: Add TLS support to the mesos input plugin.
  • #3546: Add http input plugin.
  • #3781: Add keep alive support to the TCP mode of statsd.
  • #3783: Support deadline in ping plugin.
  • #3765: Add option to disable labels in prometheus output for string fields.
  • #3808: Add shard server stats to the mongodb input plugin.
  • #3713: Add server option to unbound plugin.
  • #3804: Convert boolean metric values to float in datadog output.
  • #3799: Add Solr 3 compatibility.
  • #3797: Add sum stat to basicstats aggregator.
  • #3626: Add ability to override proxy from environment in http response.
  • #3853: Add host to ping timeout log message.
  • #3773: Add override processor.
  • #3814: Add status_code and result tags and result_type field to http_response input.
  • #3880: Added config flag to skip collection of network protocol metrics.
  • #3927: Add TLS support to kapacitor input.
  • #3496: Add HTTP basic auth support to the http_listener input.
  • #3452: Tags in output InfluxDB Line Protocol are now sorted.
  • #3631: InfluxDB Line Protocol parser now accepts DOS line endings.
  • #2496: An option has been added to skip database creation in the InfluxDB output.
  • #3366: Add support for connecting to InfluxDB over a unix domain socket.
  • #3946: Add optional unsigned integer support to the influx data format.
  • #3811: Add TLS support to zookeeper input.
  • #2737: Add filters for container state to docker input.

Bugfixes

  • #1896: Fix various mysql data type conversions.
  • #3810: Fix metric buffer limit in internal plugin after reload.
  • #3801: Fix panic in http_response on invalid regex.
  • #3973: Fix socket_listener setting ReadBufferSize on tcp sockets.
  • #1575: Add tag for target url to phpfpm input.
  • #3868: Fix cannot unmarshal object error in DC/OS input.
  • #3648: Fix InfluxDB output not able to reconnect when server address changes.
  • #3957: Fix parsing of dos line endings in the smart input.
  • #3754: Fix precision truncation when no timestamp included.
  • #3655: Fix SNMPv3 connection with Cisco ASA 5515 in snmp input.

v1.5.3 [2018-03-14]

Bugfixes

  • #3729: Set path to / if HOST_MOUNT_PREFIX matches full path.
  • #3739: Remove userinfo from url tag in prometheus input.
  • #3778: Fix ping plugin not reporting zero durations.
  • #3697: Disable keepalive in mqtt output to prevent deadlock.
  • #3786: Fix collation difference in sqlserver input.
  • #3871: Fix uptime metric in passenger input plugin.
  • #3851: Add output of stderr in case of error to exec log message.

v1.5.2 [2018-01-30]

Bugfixes

  • #3684: Ignore empty lines in Graphite plaintext.
  • #3604: Fix index out of bounds error in solr input plugin.
  • #3680: Reconnect before sending graphite metrics if disconnected.
  • #3693: Align aggregator period with internal ticker to avoid skipping metrics.
  • #3629: Fix a potential deadlock when using aggregators.
  • #3697: Limit wait time for writes in mqtt output.
  • #3698: Revert change in graphite output where dot in field key was replaced by underscore.
  • #3710: Add timeout to wavefront output write.
  • #3725: Exclude master_replid fields from redis input.

v1.5.1 [2018-01-10]

Bugfixes

  • #3624: Fix name error in jolokia2_agent sample config.
  • #3625: Fix DC/OS login expiration time.
  • #3593: Set Content-Type charset in influxdb output and allow it be overridden.
  • #3594: Document permissions setup for postfix input.
  • #3633: Fix deliver_get field in rabbitmq input.
  • #3607: Escape environment variables during config toml parsing.

v1.5 [2017-12-14]

New Plugins

Release Notes

  • In the kinesis output, use of the partition_key and use_random_partitionkey options has been deprecated in favor of the partition subtable. This allows for more flexible methods to set the partition key such as by metric name or by tag.

  • With the release of the new improved jolokia2 input, the legacy jolokia plugin is deprecated and will be removed in a future release. Users of this plugin are encouraged to update to the new jolokia2 plugin.

  • In the postgresql and postgresql_extensible plugins, the type of the oid data type has changed from string to integer. It is recommended to drop affected fields until a new shard is started. For details on how to workaround this issue please see #3622.

Features

  • #3170: Add support for sharding based on metric name.
  • #3196: Add Kafka output plugin topic_suffix option.
  • #3027: Include mount mode option in disk metrics.
  • #3191: TLS and MTLS enhancements to HTTPListener input plugin.
  • #3213: Add polling method to logparser and tail inputs.
  • #3211: Add timeout option for kubernetes input.
  • #3234: Add support for timing sums in statsd input.
  • #2617: Add resource limit monitoring to procstat.
  • #3236: Add support for k8s service DNS discovery to prometheus input.
  • #3245: Add configurable metrics endpoint to prometheus output.
  • #3214: Add new nginx_plus input plugin.
  • #3215: Add support for NSQLookupd to nsq_consumer.
  • #2278: Add redesigned Jolokia input plugin.
  • #3106: Add configurable separator for metrics and fields in opentsdb output.
  • #1692: Add support for the rollbar occurrence webhook event.
  • #3160: Add Wavefront output plugin.
  • #3281: Add extra wired tiger cache metrics to mongodb input.
  • #3141: Collect Docker Swarm service metrics in docker input plugin.
  • #2449: Add smart input plugin for collecting S.M.A.R.T. data.
  • #3269: Add cluster health level configuration to elasticsearch input.
  • #3304: Add ability to limit node stats in elasticsearch input.
  • #2167: Add new basicstats aggregator.
  • #3344: Add UDP IPv6 support to statsd input.
  • #3350: Use labels in prometheus output for string fields.
  • #3358: Add support for decimal timestamps to ts-epoch modifier.
  • #3337: Add histogram and summary types and use in prometheus plugins.
  • #3365: Gather concurrently from snmp agents.
  • #3333: Perform DNS lookup before ping and report result.
  • #3398: Add instance name option to varnish plugin.
  • #3406: Add support for SSL settings to ElasticSearch output plugin.
  • #3315: Add Teamspeak 3 input plugin.
  • #3305: Add modification_time field to filestat input plugin.
  • #2019: Add Solr input plugin.
  • #3210: Add CrateDB output plugin.
  • #3459: Add systemd unit pid and cgroup matching to procstat.
  • #3477: Add Particle Webhook Plugin.
  • #3471: Use MAX() instead of SUM() for latency measurements in sqlserver.
  • #3490: Add index by week number to Elasticsearch output.
  • #3434: Add unbound input plugin.
  • #3449: Add opensmtpd input plugin.
  • #3470: Add support for tags in the index name in elasticsearch output.
  • #2553: Add postfix input plugin.
  • #3424: Add bond input plugin.
  • #3518: Add slab to mem plugin.
  • #3519: Add input plugin for DC/OS.
  • #3140: Add support for glob patterns in net input plugin.
  • #3405: Add input plugin for OpenBSD/FreeBSD pf.
  • #3528: Add option to amqp output to publish persistent messages.
  • #3530: Support I (idle) process state on procfs+Linux.

Bugfixes

  • #3136: Fix webhooks input address in use during reload.
  • #3258: Unlock Statsd when stopping to prevent deadlock.
  • #3319: Fix cloudwatch output requires unneeded permissions.
  • #3351: Fix prometheus passthrough for existing value types.
  • #3430: Always ignore autofs filesystems in disk input.
  • #3326: Fail metrics parsing on unescaped quotes.
  • #3473: Whitelist allowed char classes for graphite output.
  • #3488: Use hexadecimal ids and lowercase names in zipkin input.
  • #3263: Fix snmp-tools output parsing with Windows EOLs.
  • #3447: Add shadow-utils dependency to rpm package.
  • #3448: Use deb-systemd-invoke to restart service.
  • #3553: Fix kafka_consumer outside range of offsets error.
  • #3568: Fix separation of multiple prometheus_client outputs.
  • #3577: Don't add system input uptime_format as a counter.

v1.4.5 [2017-12-01]

Bugfixes

  • #3500: Fix global variable collection when using interval_slow option in mysql input.
  • #3486: Fix error getting net connections info in netstat input.
  • #3529: Fix HOST_MOUNT_PREFIX in docker with disk input.

v1.4.4 [2017-11-08]

Bugfixes

  • #3401: Use schema specified in mqtt_consumer input.
  • #3419: Redact datadog API key in log output.
  • #3311: Fix error getting pids in netstat input.
  • #3339: Support HOST_VAR envvar to locate /var in system input.
  • #3383: Use current time if docker container read time is zero value.

v1.4.3 [2017-10-25]

Bugfixes

  • #3327: Fix container name filters in docker input.
  • #3321: Fix snmpwalk address format in leofs input.
  • #3329: Fix case sensitivity issue in sqlserver query.
  • #3342: Fix CPU input plugin stuck after suspend on Linux.
  • #3013: Fix mongodb input panic when restarting mongodb.
  • #3224: Preserve url path prefix in influx output.
  • #3354: Fix TELEGRAF_OPTS expansion in systemd service unit.
  • #3357: Remove warning when JSON contains null value.
  • #3375: Fix ACL token usage in consul input plugin.
  • #3369: Fix unquoting error with Tomcat 6.
  • #3373: Fix syscall panic in diskio on some Linux systems.

v1.4.2 [2017-10-10]

Bugfixes

  • #3259: Fix error if int larger than 32-bit in /proc/vmstat.
  • #3265: Fix parsing of JSON with a UTF8 BOM in httpjson.
  • #2887: Allow JSON data format to contain zero metrics.
  • #3284: Fix format of connection_timeout in mqtt_consumer.
  • #3081: Fix case sensitivity error in sqlserver input.
  • #3297: Add support for proxy environment variables to http_response.
  • #1588: Add support for standard proxy env vars in outputs.
  • #3282: Fix panic in cpu input if number of cpus changes.
  • #2854: Use chunked transfer encoding in InfluxDB output.

v1.4.1 [2017-09-26]

Bugfixes

  • #3167: Fix MQTT input exits if Broker is not available on startup.
  • #3217: Fix optional field value conversions in fluentd input.
  • #3227: Whitelist allowed char classes for opentsdb output.
  • #3232: Fix counter and gauge metric types.
  • #3235: Fix skipped line with empty target in iptables.
  • #3175: Fix duplicate keys in perf counters sqlserver query.
  • #3230: Fix panic in statsd p100 calculation.
  • #3242: Fix arm64 packages contain 32-bit executable.

v1.4 [2017-09-05]

Release Notes

  • The kafka_consumer input has been updated to support Kafka 0.9 and above style consumer offset handling. The previous version of this plugin supporting Kafka 0.8 and below is available as the kafka_consumer_legacy plugin.

  • In the aerospike input the node_name field has been changed to be a tag for both the aerospike_node and aerospike_namespace measurements.

  • The default prometheus_client port has been changed to 9273.

New Plugins

Features

  • #2487: Add Kafka 0.9+ consumer support
  • #2773: Add support for self-signed certs to InfluxDB input plugin
  • #2293: Add TCP listener for statsd input
  • #2581: Add Docker container environment variables as tags. Only whitelisted
  • #2817: Add timeout option to IPMI sensor plugin
  • #2883: Add support for an optional SSL/TLS configuration to nginx input plugin
  • #2882: Add timezone support for logparser timestamps.
  • #2814: Add result_type field for http_response input.
  • #2734: Add include/exclude filters for docker containers.
  • #2602: Add secure connection support to graphite output.
  • #2908: Add min/max response time on linux/darwin to ping.
  • #2929: Add HTTP Proxy support to influxdb output.
  • #2933: Add standard SSL options to mysql input.
  • #2875: Add input plugin for fail2ban.
  • #2924: Support HOST_PROC in processes and linux_sysctl_fs inputs.
  • #2960: Add Minecraft input plugin.
  • #2963: Add support for RethinkDB 1.0 handshake protocol.
  • #2943: Add optional usage_active and time_active CPU metrics.
  • #2973: Change default prometheus_client port.
  • #2661: Add fluentd input plugin.
  • #2990: Add result_type field to net_response input plugin.
  • #2571: Add read timeout to socket_listener
  • #2612: Add input plugin for OpenLDAP.
  • #3042: Add network option to dns_query.
  • #3054: Add redis_version field to redis input.
  • #3063: Add tls options to docker input.
  • #2387: Add histogram aggregator plugin.
  • #3080: Add zipkin input plugin.
  • #3023: Add Windows Services input plugin.
  • #3098: Add path tag to logparser containing path of logfile.
  • #3075: Add salesforce input plugin.
  • #3097: Add option to run varnish under sudo.
  • #3119: Add weighted_io_time to diskio input.
  • #2978: Add gzip content-encoding support to influxdb output.
  • #3127: Allow using system plugin in Windows.
  • #3112: Add tomcat input plugin.
  • #3182: HTTP headers can be added to InfluxDB output.

Bugfixes

  • #2607: Improve logging of errors in Cassandra input.
  • #2819: [enh] set db_version at 0 if query version fails
  • #2749: Fixed sqlserver input to work with case sensitive server collation.
  • #2716: Systemd does not see all shutdowns as failures
  • #2782: Reuse transports in input plugins
  • #2815: Inputs processes fails with "no such process".
  • #1137: Fix multiple plugin loading in win_perf_counters.
  • #2855: MySQL input: log and continue on field parse error.
  • #2885: Fix timeout option in Windows ping input sample configuration.
  • #2911: Fix Kinesis output plugin in govcloud.
  • #2917: Fix Aerospike input adds all nodes to a single series.
  • #2452: Improve Prometheus Client output documentation.
  • #2984: Display error message if prometheus output fails to listen.
  • #2997: Fix elasticsearch output content type detection warning.
  • #2914: Prevent possible deadlock when using aggregators.
  • #2860: Fix combined tagdrop/tagpass filtering.
  • #3036: Fix filtering when both pass and drop match an item.
  • #2964: Only report cpu usage for online cpus in docker input.
  • #3050: Start first aggregator period at startup time.
  • #2906: Fix panic in logparser if file cannot be opened.
  • #2886: Default to localhost if zookeeper has no servers set.
  • #2457: Fix docker memory and cpu reporting in Windows.
  • #3058: Allow iptable entries with trailing text.
  • #1680: Sanitize password from couchbase metric.
  • #3104: Converge to typed value in prometheus output.
  • #2899: Skip compilcation of logparser and tail on solaris.
  • #2951: Discard logging from tail library.
  • #3126: Remove log message on ping timeout.
  • #3144: Don't retry points beyond retention policy.
  • #3015: Don't start Telegraf on install in Amazon Linux.
  • #3153: Enable hddtemp input on all platforms.
  • #3142: Escape backslash within string fields.
  • #3162: Fix parsing of SHM remotes in ntpq input
  • #3149: Don't fail parsing zpool stats if pool health is UNAVAIL on FreeBSD.
  • #2672: Fix NSQ input plugin when used with version 1.0.0-compat.
  • #2523: Added CloudWatch metric constraint validation.
  • #3179: Skip non-numerical values in graphite format.
  • #3187: Fix panic when handling string fields with escapes.

v1.3.5 [2017-07-26]

Bugfixes

  • #3049: Fix prometheus output cannot be reloaded.
  • #3037: Fix filestat reporting exists when cannot list directory.
  • #2386: Fix ntpq parse issue when using dns_lookup.
  • #2554: Fix panic when agent.interval = "0s".

v1.3.4 [2017-07-12]

Bugfixes

  • #3001: Fix handling of escape characters within fields.
  • #2988: Fix chrony plugin does not track system time offset.
  • #3004: Do not allow metrics with trailing slashes.
  • #3011: Prevent Write from being called concurrently.

v1.3.3 [2017-06-28]

Bugfixes

  • #2915: Allow dos line endings in tail and logparser.
  • #2937: Remove label value sanitization in prometheus output.
  • #2948: Fix bug parsing default timestamps with modified precision.
  • #2954: Fix panic in elasticsearch input if cannot determine master.

v1.3.2 [2017-06-14]

Bugfixes

  • #2862: Fix InfluxDB UDP metric splitting.
  • #2888: Fix mongodb/leofs urls without scheme.
  • #2822: Fix inconsistent label dimensions in prometheus output.

v1.3.1 [2017-05-31]

Bugfixes

  • #2749: Fixed sqlserver input to work with case sensitive server collation.
  • #2782: Reuse transports in input plugins
  • #2815: Inputs processes fails with "no such process".
  • #2851: Fix InfluxDB output database quoting.
  • #2856: Fix net input on older Linux kernels.
  • #2848: Fix panic in mongo input.
  • #2869: Fix length calculation of split metric buffer.

v1.3 [2017-05-15]

Release Notes

  • Users of the windows ping plugin will need to drop or migrate their measurements in order to continue using the plugin. The reason for this is that the windows plugin was outputting a different type than the linux plugin. This made it impossible to use the ping plugin for both windows and linux machines.

  • Ceph: the ceph_pgmap_state metric content has been modified to use a unique field count, with each state expressed as a state tag.

Telegraf < 1.3:

# field_name             value
active+clean             123
active+clean+scrubbing   3

Telegraf >= 1.3:

# field_name    value       tag
count           123         state=active+clean
count           3           state=active+clean+scrubbing
  • The Riemann output plugin has been rewritten and the previous riemann plugin is incompatible with the new one. The reasons for this are outlined in issue #1878. The previous riemann output will still be available using outputs.riemann_legacy if needed, but that will eventually be deprecated. It is highly recommended that all users migrate to the new riemann output plugin.

  • Generic socket_listener and socket_writer plugins have been implemented for receiving and sending UDP, TCP, unix, & unix-datagram data. These plugins will replace udp_listener and tcp_listener, which are still available but will be deprecated eventually.

Features

  • #2721: Added SASL options for kafka output plugin.
  • #2723: Added SSL configuration for input haproxy.
  • #2494: Add interrupts input plugin.
  • #2094: Add generic socket listener & writer.
  • #2204: Extend http_response to support searching for a substring in response. Return 1 if found, else 0.
  • #2137: Added userstats to mysql input plugin.
  • #2179: Added more InnoDB metric to MySQL plugin.
  • #2229: ceph_pgmap_state metric now uses a single field count, with PG state published as state tag.
  • #2251: InfluxDB output: use own client for improved through-put and less allocations.
  • #2330: Keep -config-directory when running as Windows service.
  • #1900: Riemann plugin rewrite.
  • #1453: diskio: add support for name templates and udev tags.
  • #2277: add integer metrics for Consul check health state.
  • #2201: Add lock option to the IPtables input plugin.
  • #2244: Support ipmi_sensor plugin querying local ipmi sensors.
  • #2339: Increment gather_errors for all errors emitted by inputs.
  • #2071: Use official docker SDK.
  • #1678: Add AMQP consumer input plugin
  • #2512: Added pprof tool.
  • #2501: Support DEAD(X) state in system input plugin.
  • #2522: Add support for mongodb client certificates.
  • #1948: Support adding SNMP table indexes as tags.
  • #2332: Add Elasticsearch 5.x output
  • #2587: Add json timestamp units configurability
  • #2597: Add support for Linux sysctl-fs metrics.
  • #2425: Support to include/exclude docker container labels as tags
  • #1667: dmcache input plugin
  • #2637: Add support for precision in http_listener
  • #2636: Add message_len_max option to kafka_consumer input
  • #1100: Add collectd parser
  • #1820: easier plugin testing without outputs
  • #2493: Check signature in the GitHub webhook plugin
  • #2038: Add papertrail support to webhooks
  • #2253: Change jolokia plugin to use bulk requests.
  • #2575 Add diskio input for Darwin
  • #2705: Kinesis output: add use_random_partitionkey option
  • #2635: add tcp keep-alive to socket_listener & socket_writer
  • #2031: Add Kapacitor input plugin
  • #2732: Use go 1.8.1
  • #2712: Documentation for rabbitmq input plugin
  • #2141: Logparser handles newly-created files.

Bugfixes

  • #2633: ipmi_sensor: allow @ symbol in password
  • #2077: SQL Server Input - Arithmetic overflow error converting numeric to data type int.
  • #2262: Flush jitter can inhibit metric collection.
  • #2318: haproxy input - Add missing fields.
  • #2287: Kubernetes input: Handle null startTime for stopped pods.
  • #2356: cpu input panic when /proc/stat is empty.
  • #2341: telegraf swallowing panics in --test mode.
  • #2358: Create pidfile with 644 permissions & defer file deletion.
  • #2360: Fixed install/remove of telegraf on non-systemd Debian/Ubuntu systems
  • #2282: Reloading telegraf freezes prometheus output.
  • #2390: Empty tag value causes error on InfluxDB output.
  • #2380: buffer_size field value is negative number from "internal" plugin.
  • #2414: Missing error handling in the MySQL plugin leads to segmentation violation.
  • #2462: Fix type conflict in windows ping plugin.
  • #2178: logparser: regexp with lookahead.
  • #2466: Telegraf can crash in LoadDirectory on 0600 files.
  • #2215: Iptables input: document better that rules without a comment are ignored.
  • #2483: Fix win_perf_counters capping values at 100.
  • #2498: Exporting Ipmi.Path to be set by config.
  • #2500: Remove warning if parse empty content
  • #2520: Update default value for Cloudwatch rate limit
  • #2513: create /etc/telegraf/telegraf.d directory in tarball.
  • #2541: Return error on unsupported serializer data format.
  • #1827: Fix Windows Performance Counters multi instance identifier
  • #2576: Add write timeout to Riemann output
  • #2596: fix timestamp parsing on prometheus plugin
  • #2610: Fix deadlock when output cannot write
  • #2410: Fix connection leak in postgresql.
  • #2628: Set default measurement name for snmp input.
  • #2649: Improve performance of diskio with many disks
  • #2671: The internal input plugin uses the wrong units for heap_objects
  • #2684: Fix ipmi_sensor config is shared between all plugin instances
  • #2450: Network statistics not collected when system has alias interfaces
  • #1911: Sysstat plugin needs LANG=C or similar locale
  • #2528: File output closes standard streams on reload.
  • #2603: AMQP output disconnect blocks all outputs
  • #2706: Improve documentation for redis input plugin

v1.2.1 [2017-02-01]

Bugfixes

  • #2317: Fix segfault on nil metrics with influxdb output.
  • #2324: Fix negative number handling.

Features

  • #2348: Go version 1.7.4 -> 1.7.5

v1.2 [2017-01-00]

Release Notes

  • The StatsD plugin will now default all "delete_" config options to "true". This will change te default behavior for users who were not specifying these parameters in their config file.

  • The StatsD plugin will also no longer save it's state on a service reload. Essentially we have reverted PR #887. The reason for this is that saving the state in a global variable is not thread-safe (see #1975 & #2102), and this creates issues if users want to define multiple instances of the statsd plugin. Saving state on reload may be considered in the future, but this would need to be implemented at a higher level and applied to all plugins, not just statsd.

Features

  • #2123: Fix improper calculation of CPU percentages
  • #1564: Use RFC3339 timestamps in log output.
  • #1997: Non-default HTTP timeouts for RabbitMQ plugin.
  • #2074: "discard" output plugin added, primarily for testing purposes.
  • #1965: The JSON parser can now parse an array of objects using the same configuration.
  • #1807: Option to use device name rather than path for reporting disk stats.
  • #1348: Telegraf "internal" plugin for collecting stats on itself.
  • #2127: Update Go version to 1.7.4.
  • #2126: Support a metric.Split function.
  • #2026: elasticsearch "shield" (basic auth) support doc.
  • #1885: Fix over-querying of cloudwatch metrics
  • #1913: OpenTSDB basic auth support.
  • #1908: RabbitMQ Connection metrics.
  • #1937: HAProxy session limit metric.
  • #2068: Accept strings for StatsD sets.
  • #1893: Change StatsD default "reset" behavior.
  • #2079: Enable setting ClientID in MQTT output.
  • #2001: MongoDB input plugin: Improve state data.
  • #2078: Ping input: add standard deviation field.
  • #2121: Add GC pause metric to InfluxDB input plugin.
  • #2006: Added response_timeout property to prometheus input plugin.
  • #1763: Pulling github.com/lxn/win's pdh wrapper into telegraf.
  • #1898: Support negative statsd counters.
  • #1921: Elasticsearch cluster stats support.
  • #1942: Change Amazon Kinesis output plugin to use the built-in serializer plugins.
  • #1980: Hide username/password from elasticsearch error log messages.
  • #2097: Configurable HTTP timeouts in Jolokia plugin
  • #2255: Allow changing jolokia attribute delimiter

Bugfixes

  • #2049: Fix the Value data format not trimming null characters from input.
  • #1949: Fix windows net plugin.
  • #1775: Cache & expire metrics for delivery to prometheus
  • #1775: Cache & expire metrics for delivery to prometheus.
  • #2146: Fix potential panic in aggregator plugin metric maker.
  • #1843 & #1668: Add optional ability to define PID as a tag.
  • #1730 & #2261: Fix win_perf_counters not gathering non-English counters.
  • #2061: Fix panic when file stat info cannot be collected due to permissions or other issue(s).
  • #2045: Graylog output should set short_message field.
  • #1904: Hddtemp always put the value in the field temperature.
  • #1693: Properly collect nested jolokia struct data.
  • #1917: fix puppetagent inputs plugin to support string for config variable.
  • #1987: fix docker input plugin tags when registry has port.
  • #2089: Fix tail input when reading from a pipe.
  • #1449: MongoDB plugin always shows 0 replication lag.
  • #1825: Consul plugin: add check_id as a tag in metrics to avoid overwrites.
  • #1973: Partial fix: logparser CLF pattern with IPv6 addresses.
  • #1975 & #2102: Fix thread-safety when using multiple instances of the statsd input plugin.
  • #2027: docker input: interface conversion panic fix.
  • #1814: snmp: ensure proper context is present on error messages.
  • #2299: opentsdb: add tcp:// prefix if no scheme provided.
  • #2297: influx parser: parse line-protocol without newlines.
  • #2245: influxdb output: fix field type conflict blocking output buffer.

v1.1.2 [2016-12-12]

Bugfixes

  • #2007: Make snmptranslate not required when using numeric OID.
  • #2104: Add a global snmp translation cache.

v1.1.1 [2016-11-14]

Bugfixes

  • #2023: Fix issue parsing toml durations with single quotes.

v1.1.0 [2016-11-07]

Release Notes

  • Telegraf now supports two new types of plugins: processors & aggregators.

  • On systemd Telegraf will no longer redirect it's stdout to /var/log/telegraf/telegraf.log. On most systems, the logs will be directed to the systemd journal and can be accessed by journalctl -u telegraf.service. Consult the systemd journal documentation for configuring journald. There is also a logfile config option available in 1.1, which will allow users to easily configure telegraf to continue sending logs to /var/log/telegraf/telegraf.log.

Features

  • #1726: Processor & Aggregator plugin support.
  • #1861: adding the tags in the graylog output plugin
  • #1732: Telegraf systemd service, log to journal.
  • #1782: Allow numeric and non-string values for tag_keys.
  • #1694: Adding Gauge and Counter metric types.
  • #1606: Remove carraige returns from exec plugin output on Windows
  • #1674: elasticsearch input: configurable timeout.
  • #1607: Massage metric names in Instrumental output plugin
  • #1572: mesos improvements.
  • #1513: Add Ceph Cluster Performance Statistics
  • #1650: Ability to configure response_timeout in httpjson input.
  • #1685: Add additional redis metrics.
  • #1539: Added capability to send metrics through Http API for OpenTSDB.
  • #1471: iptables input plugin.
  • #1542: Add filestack webhook plugin.
  • #1599: Add server hostname for each docker measurements.
  • #1697: Add NATS output plugin.
  • #1407 & #1915: HTTP service listener input plugin.
  • #1699: Add database blacklist option for Postgresql
  • #1791: Add Docker container state metrics to Docker input plugin output
  • #1755: Add support to SNMP for IP & MAC address conversion.
  • #1729: Add support to SNMP for OID index suffixes.
  • #1813: Change default arguments for SNMP plugin.
  • #1686: Mesos input plugin: very high-cardinality mesos-task metrics removed.
  • #1838: Logging overhaul to centralize the logger & log levels, & provide a logfile config option.
  • #1700: HAProxy plugin socket glob matching.
  • #1847: Add Kubernetes plugin for retrieving pod metrics.

Bugfixes

  • #1955: Fix NATS plug-ins reconnection logic.
  • #1936: Set required default values in udp_listener & tcp_listener.
  • #1926: Fix toml unmarshal panic in Duration objects.
  • #1746: Fix handling of non-string values for JSON keys listed in tag_keys.
  • #1628: Fix mongodb input panic on version 2.2.
  • #1733: Fix statsd scientific notation parsing
  • #1716: Sensors plugin strconv.ParseFloat: parsing "": invalid syntax
  • #1530: Fix prometheus_client reload panic
  • #1764: Fix kafka consumer panic when nil error is returned down errs channel.
  • #1768: Speed up statsd parsing.
  • #1751: Fix powerdns integer parse error handling.
  • #1752: Fix varnish plugin defaults not being used.
  • #1517: Fix windows glob paths.
  • #1137: Fix issue loading config directory on windows.
  • #1772: Windows remote management interactive service fix.
  • #1702: sqlserver, fix issue when case sensitive collation is activated.
  • #1823: Fix huge allocations in http_listener when dealing with huge payloads.
  • #1833: Fix translating SNMP fields not in MIB.
  • #1835: Fix SNMP emitting empty fields.
  • #1854: SQL Server waitstats truncation bug.
  • #1810: Fix logparser common log format: numbers in ident.
  • #1793: Fix JSON Serialization in OpenTSDB output.
  • #1731: Fix Graphite template ordering, use most specific.
  • #1836: Fix snmp table field initialization for non-automatic table.
  • #1724: cgroups path being parsed as metric.
  • #1886: Fix phpfpm fcgi client panic when URL does not exist.
  • #1344: Fix config file parse error logging.
  • #1771: Delete nil fields in the metric maker.
  • #870: Fix MySQL special characters in DSN parsing.
  • #1742: Ping input odd timeout behavior.
  • #1950: Switch to github.com/kballard/go-shellquote.

v1.0.1 [2016-09-26]

Bugfixes

  • #1775: Prometheus output: Fix bug with multi-batch writes.
  • #1738: Fix unmarshal of influxdb metrics with null tags.
  • #1773: Add configurable timeout to influxdb input plugin.
  • #1785: Fix statsd no default value panic.

v1.0 [2016-09-08]

Release Notes

Breaking Change The SNMP plugin is being deprecated in it's current form. There is a new SNMP plugin which fixes many of the issues and confusions of its predecessor. For users wanting to continue to use the deprecated SNMP plugin, you will need to change your config file from [[inputs.snmp]] to [[inputs.snmp_legacy]]. The configuration of the new SNMP plugin is not backwards-compatible.

Breaking Change: Aerospike main server node measurements have been renamed aerospike_node. Aerospike namespace measurements have been renamed to aerospike_namespace. They will also now be tagged with the node_name that they correspond to. This has been done to differentiate measurements that pertain to node vs. namespace statistics.

Breaking Change: users of github_webhooks must change to the new [[inputs.webhooks]] plugin.

This means that the default github_webhooks config:

# A Github Webhook Event collector
[[inputs.github_webhooks]]
  ## Address and port to host Webhook listener on
  service_address = ":1618"

should now look like:

# A Webhooks Event collector
[[inputs.webhooks]]
  ## Address and port to host Webhook listener on
  service_address = ":1618"

  [inputs.webhooks.github]
    path = "/"
  • Telegraf now supports being installed as an official windows service, which can be installed via > C:\Program Files\Telegraf\telegraf.exe --service install

  • flush_jitter behavior has been changed. The random jitter will now be evaluated at every flush interval, rather than once at startup. This makes it consistent with the behavior of collection_jitter.

  • postgresql plugins now handle oid and name typed columns seamlessly, previously they were ignored/skipped.

Features

  • #1617: postgresql_extensible now handles name and oid types correctly.
  • #1413: Separate container_version from container_image tag.
  • #1525: Support setting per-device and total metrics for Docker network and blockio.
  • #1466: MongoDB input plugin: adding per DB stats from db.stats()
  • #1503: Add tls support for certs to RabbitMQ input plugin
  • #1289: webhooks input plugin. Thanks @francois2metz and @cduez!
  • #1247: rollbar webhook plugin.
  • #1408: mandrill webhook plugin.
  • #1402: docker-machine/boot2docker no longer required for unit tests.
  • #1350: cgroup input plugin.
  • #1369: Add input plugin for consuming metrics from NSQD.
  • #1369: add ability to read redis from a socket.
  • #1387: Breaking Change - Redis role tag renamed to replication_role to avoid global_tags override
  • #1437: Fetching Galera status metrics in MySQL
  • #1500: Aerospike plugin refactored to use official client lib.
  • #1434: Add measurement name arg to logparser plugin.
  • #1479: logparser: change resp_code from a field to a tag.
  • #1411: Implement support for fetching hddtemp data
  • #1340: statsd: do not log every dropped metric.
  • #1368: Add precision rounding to all metrics on collection.
  • #1390: Add support for Tengine
  • #1320: Logparser input plugin for parsing grok-style log patterns.
  • #1397: ElasticSearch: now supports connecting to ElasticSearch via SSL
  • #1262: Add graylog input pluging.
  • #1294: consul input plugin. Thanks @harnash
  • #1164: conntrack input plugin. Thanks @robinpercy!
  • #1165: vmstat input plugin. Thanks @jshim-xm!
  • #1208: Standardized AWS credentials evaluation & wildcard CloudWatch dimensions. Thanks @johnrengelman!
  • #1264: Add SSL config options to http_response plugin.
  • #1272: graphite parser: add ability to specify multiple tag keys, for consistency with influxdb parser.
  • #1265: Make dns lookups for chrony configurable. Thanks @zbindenren!
  • #1275: Allow wildcard filtering of varnish stats.
  • #1142: Support for glob patterns in exec plugin commands configuration.
  • #1278: RabbitMQ input: made url parameter optional by using DefaultURL (http://localhost:15672) if not specified
  • #1197: Limit AWS GetMetricStatistics requests to 10 per second.
  • #1278 & #1288 & #1295: RabbitMQ/Apache/InfluxDB inputs: made url(s) parameter optional by using reasonable input defaults if not specified
  • #1296: Refactor of flush_jitter argument.
  • #1213: Add inactive & active memory to mem plugin.
  • #1543: Official Windows service.
  • #1414: Forking sensors command to remove C package dependency.
  • #1389: Add a new SNMP plugin.

Bugfixes

  • #1619: Fix make windows build target
  • #1519: Fix error race conditions and partial failures.
  • #1477: nstat: fix inaccurate config panic.
  • #1481: jolokia: fix handling multiple multi-dimensional attributes.
  • #1430: Fix prometheus character sanitizing. Sanitize more win_perf_counters characters.
  • #1534: Add diskio io_time to FreeBSD & report timing metrics as ms (as linux does).
  • #1379: Fix covering Amazon Linux for post remove flow.
  • #1584: procstat missing fields: read/write bytes & count
  • #1472: diskio input plugin: set 'skip_serial_number = true' by default to avoid high cardinality.
  • #1426: nil metrics panic fix.
  • #1384: Fix datarace in apache input plugin.
  • #1399: Add read_repairs statistics to riak plugin.
  • #1405: Fix memory/connection leak in prometheus input plugin.
  • #1378: Trim BOM from config file for Windows support.
  • #1339: Prometheus client output panic on service reload.
  • #1461: Prometheus parser, protobuf format header fix.
  • #1334: Prometheus output, metric refresh and caching fixes.
  • #1432: Panic fix for multiple graphite outputs under very high load.
  • #1412: Instrumental output has better reconnect behavior
  • #1460: Remove PID from procstat plugin to fix cardinality issues.
  • #1427: Cassandra input: version 2.x "column family" fix.
  • #1463: Shared WaitGroup in Exec plugin
  • #1436: logparser: honor modifiers in "pattern" config.
  • #1418: logparser: error and exit on file permissions/missing errors.
  • #1499: Make the user able to specify full path for HAproxy stats
  • #1521: Fix Redis url, an extra "tcp://" was added.
  • #1330: Fix exec plugin panic when using single binary.
  • #1336: Fixed incorrect prometheus metrics source selection.
  • #1112: Set default Zookeeper chroot to empty string.
  • #1335: Fix overall ping timeout to be calculated based on per-ping timeout.
  • #1374: Change "default" retention policy to "".
  • #1377: Graphite output mangling '%' character.
  • #1396: Prometheus input plugin now supports x509 certs authentication
  • #1252 & #1279: Fix systemd service. Thanks @zbindenren & @PierreF!
  • #1221: Fix influxdb n_shards counter.
  • #1258: Fix potential kernel plugin integer parse error.
  • #1268: Fix potential influxdb input type assertion panic.
  • #1283: Still send processes metrics if a process exited during metric collection.
  • #1297: disk plugin panic when usage grab fails.
  • #1316: Removed leaked "database" tag on redis metrics. Thanks @PierreF!
  • #1323: Processes plugin: fix potential error with /proc/net/stat directory.
  • #1322: Fix rare RHEL 5.2 panic in gopsutil diskio gathering function.
  • #1586: Remove IF NOT EXISTS from influxdb output database creation.
  • #1600: Fix quoting with text values in postgresql_extensible plugin.
  • #1425: Fix win_perf_counter "index out of range" panic.
  • #1634: Fix ntpq panic when field is missing.
  • #1637: Sanitize graphite output field names.
  • #1695: Fix MySQL plugin not sending 0 value fields.

v0.13.1 [2016-05-24]

Release Notes

  • net_response and http_response plugins timeouts will now accept duration strings, ie, "2s" or "500ms".
  • Input plugin Gathers will no longer be logged by default, but a Gather for each plugin will be logged in Debug mode.
  • Debug mode will no longer print every point added to the accumulator. This functionality can be duplicated using the file output plugin and printing to "stdout".

Features

  • #1173: varnish input plugin. Thanks @sfox-xmatters!
  • #1138: nstat input plugin. Thanks @Maksadbek!
  • #1139: instrumental output plugin. Thanks @jasonroelofs!
  • #1172: Ceph storage stats. Thanks @robinpercy!
  • #1233: Updated golint gopsutil dependency.
  • #1238: chrony input plugin. Thanks @zbindenren!
  • #479: per-plugin execution time added to debug output.
  • #1249: influxdb output: added write_consistency argument.

Bugfixes

  • #1195: Docker panic on timeout. Thanks @zstyblik!
  • #1211: mongodb input. Fix possible panic. Thanks @kols!
  • #1215: Fix for possible gopsutil-dependent plugin hangs.
  • #1228: Fix service plugin host tag overwrite.
  • #1198: http_response: override request Host header properly
  • #1230: Fix Telegraf process hangup due to a single plugin hanging.
  • #1214: Use TCP timeout argument in net_response plugin.
  • #1243: Logfile not created on systemd.

v0.13 [2016-05-11]

Release Notes

  • Breaking change in jolokia plugin. See https://github.com/influxdata/telegraf/blob/master/plugins/inputs/jolokia/README.md for updated configuration. The plugin will now support proxy mode and will make POST requests.

  • New [agent] configuration option: metric_batch_size. This option tells telegraf the maximum batch size to allow to accumulate before sending a flush to the configured outputs. metric_buffer_limit now refers to the absolute maximum number of metrics that will accumulate before metrics are dropped.

  • There is no longer an option to flush_buffer_when_full, this is now the default and only behavior of telegraf.

  • Breaking Change: docker plugin tags. The cont_id tag no longer exists, it will now be a field, and be called container_id. Additionally, cont_image and cont_name are being renamed to container_image and container_name.

  • Breaking Change: docker plugin measurements. The docker_cpu, docker_mem, docker_blkio and docker_net measurements are being renamed to docker_container_cpu, docker_container_mem, docker_container_blkio and docker_container_net. Why? Because these metrics are specifically tracking per-container stats. The problem with per-container stats, in some use-cases, is that if containers are short-lived AND names are not kept consistent, then the series cardinality will balloon very quickly. So adding "container" to each metric will: (1) make it more clear that these metrics are per-container, and (2) allow users to easily drop per-container metrics if cardinality is an issue (namedrop = ["docker_container_*"])

  • tagexclude and taginclude are now available, which can be used to remove tags from measurements on inputs and outputs. See the configuration doc for more details.

  • Measurement filtering: All measurement filters now match based on glob only. Previously there was an undocumented behavior where filters would match based on prefix in addition to globs. This means that a filter like fielddrop = ["time_"] will need to be changed to fielddrop = ["time_*"]

  • datadog: measurement and field names will no longer have _ replaced by .

  • The following plugins have changed their tags to not overwrite the host tag:

    • cassandra: host -> cassandra_host
    • disque: host -> disque_host
    • rethinkdb: host -> rethinkdb_host
  • Breaking Change: The win_perf_counters input has been changed to sanitize field names, replacing /Sec and /sec with _persec, as well as spaces with underscores. This is needed because Graphite doesn't like slashes and spaces, and was failing to accept metrics that had them. The /[sS]ec -> _persec is just to make things clearer and uniform.

  • Breaking Change: snmp plugin. The host tag of the snmp plugin has been changed to the snmp_host tag.

  • The disk input plugin can now be configured with the HOST_MOUNT_PREFIX environment variable. This value is prepended to any mountpaths discovered before retrieving stats. It is not included on the report path. This is necessary for reporting host disk stats when running from within a container.

Features

  • #1031: Jolokia plugin proxy mode. Thanks @saiello!
  • #1017: taginclude and tagexclude arguments.
  • #1015: Docker plugin schema refactor.
  • #889: Improved MySQL plugin. Thanks @maksadbek!
  • #1060: TTL metrics added to MongoDB input plugin
  • #1056: Don't allow inputs to overwrite host tags.
  • #1035: Add user, exe, pidfile tags to procstat plugin.
  • #1041: Add n_cpus field to the system plugin.
  • #1072: New Input Plugin: filestat.
  • #1066: Replication lag metrics for MongoDB input plugin
  • #1086: Ability to specify AWS keys in config file. Thanks @johnrengleman!
  • #1096: Performance refactor of running output buffers.
  • #967: Buffer logging improvements.
  • #1107: Support lustre2 job stats. Thanks @hanleyja!
  • #1122: Support setting config path through env variable and default paths.
  • #1128: MongoDB jumbo chunks metric for MongoDB input plugin
  • #1146: HAProxy socket support. Thanks weshmashian!

Bugfixes

  • #1050: jolokia plugin - do not overwrite host tag. Thanks @saiello!
  • #921: mqtt_consumer stops gathering metrics. Thanks @chaton78!
  • #1013: Close dead riemann output connections. Thanks @echupriyanov!
  • #1012: Set default tags in test accumulator.
  • #1024: Don't replace . with _ in datadog output.
  • #1058: Fix possible leaky TCP connections in influxdb output.
  • #1044: Fix SNMP OID possible collisions. Thanks @relip
  • #1022: Dont error deb/rpm install on systemd errors.
  • #1078: Use default AWS credential chain.
  • #1070: SQL Server input. Fix datatype conversion.
  • #1089: Fix leaky TCP connections in phpfpm plugin.
  • #914: Telegraf can drop metrics on full buffers.
  • #1098: Sanitize invalid OpenTSDB characters.
  • #1110: Sanitize * to - in graphite serializer. Thanks @goodeggs!
  • #1118: Sanitize Counter names for win_perf_counters input.
  • #1125: Wrap all exec command runners with a timeout, so hung os processes don't halt Telegraf.
  • #1113: Set MaxRetry and RequiredAcks defaults in Kafka output.
  • #1090: [agent] and [global_tags] config sometimes not getting applied.
  • #1133: Use a timeout for docker list & stat cmds.
  • #1052: Docker panic fix when decode fails.
  • #1136: "DELAYED" Inserts were deprecated in MySQL 5.6.6. Thanks @PierreF

v0.12.1 [2016-04-14]

Release Notes

Features

  • #1009: Cassandra input plugin. Thanks @subhachandrachandra!
  • #976: Reduce allocations in the UDP and statsd inputs.
  • #979: Reduce allocations in the TCP listener.
  • #992: Refactor allocations in TCP/UDP listeners.
  • #935: AWS Cloudwatch input plugin. Thanks @joshhardy & @ljosa!
  • #943: http_response input plugin. Thanks @Lswith!
  • #939: sysstat input plugin. Thanks @zbindenren!
  • #998: breaking change enabled global, user and ip queries in dovecot plugin. Thanks @mikif70!
  • #1001: Graphite serializer templates.
  • #1008: Adding memstats metrics to the influxdb plugin.

Bugfixes

  • #968: Processes plugin gets unknown state when spaces are in (command name)
  • #969: ipmi_sensors: allow : in password. Thanks @awaw!
  • #972: dovecot: remove extra newline in dovecot command. Thanks @mrannanj!
  • #645: docker plugin i/o error on closed pipe. Thanks @tripledes!

v0.12.0 [2016-04-05]

Features

  • #951: Parse environment variables in the config file.
  • #948: Cleanup config file and make default package version include all plugins (but commented).
  • #927: Adds parsing of tags to the statsd input when using DataDog's dogstatsd extension
  • #863: AMQP output: allow external auth. Thanks @ekini!
  • #707: Improved prometheus plugin. Thanks @titilambert!
  • #878: Added json serializer. Thanks @ch3lo!
  • #880: Add the ability to specify the bearer token to the prometheus plugin. Thanks @jchauncey!
  • #882: Fixed SQL Server Plugin issues
  • #849: Adding ability to parse single values as an input data type.
  • #844: postgres_extensible plugin added. Thanks @menardorama!
  • #866: couchbase input plugin. Thanks @ljosa!
  • #789: Support multiple field specification and field* in graphite templates. Thanks @chrusty!
  • #762: Nagios parser for the exec plugin. Thanks @titilambert!
  • #848: Provide option to omit host tag from telegraf agent.
  • #928: Deprecating the statsd "convert_names" options, expose separator config.
  • #919: ipmi_sensor input plugin. Thanks @ebookbug!
  • #945: KAFKA output: codec, acks, and retry configuration. Thanks @framiere!

Bugfixes

  • #890: Create TLS config even if only ssl_ca is provided.
  • #884: Do not call write method if there are 0 metrics to write.
  • #898: Put database name in quotes, fixes special characters in the database name.
  • #656: No longer run lsof on linux to get netstat data, fixes permissions issue.
  • #907: Fix prometheus invalid label/measurement name key.
  • #841: Fix memcached unix socket panic.
  • #873: Fix SNMP plugin sometimes not returning metrics. Thanks @titiliambert!
  • #934: phpfpm: Fix fcgi uri path. Thanks @rudenkovk!
  • #805: Kafka consumer stops gathering after i/o timeout.
  • #959: reduce mongodb & prometheus collection timeouts. Thanks @PierreF!

v0.11.1 [2016-03-17]

Release Notes

  • Primarily this release was cut to fix #859

Features

  • #747: Start telegraf on install & remove on uninstall. Thanks @pierref!
  • #794: Add service reload ability. Thanks @entertainyou!

Bugfixes

  • #852: Windows zip package fix
  • #859: httpjson plugin panic

v0.11.0 [2016-03-15]

Release Notes

Features

  • #692: Support InfluxDB retention policies
  • #771: Default timeouts for input plugns. Thanks @PierreF!
  • #758: UDP Listener input plugin, thanks @whatyouhide!
  • #769: httpjson plugin: allow specifying SSL configuration.
  • #735: SNMP Table feature. Thanks @titilambert!
  • #754: docker plugin: adding docker info metrics to output. Thanks @titilambert!
  • #788: -input-list and -output-list command-line options. Thanks @ebookbug!
  • #778: Adding a TCP input listener.
  • #797: Provide option for persistent MQTT consumer client sessions.
  • #799: Add number of threads for procstat input plugin. Thanks @titilambert!
  • #776: Add Zookeeper chroot option to kafka_consumer. Thanks @prune998!
  • #811: Add processes plugin for classifying total procs on system. Thanks @titilambert!
  • #235: Add number of users to the system input plugin.
  • #826: "kernel" linux plugin for /proc/stat metrics (context switches, interrupts, etc.)
  • #847: ntpq: Input plugin for running ntp query executable and gathering metrics.

Bugfixes

  • #748: Fix sensor plugin split on ":"
  • #722: Librato output plugin fixes. Thanks @chrusty!
  • #745: Fix Telegraf toml parse panic on large config files. Thanks @titilambert!
  • #781: Fix mqtt_consumer username not being set. Thanks @chaton78!
  • #786: Fix mqtt output username not being set. Thanks @msangoi!
  • #773: Fix duplicate measurements in snmp plugin. Thanks @titilambert!
  • #708: packaging: build ARM package
  • #713: packaging: insecure permissions error on log directory
  • #816: Fix phpfpm panic if fcgi endpoint unreachable.
  • #828: fix net_response plugin overwriting host tag.
  • #821: Remove postgres password from server tag. Thanks @menardorama!

v0.10.4.1

Release Notes

  • Bug in the build script broke deb and rpm packages.

Bugfixes

  • #750: deb package broken
  • #752: rpm package broken

v0.10.4 [2016-02-24]

Release Notes

  • The pass/drop parameters have been renamed to fielddrop/fieldpass parameters, to more accurately indicate their purpose.
  • There are also now namedrop/namepass parameters for passing/dropping based on the metric name.
  • Experimental windows builds now available.

Features

  • #727: riak input, thanks @jcoene!
  • #694: DNS Query input, thanks @mjasion!
  • #724: username matching for procstat input, thanks @zorel!
  • #736: Ignore dummy filesystems from disk plugin. Thanks @PierreF!
  • #737: Support multiple fields for statsd input. Thanks @mattheath!

Bugfixes

  • #701: output write count shouldnt print in quiet mode.
  • #746: httpjson plugin: Fix HTTP GET parameters.

v0.10.3 [2016-02-18]

Release Notes

  • Users of the exec and kafka_consumer (and the new nats_consumer and mqtt_consumer plugins) can now specify the incoming data format that they would like to parse. Currently supports: "json", "influx", and "graphite"
  • Users of message broker and file output plugins can now choose what data format they would like to output. Currently supports: "influx" and "graphite"
  • More info on parsing incoming data formats can be found here
  • More info on serializing outgoing data formats can be found here
  • Telegraf now has an option flush_buffer_when_full that will flush the metric buffer whenever it fills up for each output, rather than dropping points and only flushing on a set time interval. This will default to true and is in the [agent] config section.

Features

  • #652: CouchDB Input Plugin. Thanks @codehate!
  • #655: Support parsing arbitrary data formats. Currently limited to kafka_consumer and exec inputs.
  • #671: Dovecot input plugin. Thanks @mikif70!
  • #680: NATS consumer input plugin. Thanks @netixen!
  • #676: MQTT consumer input plugin.
  • #683: PostGRES input plugin: add pg_stat_bgwriter. Thanks @menardorama!
  • #679: File/stdout output plugin.
  • #679: Support for arbitrary output data formats.
  • #695: raindrops input plugin. Thanks @burdandrei!
  • #650: net_response input plugin. Thanks @titilambert!
  • #699: Flush based on buffer size rather than time.
  • #682: Mesos input plugin. Thanks @tripledes!

Bugfixes

  • #443: Fix Ping command timeout parameter on Linux.
  • #662: Change [tags] to [global_tags] to fix multiple-plugin tags bug.
  • #642: Riemann output plugin issues.
  • #394: Support HTTP POST. Thanks @gabelev!
  • #715: Fix influxdb precision config panic. Thanks @netixen!

v0.10.2 [2016-02-04]

Release Notes

  • Statsd timing measurements are now aggregated into a single measurement with fields.
  • Graphite output now inserts tags into the bucket in alphabetical order.
  • Normalized TLS/SSL support for output plugins: MQTT, AMQP, Kafka
  • verify_ssl config option was removed from Kafka because it was actually doing the opposite of what it claimed to do (yikes). It's been replaced by insecure_skip_verify

Features

  • #575: Support for collecting Windows Performance Counters. Thanks @TheFlyingCorpse!
  • #564: features for plugin writing simplification. Internal metric data type.
  • #603: Aggregate statsd timing measurements into fields. Thanks @marcinbunsch!
  • #601: Warn when overwriting cached metrics.
  • #614: PowerDNS input plugin. Thanks @Kasen!
  • #617: exec plugin: parse influx line protocol in addition to JSON.
  • #628: Windows perf counters: pre-vista support

Bugfixes

  • #595: graphite output should include tags to separate duplicate measurements.
  • #599: datadog plugin tags not working.
  • #600: datadog measurement/field name parsing is wrong.
  • #602: Fix statsd field name templating.
  • #612: Docker input panic fix if stats received are nil.
  • #634: Properly set host headers in httpjson. Thanks @reginaldosousa!

v0.10.1 [2016-01-27]

Release Notes

  • Telegraf now keeps a fixed-length buffer of metrics per-output. This buffer defaults to 10,000 metrics, and is adjustable. The buffer is cleared when a successful write to that output occurs.
  • The docker plugin has been significantly overhauled to add more metrics and allow for docker-machine (incl OSX) support. See the readme for the latest measurements, fields, and tags. There is also now support for specifying a docker endpoint to get metrics from.

Features

  • #509: Flatten JSON arrays with indices. Thanks @psilva261!
  • #512: Python 3 build script, add lsof dep to package. Thanks @Ormod!
  • #475: Add response time to httpjson plugin. Thanks @titilambert!
  • #519: Added a sensors input based on lm-sensors. Thanks @md14454!
  • #467: Add option to disable statsd measurement name conversion.
  • #534: NSQ input plugin. Thanks @allingeek!
  • #494: Graphite output plugin. Thanks @titilambert!
  • AMQP SSL support. Thanks @ekini!
  • #539: Reload config on SIGHUP. Thanks @titilambert!
  • #522: Phusion passenger input plugin. Thanks @kureikain!
  • #541: Kafka output TLS cert support. Thanks @Ormod!
  • #551: Statsd UDP read packet size now defaults to 1500 bytes, and is configurable.
  • #552: Support for collection interval jittering.
  • #484: Include usage percent with procstat metrics.
  • #553: Amazon CloudWatch output. thanks @skwong2!
  • #503: Support docker endpoint configuration.
  • #563: Docker plugin overhaul.
  • #285: Fixed-size buffer of points.
  • #546: SNMP Input plugin. Thanks @titilambert!
  • #589: Microsoft SQL Server input plugin. Thanks @zensqlmonitor!
  • #573: Github webhooks consumer input. Thanks @jackzampolin!
  • #471: httpjson request headers. Thanks @asosso!

Bugfixes

  • #506: Ping input doesn't return response time metric when timeout. Thanks @titilambert!
  • #508: Fix prometheus cardinality issue with the net plugin
  • #499 & #502: php fpm unix socket and other fixes, thanks @kureikain!
  • #543: Statsd Packet size sometimes truncated.
  • #440: Don't query filtered devices for disk stats.
  • #463: Docker plugin not working on AWS Linux
  • #568: Multiple output race condition.
  • #585: Log stack trace and continue on Telegraf panic. Thanks @wutaizeng!

v0.10.0 [2016-01-12]

Release Notes

  • Linux packages have been taken out of opt, the binary is now in /usr/bin and configuration files are in /etc/telegraf
  • breaking change plugins have been renamed to inputs. This was done because plugins is too generic, as there are now also "output plugins", and will likely be "aggregator plugins" and "filter plugins" in the future. Additionally, inputs/ and outputs/ directories have been placed in the root-level plugins/ directory.
  • breaking change the io plugin has been renamed diskio
  • breaking change plugin measurements aggregated into a single measurement.
  • breaking change jolokia plugin: must use global tag/drop/pass parameters for configuration.
  • breaking change twemproxy plugin: prefix option removed.
  • breaking change procstat cpu measurements are now prepended with cpu_time_ instead of only cpu_
  • breaking change some command-line flags have been renamed to separate words. -configdirectory -> -config-directory, -filter -> -input-filter, -outputfilter -> -output-filter
  • The prometheus plugin schema has not been changed (measurements have not been aggregated).

Packaging change note:

RHEL/CentOS users upgrading from 0.2.x to 0.10.0 will probably have their configurations overwritten by the upgrade. There is a backup stored at /etc/telegraf/telegraf.conf.$(date +%s).backup.

Features

  • Plugin measurements aggregated into a single measurement.
  • Added ability to specify per-plugin tags
  • Added ability to specify per-plugin measurement suffix and prefix. (name_prefix and name_suffix)
  • Added ability to override base plugin measurement name. (name_override)

Bugfixes

v0.2.5 [unreleased]

Features

  • #427: zfs plugin: pool stats added. Thanks @allenpetersen!
  • #428: Amazon Kinesis output. Thanks @jimmystewpot!
  • #449: influxdb plugin, thanks @mark-rushakoff

Bugfixes

  • #430: Network statistics removed in elasticsearch 2.1. Thanks @jipperinbham!
  • #452: Elasticsearch open file handles error. Thanks @jipperinbham!

v0.2.4 [2015-12-08]

Features

  • #412: Additional memcached stats. Thanks @mgresser!
  • #410: Additional redis metrics. Thanks @vlaadbrain!
  • #414: Jolokia plugin auth parameters
  • #415: memcached plugin: support unix sockets
  • #418: memcached plugin additional unit tests.
  • #408: MailChimp plugin.
  • #382: Add system wide network protocol stats to net plugin.
  • #401: Support pass/drop/tagpass/tagdrop for outputs. Thanks @oldmantaiter!

Bugfixes

  • #405: Prometheus output cardinality issue
  • #388: Fix collection hangup when cpu times decrement.

v0.2.3 [2015-11-30]

Release Notes

  • breaking change The kafka plugin has been renamed to kafka_consumer. and most of the config option names have changed. This only affects the kafka consumer plugin (not the output). There were a number of problems with the kafka plugin that led to it only collecting data once at startup, so the kafka plugin was basically non- functional.
  • Plugins can now be specified as a list, and multiple plugin instances of the same type can be specified, like this:
[[inputs.cpu]]
  percpu = false
  totalcpu = true

[[inputs.cpu]]
  percpu = true
  totalcpu = false
  drop = ["cpu_time"]
  • Riemann output added
  • Aerospike plugin: tag changed from host -> aerospike_host

Features

  • #379: Riemann output, thanks @allenj!
  • #375: kafka_consumer service plugin.
  • #392: Procstat plugin can now accept pgrep -f pattern, thanks @ecarreras!
  • #383: Specify plugins as a list.
  • #354: Add ability to specify multiple metrics in one statsd line. Thanks @MerlinDMC!

Bugfixes

  • #371: Kafka consumer plugin not functioning.
  • #389: NaN value panic

v0.2.2 [2015-11-18]

Release Notes

  • 0.2.1 has a bug where all lists within plugins get duplicated, this includes lists of servers/URLs. 0.2.2 is being released solely to fix that bug

Bugfixes

  • #377: Fix for duplicate slices in inputs.

v0.2.1 [2015-11-16]

Release Notes

  • Telegraf will no longer use docker-compose for "long" unit test, it has been changed to just run docker commands in the Makefile. See make docker-run and make docker-kill. make test will still run all unit tests with docker.
  • Long unit tests are now run in CircleCI, with docker & race detector
  • Redis plugin tag has changed from host to server
  • HAProxy plugin tag has changed from host to server
  • UDP output now supported
  • Telegraf will now compile on FreeBSD
  • Users can now specify outputs as lists, specifying multiple outputs of the same type.

Features

  • #325: NSQ output. Thanks @jrxFive!
  • #318: Prometheus output. Thanks @oldmantaiter!
  • #338: Restart Telegraf on package upgrade. Thanks @linsomniac!
  • #337: Jolokia plugin, thanks @saiello!
  • #350: Amon output.
  • #365: Twemproxy plugin by @codeb2cc
  • #317: ZFS plugin, thanks @cornerot!
  • #364: Support InfluxDB UDP output.
  • #370: Support specifying multiple outputs, as lists.
  • #372: Remove gosigar and update go-dockerclient for FreeBSD support. Thanks @MerlinDMC!

Bugfixes

  • #331: Dont overwrite host tag in redis plugin.
  • #336: Mongodb plugin should take 2 measurements.
  • #351: Fix continual "CREATE DATABASE" in writes
  • #360: Apply prefix before ShouldPass check. Thanks @sotfo!

v0.2.0 [2015-10-27]

Release Notes

  • The -test flag will now only output 2 collections for plugins that need it
  • There is a new agent configuration option: flush_interval. This option tells Telegraf how often to flush data to InfluxDB and other output sinks. For example, users can set interval = "2s" and flush_interval = "60s" for Telegraf to collect data every 2 seconds, and flush every 60 seconds.
  • precision and utc are no longer valid agent config values. precision has moved to the influxdb output config, where it will continue to default to "s"
  • debug and test output will now print the raw line-protocol string
  • Telegraf will now, by default, round the collection interval to the nearest even interval. This means that interval="10s" will collect every :00, :10, etc. To ease scale concerns, flushing will be "jittered" by a random amount so that all Telegraf instances do not flush at the same time. Both of these options can be controlled via the round_interval and flush_jitter config options.
  • Telegraf will now retry metric flushes twice

Features

  • #205: Include per-db redis keyspace info
  • #226: Add timestamps to points in Kafka/AMQP outputs. Thanks @ekini
  • #90: Add Docker labels to tags in docker plugin
  • #223: Add port tag to nginx plugin. Thanks @neezgee!
  • #227: Add command intervals to exec plugin. Thanks @jpalay!
  • #241: MQTT Output. Thanks @shirou!
  • Memory plugin: cached and buffered measurements re-added
  • Logging: additional logging for each collection interval, track the number of metrics collected and from how many inputs.
  • #240: procstat plugin, thanks @ranjib!
  • #244: netstat plugin, thanks @shirou!
  • #262: zookeeper plugin, thanks @jrxFive!
  • #237: statsd service plugin, thanks @sparrc
  • #273: puppet agent plugin, thats @jrxFive!
  • #280: Use InfluxDB client v2.
  • #281: Eliminate need to deep copy Batch Points.
  • #286: bcache plugin, thanks @cornerot!
  • #287: Batch AMQP output, thanks @ekini!
  • #301: Collect on even intervals
  • #298: Support retrying output writes
  • #300: aerospike plugin. Thanks @oldmantaiter!
  • #322: Librato output. Thanks @jipperinbham!

Bugfixes

  • #228: New version of package will replace old one. Thanks @ekini!
  • #232: Fix bashism run during deb package installation. Thanks @yankcrime!
  • #261: RabbitMQ panics if wrong credentials given. Thanks @ekini!
  • #245: Document Exec plugin example. Thanks @ekini!
  • #264: logrotate config file fixes. Thanks @linsomniac!
  • #290: Fix some plugins sending their values as strings.
  • #289: Fix accumulator panic on nil tags.
  • #302: Fix [tags] getting applied, thanks @gotyaoi!

v0.1.9 [2015-09-22]

Release Notes

  • InfluxDB output config change: url is now urls, and is a list. Config files will still be backwards compatible if only url is specified.
  • The -test flag will now output two metric collections
  • Support for filtering telegraf outputs on the CLI -- Telegraf will now allow filtering of output sinks on the command-line using the -outputfilter flag, much like how the -filter flag works for inputs.
  • Support for filtering on config-file creation -- Telegraf now supports filtering to -sample-config command. You can now run telegraf -sample-config -filter cpu -outputfilter influxdb to get a config file with only the cpu plugin defined, and the influxdb output defined.
  • Breaking Change: The CPU collection plugin has been refactored to fix some bugs and outdated dependency issues. At the same time, I also decided to fix a naming consistency issue, so cpu_percentageIdle will become cpu_usage_idle. Also, all CPU time measurements now have it indicated in their name, so cpu_idle will become cpu_time_idle. Additionally, cpu_time measurements are going to be dropped in the default config.
  • Breaking Change: The memory plugin has been refactored and some measurements have been renamed for consistency. Some measurements have also been removed from being outputted. They are still being collected by gopsutil, and could easily be re-added in a "verbose" mode if there is demand for it.

Features

  • #143: InfluxDB clustering support
  • #181: Makefile GOBIN support. Thanks @Vye!
  • #203: AMQP output. Thanks @ekini!
  • #182: OpenTSDB output. Thanks @rplessl!
  • #187: Retry output sink connections on startup.
  • #220: Add port tag to apache plugin. Thanks @neezgee!
  • #217: Add filtering for output sinks and filtering when specifying a config file.

Bugfixes

  • #170: Systemd support
  • #175: Set write precision before gathering metrics
  • #178: redis plugin, multiple server thread hang bug
  • Fix net plugin on darwin
  • #84: Fix docker plugin on CentOS. Thanks @neezgee!
  • #189: Fix mem_used_perc. Thanks @mced!
  • #192: Increase compatibility of postgresql plugin. Now supports versions 8.1+
  • #203: EL5 rpm support. Thanks @ekini!
  • #206: CPU steal/guest values wrong on linux.
  • #212: Add hashbang to postinstall script. Thanks @ekini!
  • #212: Fix makefile warning. Thanks @ekini!

v0.1.8 [2015-09-04]

Release Notes

  • Telegraf will now write data in UTC at second precision by default
  • Now using Go 1.5 to build telegraf

Features

  • #150: Add Host Uptime metric to system plugin
  • #158: Apache Plugin. Thanks @KPACHbIuLLIAnO4
  • #159: Use second precision for InfluxDB writes
  • #165: Add additional metrics to mysql plugin. Thanks @nickscript0
  • #162: Write UTC by default, provide option
  • #166: Upload binaries to S3
  • #169: Ping plugin

Bugfixes

v0.1.7 [2015-08-28]

Features

  • #38: Kafka output producer.
  • #133: Add plugin.Gather error logging. Thanks @nickscript0!
  • #136: Add a -usage flag for printing usage of a single plugin.
  • #137: Memcached: fix when a value contains a space
  • #138: MySQL server address tag.
  • #142: Add Description and SampleConfig funcs to output interface
  • Indent the toml config file for readability

Bugfixes

  • #128: system_load measurement missing.
  • #129: Latest pkg url fix.
  • #131: Fix memory reporting on linux & darwin. Thanks @subhachandrachandra!
  • #140: Memory plugin prec->perc typo fix. Thanks @brunoqc!

v0.1.6 [2015-08-20]

Features

  • #112: Datadog output. Thanks @jipperinbham!
  • #116: Use godep to vendor all dependencies
  • #120: Httpjson plugin. Thanks @jpalay & @alvaromorales!

Bugfixes

  • #113: Update README with Telegraf/InfluxDB compatibility
  • #118: Fix for disk usage stats in Windows. Thanks @srfraser!
  • #122: Fix for DiskUsage segv fault. Thanks @srfraser!
  • #126: Nginx plugin not catching net.SplitHostPort error

v0.1.5 [2015-08-13]

Features

  • #54: MongoDB plugin. Thanks @jipperinbham!
  • #55: Elasticsearch plugin. Thanks @brocaar!
  • #71: HAProxy plugin. Thanks @kureikain!
  • #72: Adding TokuDB metrics to MySQL. Thanks vadimtk!
  • #73: RabbitMQ plugin. Thanks @ianunruh!
  • #77: Automatically create database.
  • #79: Nginx plugin. Thanks @codeb2cc!
  • #86: Lustre2 plugin. Thanks srfraser!
  • #91: Unit testing
  • #92: Exec plugin. Thanks @alvaromorales!
  • #98: LeoFS plugin. Thanks @mocchira!
  • #103: Filter by metric tags. Thanks @srfraser!
  • #106: Options to filter plugins on startup. Thanks @zepouet!
  • #107: Multiple outputs beyong influxdb. Thanks @jipperinbham!
  • #108: Support setting per-CPU and total-CPU gathering.
  • #111: Report CPU Usage in cpu plugin. Thanks @jpalay!

Bugfixes

  • #85: Fix GetLocalHost testutil function for mac users
  • #89: go fmt fixes
  • #94: Fix for issue #93, explicitly call sarama.v1 -> sarama
  • #101: switch back from master branch if building locally
  • #99: update integer output to new InfluxDB line protocol format

v0.1.4 [2015-07-09]

Features

  • #56: Update README for Kafka plugin. Thanks @EmilS!

Bugfixes

  • #50: Fix init.sh script to use telegraf directory. Thanks @jseriff!
  • #52: Update CHANGELOG to reference updated directory. Thanks @benfb!

v0.1.3 [2015-07-05]

Features

  • #35: Add Kafka plugin. Thanks @EmilS!
  • #47: Add RethinkDB plugin. Thanks @jipperinbham!

Bugfixes

  • #45: Skip disk tags that don't have a value. Thanks @jhofeditz!
  • #43: Fix bug in MySQL plugin. Thanks @marcosnils!

v0.1.2 [2015-07-01]

Features

  • #12: Add Linux/ARM to the list of built binaries. Thanks @voxxit!
  • #14: Clarify the S3 buckets that Telegraf is pushed to.
  • #16: Convert Redis to use URI, support Redis AUTH. Thanks @jipperinbham!
  • #21: Add memcached plugin. Thanks @Yukki!

Bugfixes

  • #13: Fix the packaging script.
  • #19: Add host name to metric tags. Thanks @sherifzain!
  • #20: Fix race condition with accumulator mutex. Thanks @nkatsaros!
  • #23: Change name of folder for packages. Thanks @colinrymer!
  • #32: Fix spelling of memoory -> memory. Thanks @tylernisonoff!

v0.1.1 [2015-06-19]

Release Notes

This is the initial release of Telegraf.