From 4d614b308801d73c6bb2c2cdaed790c5f8b322af Mon Sep 17 00:00:00 2001 From: Cameron Sparr Date: Fri, 14 Aug 2015 09:54:40 -0600 Subject: [PATCH] README update to address issue #113 --- CHANGELOG.md | 2 ++ README.md | 38 +++++++++++++++++++++++++++++++++----- 2 files changed, 35 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6cd184d14..c5d16c9d5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,7 @@ [#112](://github.com/influxdb/telegraf/pull/112): Datadog output. Thanks @jipperinbham! ### Bugfixes +[113](https://github.com/influxdb/telegraf/issues/113): Update README with Telegraf/InfluxDB compatibility ## v0.1.5 [2015-08-13] @@ -30,6 +31,7 @@ - [#89](https://github.com/influxdb/telegraf/pull/89): go fmt fixes - [#94](https://github.com/influxdb/telegraf/pull/94): Fix for issue #93, explicitly call sarama.v1 -> sarama - [#101](https://github.com/influxdb/telegraf/issues/101): switch back from master branch if building locally +- [#99](https://github.com/influxdb/telegraf/issues/99): update integer output to new InfluxDB line protocol format ## v0.1.4 [2015-07-09] diff --git a/README.md b/README.md index 8074e5940..3f2b3cd3c 100644 --- a/README.md +++ b/README.md @@ -23,10 +23,19 @@ agent is NOT backwards-compatible with a config file from 0.1.4 and below. That being said, the difference is not huge, see below for an example on how to setup the new config file. -``` -http://get.influxdb.org/telegraf/telegraf_0.1.5_amd64.deb -http://get.influxdb.org/telegraf/telegraf-0.1.5-1.x86_64.rpm -``` +As well, due to a breaking change to the InfluxDB integer line-protocol, there +are some InfluxDB compatibility requirements: + +* InfluxDB 0.9.3+ (including nightly builds) requires Telegraf 0.1.5+ +* InfluxDB 0.9.2 and prior requires Telegraf 0.1.4 + +Telegraf 0.1.5 +* http://get.influxdb.org/telegraf/telegraf_0.1.5_amd64.deb +* http://get.influxdb.org/telegraf/telegraf-0.1.5-1.x86_64.rpm + +Telegraf 0.1.4 +* http://get.influxdb.org/telegraf/telegraf_0.1.4_amd64.deb +* http://get.influxdb.org/telegraf/telegraf-0.1.4-1.x86_64.rpm ### OSX via Homebrew: @@ -79,8 +88,27 @@ you can configure that here. ### Plugin Configuration Examples This is a full working config that will output CPU data to an InfluxDB instance -at 192.168.59.103:8086, tagging measurements with dc="Denver-1". It will output +at 192.168.59.103:8086, tagging measurements with dc="denver-1". It will output measurements at a 10s interval and will collect totalcpu & percpu data. + +##### 0.1.4: + +``` +[influxdb] +url = "http://192.168.59.103:8086" # required. +database = "telegraf" # required. + +[tags] +dc = "denver-1" + +[agent] +interval = "10s" + +[cpu] +``` + +##### 0.1.5: + ``` [outputs] [outputs.influxdb]