Metrics¶

Traefik supports 4 metrics backends:

Global Metrics¶

Metric	DataDog	InfluxDB	Prometheus	StatsD
Configuration reloads	✓	✓	✓	✓
Last Configuration Reload Success	✓	✓	✓	✓
TLS certificates expiration	✓	✓	✓	✓

Configuration Reloads¶

The total count of configuration reloads.

Datadog

config.reload.total

InfluxDB

traefik.config.reload.total

Prometheus

traefik_config_reloads_total

StatsD

# Default prefix: "traefik"
{prefix}.config.reload.total

Last Configuration Reload Success¶

The timestamp of the last configuration reload success.

Datadog

config.reload.lastSuccessTimestamp

InfluxDB

traefik.config.reload.lastSuccessTimestamp

Prometheus

traefik_config_last_reload_success

StatsD

# Default prefix: "traefik"
{prefix}.config.reload.lastSuccessTimestamp

TLS certificates expiration¶

The expiration date of certificates.

Labels: cn, sans, serial.

Datadog

tls.certs.notAfterTimestamp

InfluxDB

traefik.tls.certs.notAfterTimestamp

Prometheus

traefik_tls_certs_not_after

StatsD

# Default prefix: "traefik"
{prefix}.tls.certs.notAfterTimestamp

EntryPoint Metrics¶

Metric	DataDog	InfluxDB	Prometheus	StatsD
HTTP Requests Count	✓	✓	✓	✓
HTTPS Requests Count	✓	✓	✓	✓
Request Duration Histogram	✓	✓	✓	✓
Open Connections Count	✓	✓	✓	✓

HTTP Requests Count¶

The total count of HTTP requests received by an entrypoint.

Labels: code, method, protocol, entrypoint.

Datadog

entrypoint.request.total

InfluxDB

traefik.entrypoint.requests.total

Prometheus

traefik_entrypoint_requests_total

StatsD

# Default prefix: "traefik"
{prefix}.entrypoint.request.total

HTTPS Requests Count¶

The total count of HTTPS requests received by an entrypoint.

Labels: tls_version, tls_cipher, entrypoint.

Datadog

entrypoint.request.tls.total

InfluxDB

traefik.entrypoint.requests.tls.total

Prometheus

traefik_entrypoint_requests_tls_total

StatsD

# Default prefix: "traefik"
{prefix}.entrypoint.request.tls.total

Request Duration Histogram¶

Request processing duration histogram on an entrypoint.

Labels: code, method, protocol, entrypoint.

Datadog

entrypoint.request.duration

InfluxDB

traefik.entrypoint.request.duration

Prometheus

traefik_entrypoint_request_duration_seconds

StatsD

# Default prefix: "traefik"
{prefix}.entrypoint.request.duration

Open Connections Count¶

The current count of open connections on an entrypoint.

Labels: method, protocol, entrypoint.

Datadog

entrypoint.connections.open

InfluxDB

traefik.entrypoint.connections.open

Prometheus

traefik_entrypoint_open_connections

StatsD

# Default prefix: "traefik"
{prefix}.entrypoint.connections.open

Router Metrics¶

Metric	DataDog	InfluxDB	Prometheus	StatsD
HTTP Requests Count	✓	✓	✓	✓
HTTPS Requests Count	✓	✓	✓	✓
Request Duration Histogram	✓	✓	✓	✓
Open Connections Count	✓	✓	✓	✓

HTTP Requests Count¶

The total count of HTTP requests handled by a router.

Labels: code, method, protocol, router, service.

Datadog

router.request.total

InfluxDB

traefik.router.requests.total

Prometheus

traefik_router_requests_total

StatsD

# Default prefix: "traefik"
{prefix}.router.request.total

HTTPS Requests Count¶

The total count of HTTPS requests handled by a router.

Labels: tls_version, tls_cipher, router, service.

Datadog

router.request.tls.total

InfluxDB

traefik.router.requests.tls.total

