History

Mephisto b517df3151 Set Telegraf Config Permissions to 740		2021-01-12 14:23:36 +01:00
..
defaults	Add Telegraf Role	2021-01-10 19:11:32 +01:00
handlers	Add Telegraf Role	2021-01-10 19:11:32 +01:00
meta	Add Telegraf Role	2021-01-10 19:11:32 +01:00
tasks	Set Telegraf Config Permissions to 740	2021-01-12 14:23:36 +01:00
templates	Write hostname instead of fqdn	2021-01-10 19:16:16 +01:00
vars	Add Telegraf Role	2021-01-10 19:11:32 +01:00
README.md	Add Telegraf Role	2021-01-10 19:11:32 +01:00
test.yml	Add Telegraf Role	2021-01-10 19:11:32 +01:00
Vagrantfile	Add Telegraf Role	2021-01-10 19:11:32 +01:00

README.md

Telegraf

An Ansible role to install, configure, and manage Telegraf, the plugin-driven server agent for reporting metrics into InfluxDB.

Requirements

Prior knowledge/experience with InfluxDB and Telegraf is highly recommended. Full documentation is available here.

Installation

Either clone this repository, or install through Ansible Galaxy directly using the command:

ansible-galaxy install rossmcdonald.telegraf

Role Variables

The high-level variables are stored in the defaults/main.yml file. The most important ones being:

# Channel of Telegraf to install (currently only 'stable' is supported)
telegraf_install_version: stable

More advanced configuration options are stored in the vars/main.yml file, which includes all of the necessary bells and whistles to tweak your configuration.

Dependencies

No other Ansible dependencies are required. This role was tested and developed with Ansible 1.9.4.

Example Playbook

An example playbook is included in the test.yml file. There is also a Vagrantfile, which can be used for quick local testing leveraging Vagrant.

Contributions and Feedback

Any contributions are welcome. For any bugs or feature requests, please open an issue through Github.

License

MIT

Author

Created by Ross McDonald.