---
title: Telegraf Documentation
description: Telegraf plugin for sending metrics to Librato
url: https://docs.influxdata.com/telegraf/v1/output-plugins/librato/
estimated_tokens: 1014
product: Telegraf
version: v1
---

-   Telegraf v0.2.0+

# Librato Output Plugin

This plugin writes metrics to the [Librato](https://www.librato.com/) service. It requires an `api_user` and `api_token` which can be obtained on the [website](https://metrics.librato.com/account/api_tokens) 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.

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

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) 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](/telegraf/v1/configuration/#secret-store-secrets) for more details on how to use them.

## Configuration

```toml
# 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"
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Librato Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/outputs/librato/README.md)