This integration collects data from Traefik in order to check its health and monitor:
To install the Traefik check on your host:
ddev release build traefikto build the package.
datadog-agent integration install -w path/to/traefik/dist/<ARTIFACT_NAME>.whl.
traefik.d/conf.yaml file in the
conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Traefik metrics and logs.
See the sample traefik.d/conf.yaml for all available configuration options.
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"
Restart the Agent to begin sending Traefik metrics to Datadog.
Available for Agent >6.0
By default Traefik logs are sent to stdout. This should not be changed for containerized version, as the Datadog Agent is able to collect logs directly from container
To configure Traefik to log to a file, add the following in the Traefik configuration file:
[traefikLog] filePath = "/path/to/traefik.log"
The common Apache Access format is used by default and is supported by this integration.
Collecting logs is disabled by default in the Datadog Agent. Enable it in your
datadog.yaml file with:
Add this configuration block to your
traefik.d/conf.yaml file at the root of your Agent’s configuration directory to start collecting your Traefik logs:
logs: - type: file path: /path/to/traefik.log source: traefik service: traefik
service parameter values and configure them for your environment.
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 [...]
The check is compatible with all major platforms.
|total count for each returned status code|
|count total number of requests|
The Traefik check does not include any events.
Query Traefik and expect
200 as return status code.
Refer to the main documentation for more details about how to test and develop Agent based integrations.
Mistake in the docs? Feel free to contribute!