traefik Integration

Overview

This integration collects data from Traefik and checks its health.

Setup

Configuration

Create a traefik.yaml in the Datadog Agent's conf.d directory.

Metric Collection

Add this configuration setup to your traefik.yaml file to start gathering your metrics:

init_config:

instances:
  - host: 10.1.2.3
    port: "8080"
    path: "/health"

Configuration Options:

• host: Traefik endpoint to query. Required
• port: API listener of Traefik endpoint. Default value 8080. Optional
• path: Path of Traefik health check endpoint. Default /health. Optional

Restart the Agent to begin sending Traefik metrics to Datadog.

Validation

Run the Agent's status subcommand and look for traefik under the Checks section:

  Checks
  ======
    [...]

    traefik
    -------
      - instance #0 [OK]
      - Collected 2 metrics, 0 events & 1 service check

    [...]

Compatibility

The check is compatible with all major platforms.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The Traefik check does not include any events at this time.

Service Checks

Query Traefik and expect 200 as return status code.

Development

Refer to the main documentation for more details about how to test and develop Agent based integrations.