title |
description |
Traefik Metrics Overview |
Traefik Proxy supports these metrics backend systems: Datadog, InfluxDB, Prometheus, and StatsD. Read the full documentation to get started. |
Metrics
Traefik supports these metrics backends:
Global Metrics
Metric |
Type |
Description |
Config reload total |
Count |
The total count of configuration reloads. |
Config reload last success |
Gauge |
The timestamp of the last configuration reload success. |
TLS certificates not after |
Gauge |
The expiration date of certificates. |
traefik_config_reloads_total
traefik_config_last_reload_success
traefik_tls_certs_not_after
config.reload.total
config.reload.lastSuccessTimestamp
tls.certs.notAfterTimestamp
traefik.config.reload.total
traefik.config.reload.lastSuccessTimestamp
traefik.tls.certs.notAfterTimestamp
# Default prefix: "traefik"
{prefix}.config.reload.total
{prefix}.config.reload.lastSuccessTimestamp
{prefix}.tls.certs.notAfterTimestamp
EntryPoint Metrics
Metric |
Type |
Labels |
Description |
Requests total |
Count |
code , method , protocol , entrypoint |
The total count of HTTP requests received by an entrypoint. |
Requests TLS total |
Count |
tls_version , tls_cipher , entrypoint |
The total count of HTTPS requests received by an entrypoint. |
Request duration |
Histogram |
code , method , protocol , entrypoint |
Request processing duration histogram on an entrypoint. |
Open connections |
Count |
method , protocol , entrypoint |
The current count of open connections on an entrypoint. |
Requests bytes total |
Count |
code , method , protocol , entrypoint |
The total size of HTTP requests in bytes handled by an entrypoint. |
Responses bytes total |
Count |
code , method , protocol , entrypoint |
The total size of HTTP responses in bytes handled by an entrypoint. |
traefik_entrypoint_requests_total
traefik_entrypoint_requests_tls_total
traefik_entrypoint_request_duration_seconds
traefik_entrypoint_open_connections
traefik_entrypoint_requests_bytes_total
traefik_entrypoint_responses_bytes_total
entrypoint.request.total
entrypoint.request.tls.total
entrypoint.request.duration
entrypoint.connections.open
entrypoint.requests.bytes.total
entrypoint.responses.bytes.total
traefik.entrypoint.requests.total
traefik.entrypoint.requests.tls.total
traefik.entrypoint.request.duration
traefik.entrypoint.connections.open
traefik.entrypoint.requests.bytes.total
traefik.entrypoint.responses.bytes.total
# Default prefix: "traefik"
{prefix}.entrypoint.request.total
{prefix}.entrypoint.request.tls.total
{prefix}.entrypoint.request.duration
{prefix}.entrypoint.connections.open
{prefix}.entrypoint.requests.bytes.total
{prefix}.entrypoint.responses.bytes.total
Router Metrics
Metric |
Type |
Labels |
Description |
Requests total |
Count |
code , method , protocol , router , service |
The total count of HTTP requests handled by a router. |
Requests TLS total |
Count |
tls_version , tls_cipher , router , service |
The total count of HTTPS requests handled by a router. |
Request duration |
Histogram |
code , method , protocol , router , service |
Request processing duration histogram on a router. |
Open connections |
Count |
method , protocol , router , service |
The current count of open connections on a router. |
Requests bytes total |
Count |
code , method , protocol , router , service |
The total size of HTTP requests in bytes handled by a router. |
Responses bytes total |
Count |
code , method , protocol , router , service |
The total size of HTTP responses in bytes handled by a router. |
traefik_router_requests_total
traefik_router_requests_tls_total
traefik_router_request_duration_seconds
traefik_router_open_connections
traefik_router_requests_bytes_total
traefik_router_responses_bytes_total
router.request.total
router.request.tls.total
router.request.duration
router.connections.open
router.requests.bytes.total
router.responses.bytes.total
traefik.router.requests.total
traefik.router.requests.tls.total
traefik.router.request.duration
traefik.router.connections.open
traefik.router.requests.bytes.total
traefik.router.responses.bytes.total
# Default prefix: "traefik"
{prefix}.router.request.total
{prefix}.router.request.tls.total
{prefix}.router.request.duration
{prefix}.router.connections.open
{prefix}.router.requests.bytes.total
{prefix}.router.responses.bytes.total
Service Metrics
Metric |
Type |
Labels |
Description |
Requests total |
Count |
code , method , protocol , service |
The total count of HTTP requests processed on a service. |
Requests TLS total |
Count |
tls_version , tls_cipher , service |
The total count of HTTPS requests processed on a service. |
Request duration |
Histogram |
code , method , protocol , service |
Request processing duration histogram on a service. |
Open connections |
Count |
method , protocol , service |
The current count of open connections on a service. |
Retries total |
Count |
service |
The count of requests retries on a service. |
Server UP |
Gauge |
service , url |
Current service's server status, 0 for a down or 1 for up. |
Requests bytes total |
Count |
code , method , protocol , service |
The total size of requests in bytes received by a service. |
Responses bytes total |
Count |
code , method , protocol , service |
The total size of responses in bytes returned by a service. |
traefik_service_requests_total
traefik_service_requests_tls_total
traefik_service_request_duration_seconds
traefik_service_open_connections
traefik_service_retries_total
traefik_service_server_up
traefik_service_requests_bytes_total
traefik_service_responses_bytes_total
service.request.total
router.service.tls.total
service.request.duration
service.connections.open
service.retries.total
service.server.up
service.requests.bytes.total
service.responses.bytes.total
traefik.service.requests.total
traefik.service.requests.tls.total
traefik.service.request.duration
traefik.service.connections.open
traefik.service.retries.total
traefik.service.server.up
traefik.service.requests.bytes.total
traefik.service.responses.bytes.total
# Default prefix: "traefik"
{prefix}.service.request.total
{prefix}.service.request.tls.total
{prefix}.service.request.duration
{prefix}.service.connections.open
{prefix}.service.retries.total
{prefix}.service.server.up
{prefix}.service.requests.bytes.total
{prefix}.service.responses.bytes.total
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" |
!!! info "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`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods)
or the [`PRI`](https://datatracker.ietf.org/doc/html/rfc7540#section-11.6) verb (for `HTTP/2`),
then the value for the method label becomes `EXTENSION_METHOD`.