https://github.com/mediafellows/ansible-role-telegraf

Ansible Role - Installs and configures telegraf agent
https://github.com/mediafellows/ansible-role-telegraf

ansible-role fork telegraf-agent

Last synced: 1 day ago
JSON representation

Ansible Role - Installs and configures telegraf agent

• Host: GitHub
• URL: https://github.com/mediafellows/ansible-role-telegraf
• Owner: mediafellows
• Created: 2020-04-03T10:21:26.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-01T10:00:38.000Z (6 months ago)
• Last Synced: 2024-08-01T20:54:24.662Z (6 months ago)
• Topics: ansible-role, fork, telegraf-agent
• Language: Jinja
• Homepage: https://github.com/rossmcdonald/telegraf
• Size: 91.8 KB
• Stars: 0
• Watchers: 6
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![Ansible-Test](https://github.com/mediafellows/ansible-role-telegraf/workflows/Ansible-Test/badge.svg)](https://github.com/mediafellows/ansible-role-telegraf/actions?query=workflow%3AAnsible-Test)

# Ansible role for Telegraf

An Ansible role to install, configure, and manage [Telegraf](https://github.com/influxdb/telegraf), the plugin-driven server agent for reporting metrics into InfluxDB.

Note: this is a fork of https://github.com/rossmcdonald/telegraf

## Requirements

Linux server (Debian/RedHat based), place to send the events too.

Prior knowledge/experience with InfluxDB and Telegraf is highly recommended. See output plugins [here](https://github.com/influxdata/telegraf#output-plugins).

## Role Variables

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

- `telegraf_output_plugins` - A list of dictionaries to configure your ouput plugins, for instance to influxdb or other destinations.

- `telegraf_input_plugins` - A list dictionaries to configure the metrics you want to collect. Either system metrics from the host the agent runs on or metrics of some services, DBs etc.

- `telegraf_custom_config_file` - A path to a file that contains (additional) telegraf config (can be a Jinja2 template too).

For more params see `defaults/main.yml`.

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

Example playbook using this role:

    - name: My Play with Telegraf

      hosts: servers

      vars:

        telegraf_output_plugins:

          - name: instrumental

            options:

              api_token: "abc-1234"

              prefix: ""

              template: "measurement.host.system_measurement_tag.tags.field"

              timeout: "2s"

              debug: false

        telegraf_input_plugins:

          - name: cpu

            options:

              key: "value"

            tags:

              key: "value"

            tagdrop:

              key: "value"

            tagpass:

              key: "value"

      roles:

         - mediafellows.telegraf

## License

MIT

## Author

Created by [Ross McDonald](https://github.com/rossmcdonald). Extended by [Stefan Horning](https://github.com/stefanhorning).