This integration collects data from Traefik in order to check its health and monitor:
- Errors logs (4xx codes, 5xx codes)
- Number of requests
- Number of bytes exchanged
To install the Traefik check on your host:
- Install the developer toolkit on any machine.
ddev release build traefikto build the package.
- Download the Datadog Agent.
- Upload the build artifact to any host with an Agent and run
datadog-agent integration install -w path/to/traefik/dist/<ARTIFACT_NAME>.whl.
traefik.d/conf.yamlfile 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"
- host: Traefik endpoint to query. Required
- port: API listener of Traefik endpoint. Default value
- path: Path of Traefik health check endpoint. Default
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
Add this configuration block to your
traefik.d/conf.yamlfile 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
serviceparameter 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.
See metadata.csv for a list of metrics provided by this integration.
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.