Prometheus

traefik_router_requests_tls_total

StatsD

# Default prefix: "traefik"
{prefix}.router.request.tls.total

Request Duration Histogram¶

Request processing duration histogram on a router.

Labels: code, method, protocol, router, service.

Datadog

router.request.duration

InfluxDB

traefik.router.request.duration

Prometheus

traefik_router_request_duration_seconds

StatsD

# Default prefix: "traefik"
{prefix}.router.request.duration

Open Connections Count¶

The current count of open connections on a router.

Labels: method, protocol, router, service.

Datadog

router.connections.open

InfluxDB

traefik.router.connections.open

Prometheus

traefik_router_open_connections

StatsD

# Default prefix: "traefik"
{prefix}.router.connections.open

Service Metrics¶

Metric	DataDog	InfluxDB	Prometheus	StatsD
HTTP Requests Count	✓	✓	✓	✓
HTTPS Requests Count	✓	✓	✓	✓
Request Duration Histogram	✓	✓	✓	✓
Open Connections Count	✓	✓	✓	✓
Requests Retries Count	✓	✓	✓	✓
Service Server UP	✓	✓	✓	✓

HTTP Requests Count¶

The total count of HTTP requests processed on a service.

Labels: code, method, protocol, service.

Datadog

service.request.total

InfluxDB

traefik.service.requests.total

Prometheus

traefik_service_requests_total

StatsD

# Default prefix: "traefik"
{prefix}.service.request.total

HTTPS Requests Count¶

The total count of HTTPS requests processed on a service.

Labels: tls_version, tls_cipher, service.

Datadog

router.service.tls.total

InfluxDB

traefik.service.requests.tls.total

Prometheus

traefik_service_requests_tls_total

StatsD

# Default prefix: "traefik"
{prefix}.service.request.tls.total

Request Duration Histogram¶

Request processing duration histogram on a service.

Labels: code, method, protocol, service.

Datadog

service.request.duration

InfluxDB

traefik.service.request.duration

Prometheus

traefik_service_request_duration_seconds

StatsD

# Default prefix: "traefik"
{prefix}.service.request.duration

Open Connections Count¶

The current count of open connections on a service.

Labels: method, protocol, service.

Datadog

service.connections.open

InfluxDB

traefik.service.connections.open

Prometheus

traefik_service_open_connections

StatsD

# Default prefix: "traefik"
{prefix}.service.connections.open

Requests Retries Count¶

The count of requests retries on a service.

Labels: service.

Datadog

service.retries.total

InfluxDB

traefik.service.retries.total

Prometheus

traefik_service_retries_total

StatsD

# Default prefix: "traefik"
{prefix}.service.retries.total

Service Server UP¶

Current service's server status, described by a gauge with a value of 0 for a down server or a value of 1 for an up server.

Labels: service, url.

Datadog

service.server.up

InfluxDB

traefik.service.server.up

Prometheus

traefik_service_server_up

StatsD

# Default prefix: "traefik"
{prefix}.service.server.up

Labels¶

Here is a comprehensive list of labels that are provided by the metrics:

Label	Description	example
`cn`	Certificate Common Name	"example.com"
`code`	Request code	"200"
`entrypoint`	Entrypoint that handled the request	"example_entrypoint"
`method`	Request Method	"GET"
`protocol`	Request protocol	"http"
`router`	Router that handled the request	"example_router"
`sans`	Certificate Subject Alternative NameS	"example.com"
`serial`	Certificate Serial Number	"123..."
`service`	Service that handled the request	"example_service@provider"
`tls_cipher`	TLS cipher used for the request	"TLS_FALLBACK_SCSV"
`tls_version`	TLS version used for the request	"1.0"
`url`	Service server url	"http://example.com"

method label value

If the HTTP method verb on a request is not one defined in the set of common methods for HTTP/1.1 or the PRI verb (for HTTP/2), then the value for the method label becomes EXTENSION_METHOD.