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

Overview

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 Layerlog, you add the outputs.http plug-in to your Telegraf configuration file.

Configuring Telegraf to send your metrics data to Layerlog

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 Layerlog in Prometheus-format and add the following code to the configuration file:

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

[[outputs.http]]
  url = "https://<<LISTENER-HOST>>:8053"
  data_format = "prometheusremotewrite"
  [outputs.http.headers]
     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 Layerlog Listener URL for your region, configured to use port 8052 for http traffic, or port 8053 for https traffic. For example, listener.layerlog.com if your account is hosted on AWS US East, or listener-nl.layerlog.com if hosted on Azure West Europe.
Check Layerlog for your metrics

Log in to your Layerlog account and navigate to the current instructions page inside the Layerlog 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 Layerlog Metrics account, and open the Layerlog Metrics tab.