dom
/
telegraf
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Direct people to downloads page for installation

This commit is contained in:
Cameron Sparr 2017-01-13 17:02:10 +00:00
parent 6ca52195a9
commit c3d1da6b6b
2 changed files with 44 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
README.md
View File

@ -25,60 +25,20 @@ new plugins.
## Installation: ## Installation:
### Linux deb and rpm Packages: You can either download the binaries directly from the
[downloads](https://www.influxdata.com/downloads) page.
Latest: A few alternate installs are available here as well:
* 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
### FreeBSD tarball: ### FreeBSD tarball:
Latest: 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:
Ansible role: https://github.com/rossmcdonald/telegraf 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: ### From Source:
Telegraf manages dependencies via [gdm](https://github.com/sparrc/gdm), Telegraf manages dependencies via [gdm](https://github.com/sparrc/gdm),
@ -99,31 +59,31 @@ See usage with:
telegraf --help telegraf --help
``` ```
### Generate a telegraf config file: #### Generate a telegraf config file:
``` ```
telegraf config > telegraf.conf 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 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 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 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 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) * [influxdb](./plugins/outputs/influxdb)
* [amon](./plugins/outputs/amon) * [amon](./plugins/outputs/amon)
* [amqp](./plugins/outputs/amqp) * [amqp](./plugins/outputs/amqp) (rabbitmq)
* [aws kinesis](./plugins/outputs/kinesis) * [aws kinesis](./plugins/outputs/kinesis)
* [aws cloudwatch](./plugins/outputs/cloudwatch) * [aws cloudwatch](./plugins/outputs/cloudwatch)
* [datadog](./plugins/outputs/datadog) * [datadog](./plugins/outputs/datadog)

34
plugins/outputs/amqp/README.md
View File

@ -7,3 +7,37 @@ If RoutingTag is empty, then empty routing key will be used.
Metrics are grouped in batches by RoutingTag. Metrics are grouped in batches by RoutingTag.
This plugin doesn't bind exchange to a queue, so it should be done by consumer. 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"
```