README.rst

=======================
Salt Telegraf formula
=======================

Power your metrics and alerting with a leading open-source monitoring
solution.

Sample pillars
==============

.. code-block:: yaml

  telegraf:
    agent:
      enabled: true
      interval: 15
      round_interval: false
      metric_batch_size: 1000
      metric_buffer_limit: 10000
      collection_jitter: 2
      output:
        prometheus_client:
          bind:
            address: 0.0.0.0
            port: 9126
          engine: prometheus

Influx output
-------------

.. code-block:: yaml

  telegraf:
    agent:
      output:
        influxdb:
          urls:
            - http://127.0.0.1:8086
          database: test-telegraf
          write_consistency: any
          timeout: 10s

Multiple outputs of the same type
---------------------------------

.. code-block:: yaml

  telegraf:
    agent:
      output:
        prometheus_client:
          bind:
            address: 0.0.0.0
            port: 9126
          engine: prometheus
          expiration_interval: 1m
          namedrop:
          - custom_metric
          string_as_label: false
        prometheus_client_custom:
          bind:
            address: 0.0.0.0
            port: 9127
          engine: prometheus
          expiration_interval: 10m
          namepass:
          - custom_metric
          string_as_label: false
          template: telegraf/files/output/prometheus_client.conf