This project lets you configure a Telegraf agent to send your collected Prometheus-format metrics to


Telegraf is a plug-in driven server agent for collecting and sending metrics and events from databases, systems, and IoT sensors.

To send your Prometheus-format metrics to, you add the outputs.http plug-in to your Telegraf configuration file.

Configuring Telegraf to send your metrics data to

Set up Telegraf v1.17 or higher:

Follow the instructions on Get started with Telegraf to:

  1. Download and install Telegraf in the terminal.
  2. Create and configure the ‘telegraf.conf’ file.
  3. Start the Telegraf service.
Add the outputs.http plug-in

After you create a config file for Telegraf, configure the output plug-in to enable your data to be sent to in Prometheus-format and add the following code to the configuration file:

For the list of options, see the parameters below the code block.👇

  url = "https://<<LISTENER-HOST>>:8053"
  data_format = "prometheusremotewrite"
     Content-Type = "application/x-protobuf"
     Content-Encoding = "snappy"
     X-Prometheus-Remote-Write-Version = "0.1.0"
     Authorization = "Bearer <<PROMETHEUS-METRICS-SHIPPING-TOKEN>>"

Replace the placeholders to match your specifics. (They are indicated by the double angle brackets << >>):

  • Replace <<PROMETHEUS-METRICS-SHIPPING-TOKEN>> with a token for the Metrics account you want to ship to.
    Here’s how to look up your Metrics token.
  • Replace <<LISTENER-HOST>> with the Listener URL for your region, configured to use port 8052 for http traffic, or port 8053 for https traffic. For example, if your account is hosted on AWS US East, or if hosted on Azure West Europe.
Check for your metrics

Log in to your account and navigate to the current instructions page inside the app. Install the pre-built dashboard to enhance the observability of your metrics.

To view the metrics on the main dashboard, log in to your Metrics account, and open the Metrics tab.