Metrics
Traefik supports 4 metrics backends:
Global Metrics
Metric | DataDog | InfluxDB / InfluxDB2 | Prometheus | StatsD |
---|---|---|---|---|
Configuration reloads | ✓ | ✓ | ✓ | ✓ |
Last Configuration Reload Success | ✓ | ✓ | ✓ | ✓ |
TLS certificates expiration | ✓ | ✓ | ✓ | ✓ |
Configuration Reloads
The total count of configuration reloads.
Datadog
config.reload.total
InfluxDB / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
traefik.tls.certs.notAfterTimestamp
Prometheus
traefik_tls_certs_not_after
StatsD
# Default prefix: "traefik"
{prefix}.tls.certs.notAfterTimestamp
EntryPoint Metrics
Metric | DataDog | InfluxDB / InfluxDB2 | 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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
traefik.entrypoint.connections.open
Prometheus
traefik_entrypoint_open_connections
StatsD
# Default prefix: "traefik"
{prefix}.entrypoint.connections.open
Router Metrics
Metric | DataDog | InfluxDB / InfluxDB2 | 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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
traefik.router.connections.open
Prometheus
traefik_router_open_connections
StatsD
# Default prefix: "traefik"
{prefix}.router.connections.open
Service Metrics
Metric | DataDog | InfluxDB / InfluxDB2 | 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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 / InfluxDB2
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 | “exampleentrypoint” |
method | Request Method | “GET” |
protocol | Request protocol | “http” |
router | Router that handled the request | “examplerouter” |
sans | Certificate Subject Alternative NameS | “example.com” |
serial | Certificate Serial Number | “123…” |
service | Service that handled the request | “<a href=”https://doc.traefik.io/cdn-cgi/l/email-protection“ class=”__cf_email“ data-cfemail=”42273a232f322e271d312730342b21270232302d342b262730”>[email protected]“ |
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
.