Traefik Observability

Overview

In this tutorial, we will see how to export metrics and traces of Traefik to SigNoz. Visualizing Traefik metrics and traces will help you to understand the performance of services running behind Traefik and troubleshoot issues.

Prerequisites

• Traefik v3.0 or above
• Must have SigNoz running. You can follow the installation guide to install SigNoz.
• Must have SigNoz OtelCollector accessible from Traefik
• If you don’t already have a SigNoz Cloud account, you can sign up here.

Export Traefik Metrics and Traces to SigNoz

Based on how you are running SigNoz (e.g. SigNoz Cloud, in an independent VM or Kubernetes cluster), you have to provide the address to send data from the above receivers.

# docker-compose.yaml {13-14,18-19}

version: '3'
services:
  reverse-proxy:
    image: traefik:latest
    extra_hosts:
      - signoz:host-gateway
    command:
      - --api.insecure=true
      - --providers.docker
      - --metrics.otlp=true
      - --metrics.otlp.grpc=true
      - --metrics.otlp.insecure=false
      - --metrics.otlp.address=ingest.{region}.signoz.cloud:443
      - --metrics.otlp.headers.signoz-access-token=SIGNOZ_INGESTION_KEY
      - --tracing.otlp=true
      - --tracing.otlp.grpc=true
      - --tracing.otlp.insecure=false
      - --tracing.otlp.address=ingest.{region}.signoz.cloud:443
      - --tracing.otlp.headers.signoz-access-token=SIGNOZ_INGESTION_KEY
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
  hello-app:
    image: gcr.io/google-samples/hello-app:2.0
    environment:
      - PORT=8080
    labels:
      traefik.enable: true
      traefik.http.routers.hello-app.rule: Host(`hello-app.docker.localhost`)
      traefik.http.routers.hello-app.entrypoints: http
      traefik.http.routers.hello-app.service: hello-app

To start the services, run the following command:

docker compose up -d

We will visit the hello-app service to generate some traffic.

curl -H Host:hello-app.docker.localhost http://127.0.0.1

Now, we will visit the SigNoz UI to see the traces and metrics.

To plot metrics generated from Traefik, follow the instructions given in the docs here.

Check out the List of metrics from Traefik.

List of Metrics

Traefik Metrics

• traefik_config_last_reload_success
• traefik_config_reloads_total
• traefik_entrypoint_request_duration_seconds_bucket
• traefik_entrypoint_request_duration_seconds_count
• traefik_entrypoint_request_duration_seconds_sum
• traefik_entrypoint_requests_bytes_total
• traefik_entrypoint_requests_total
• traefik_entrypoint_responses_bytes_total
• traefik_open_connections
• traefik_service_request_duration_seconds_bucket
• traefik_service_request_duration_seconds_count
• traefik_service_request_duration_seconds_sum
• traefik_service_requests_bytes_total
• traefik_service_requests_total
• traefik_service_responses_bytes_total