From 3de6bfbcb809c15c18adb2dc6b4f9a1ad3f68c54 Mon Sep 17 00:00:00 2001 From: Cameron Sparr <cameronsparr@gmail.com> Date: Fri, 13 Jan 2017 17:02:10 +0000 Subject: [PATCH] Direct people to downloads page for installation --- README.md | 60 ++++++---------------------------- plugins/outputs/amqp/README.md | 34 +++++++++++++++++++ 2 files changed, 44 insertions(+), 50 deletions(-) diff --git a/README.md b/README.md index b1141206..b758609d 100644 --- a/README.md +++ b/README.md @@ -25,60 +25,20 @@ new plugins. ## Installation: -### Linux deb and rpm Packages: +You can either download the binaries directly from the +[downloads](https://www.influxdata.com/downloads) page. -Latest: -* https://dl.influxdata.com/telegraf/releases/telegraf_1.1.1_amd64.deb -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1.x86_64.rpm - -Latest (arm): -* https://dl.influxdata.com/telegraf/releases/telegraf_1.1.1_armhf.deb -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1.armhf.rpm - -##### Package Instructions: - -* Telegraf binary is installed in `/usr/bin/telegraf` -* Telegraf daemon configuration file is in `/etc/telegraf/telegraf.conf` -* On sysv systems, the telegraf daemon can be controlled via -`service telegraf [action]` -* On systemd systems (such as Ubuntu 15+), the telegraf daemon can be -controlled via `systemctl [action] telegraf` - -### yum/apt Repositories: - -There is a yum/apt repo available for the whole InfluxData stack, see -[here](https://docs.influxdata.com/influxdb/latest/introduction/installation/#installation) -for instructions on setting up the repo. Once it is configured, you will be able -to use this repo to install & update telegraf. - -### Linux tarballs: - -Latest: -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1_linux_amd64.tar.gz -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1_linux_i386.tar.gz -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1_linux_armhf.tar.gz +A few alternate installs are available here as well: ### FreeBSD tarball: Latest: -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1_freebsd_amd64.tar.gz +* https://dl.influxdata.com/telegraf/releases/telegraf-VERSION_freebsd_amd64.tar.gz ### Ansible Role: Ansible role: https://github.com/rossmcdonald/telegraf -### OSX via Homebrew: - -``` -brew update -brew install telegraf -``` - -### Windows Binaries (EXPERIMENTAL) - -Latest: -* https://dl.influxdata.com/telegraf/releases/telegraf-1.1.1_windows_amd64.zip - ### From Source: Telegraf manages dependencies via [gdm](https://github.com/sparrc/gdm), @@ -99,31 +59,31 @@ See usage with: telegraf --help ``` -### Generate a telegraf config file: +#### Generate a telegraf config file: ``` telegraf config > telegraf.conf ``` -### Generate config with only cpu input & influxdb output plugins defined +#### Generate config with only cpu input & influxdb output plugins defined ``` telegraf --input-filter cpu --output-filter influxdb config ``` -### Run a single telegraf collection, outputing metrics to stdout +#### Run a single telegraf collection, outputing metrics to stdout ``` telegraf --config telegraf.conf -test ``` -### Run telegraf with all plugins defined in config file +#### Run telegraf with all plugins defined in config file ``` telegraf --config telegraf.conf ``` -### Run telegraf, enabling the cpu & memory input, and influxdb output plugins +#### Run telegraf, enabling the cpu & memory input, and influxdb output plugins ``` telegraf --config telegraf.conf -input-filter cpu:mem -output-filter influxdb @@ -242,7 +202,7 @@ Telegraf can also collect metrics via the following service plugins: * [influxdb](./plugins/outputs/influxdb) * [amon](./plugins/outputs/amon) -* [amqp](./plugins/outputs/amqp) +* [amqp](./plugins/outputs/amqp) (rabbitmq) * [aws kinesis](./plugins/outputs/kinesis) * [aws cloudwatch](./plugins/outputs/cloudwatch) * [datadog](./plugins/outputs/datadog) diff --git a/plugins/outputs/amqp/README.md b/plugins/outputs/amqp/README.md index 2fdedfbf..d49c507b 100644 --- a/plugins/outputs/amqp/README.md +++ b/plugins/outputs/amqp/README.md @@ -7,3 +7,37 @@ If RoutingTag is empty, then empty routing key will be used. Metrics are grouped in batches by RoutingTag. This plugin doesn't bind exchange to a queue, so it should be done by consumer. + +### Configuration: + +``` +# Configuration for the AMQP server to send metrics to +[[outputs.amqp]] + ## AMQP url + url = "amqp://localhost:5672/influxdb" + ## AMQP exchange + exchange = "telegraf" + ## Auth method. PLAIN and EXTERNAL are supported + # auth_method = "PLAIN" + ## Telegraf tag to use as a routing key + ## ie, if this tag exists, it's value will be used as the routing key + routing_tag = "host" + + ## InfluxDB retention policy + # retention_policy = "default" + ## InfluxDB database + # database = "telegraf" + + ## Optional SSL Config + # ssl_ca = "/etc/telegraf/ca.pem" + # ssl_cert = "/etc/telegraf/cert.pem" + # ssl_key = "/etc/telegraf/key.pem" + ## Use SSL but skip chain & host verification + # insecure_skip_verify = false + + ## Data format to output. + ## Each data format has it's own unique set of configuration options, read + ## more about them here: + ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md + data_format = "influx" +``` -- GitLab