docs-v2/content/telegraf/v1/output-plugins/librato/_index.md

2.6 KiB

description menu tags introduced os_support related
Telegraf plugin for sending metrics to Librato
telegraf_v1_ref
parent name identifier
output_plugins_reference Librato output-librato
Librato
output-plugins
configuration
cloud
datastore
v0.2.0 freebsd, linux, macos, solaris, windows
/telegraf/v1/configure_plugins/
https://github.com/influxdata/telegraf/tree/v1.36.1/plugins/outputs/librato/README.md, Librato Plugin Source

Librato Output Plugin

This plugin writes metrics to the Librato service. It requires an api_user and api_token which can be obtained here for your account.

The source_tag option in the Configuration file is used to send contextual information from Point Tags to the API. Besides from this, the plugin currently does not send any additional associated Point Tags.

[!IMPOTANT] If the point value being sent cannot be converted to a float64, the metric is skipped.

Introduced in: Telegraf v0.2.0 Tags: cloud, datastore OS support: all

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Secret-store support

This plugin supports secrets from secret-stores for the api_user and api_token option. See the secret-store documentation for more details on how to use them.

Configuration

# Configuration for Librato API to send metrics to.
[[outputs.librato]]
  ## Librato API Docs
  ## http://dev.librato.com/v1/metrics-authentication
  ## Librato API user
  api_user = "telegraf@influxdb.com" # required.
  ## Librato API token
  api_token = "my-secret-token" # required.
  ## Debug
  # debug = false
  ## Connection timeout.
  # timeout = "5s"
  ## Output source Template (same as graphite buckets)
  ## see https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md#graphite
  ## This template is used in librato's source (not metric's name)
  template = "host"