Metrics

Traefik supports 4 metrics backends:

Global Metrics

MetricDataDogInfluxDB / InfluxDB2PrometheusStatsD
Configuration reloads
Last Configuration Reload Success
TLS certificates expiration

Configuration Reloads

The total count of configuration reloads.

Datadog

  1. config.reload.total

InfluxDB / InfluxDB2

  1. traefik.config.reload.total

Prometheus

  1. traefik_config_reloads_total

StatsD

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

Last Configuration Reload Success

The timestamp of the last configuration reload success.

Datadog

  1. config.reload.lastSuccessTimestamp

InfluxDB / InfluxDB2

  1. traefik.config.reload.lastSuccessTimestamp

Prometheus

  1. traefik_config_last_reload_success

StatsD

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

TLS certificates expiration

The expiration date of certificates.

Labels: cn, sans, serial.

Datadog

  1. tls.certs.notAfterTimestamp

InfluxDB / InfluxDB2

  1. traefik.tls.certs.notAfterTimestamp

Prometheus

  1. traefik_tls_certs_not_after

StatsD

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

EntryPoint Metrics

MetricDataDogInfluxDB / InfluxDB2PrometheusStatsD
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

  1. entrypoint.request.total

InfluxDB / InfluxDB2

  1. traefik.entrypoint.requests.total

Prometheus

  1. traefik_entrypoint_requests_total

StatsD

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

HTTPS Requests Count

The total count of HTTPS requests received by an entrypoint.

Labels: tls_version, tls_cipher, entrypoint.

Datadog

  1. entrypoint.request.tls.total

InfluxDB / InfluxDB2

  1. traefik.entrypoint.requests.tls.total

Prometheus

  1. traefik_entrypoint_requests_tls_total

StatsD

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

Request Duration Histogram

Request processing duration histogram on an entrypoint.

Labels: code, method, protocol, entrypoint.

Datadog

  1. entrypoint.request.duration

InfluxDB / InfluxDB2

  1. traefik.entrypoint.request.duration

Prometheus

  1. traefik_entrypoint_request_duration_seconds

StatsD

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

Open Connections Count

The current count of open connections on an entrypoint.

Labels: method, protocol, entrypoint.

Datadog

  1. entrypoint.connections.open

InfluxDB / InfluxDB2

  1. traefik.entrypoint.connections.open

Prometheus

  1. traefik_entrypoint_open_connections

StatsD

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

Router Metrics

MetricDataDogInfluxDB / InfluxDB2PrometheusStatsD
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

  1. router.request.total

InfluxDB / InfluxDB2

  1. traefik.router.requests.total

Prometheus

  1. traefik_router_requests_total

StatsD

  1. # Default prefix: "traefik"
  2. {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

  1. router.request.tls.total

InfluxDB / InfluxDB2

  1. traefik.router.requests.tls.total

Prometheus

  1. traefik_router_requests_tls_total

StatsD

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

Request Duration Histogram

Request processing duration histogram on a router.

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

Datadog

  1. router.request.duration

InfluxDB / InfluxDB2

  1. traefik.router.request.duration

Prometheus

  1. traefik_router_request_duration_seconds

StatsD

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

Open Connections Count

The current count of open connections on a router.

Labels: method, protocol, router, service.

Datadog

  1. router.connections.open

InfluxDB / InfluxDB2

  1. traefik.router.connections.open

Prometheus

  1. traefik_router_open_connections

StatsD

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

Service Metrics

MetricDataDogInfluxDB / InfluxDB2PrometheusStatsD
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

  1. service.request.total

InfluxDB / InfluxDB2

  1. traefik.service.requests.total

Prometheus

  1. traefik_service_requests_total

StatsD

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

HTTPS Requests Count

The total count of HTTPS requests processed on a service.

Labels: tls_version, tls_cipher, service.

Datadog

  1. router.service.tls.total

InfluxDB / InfluxDB2

  1. traefik.service.requests.tls.total

Prometheus

  1. traefik_service_requests_tls_total

StatsD

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

Request Duration Histogram

Request processing duration histogram on a service.

Labels: code, method, protocol, service.

Datadog

  1. service.request.duration

InfluxDB / InfluxDB2

  1. traefik.service.request.duration

Prometheus

  1. traefik_service_request_duration_seconds

StatsD

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

Open Connections Count

The current count of open connections on a service.

Labels: method, protocol, service.

Datadog

  1. service.connections.open

InfluxDB / InfluxDB2

  1. traefik.service.connections.open

Prometheus

  1. traefik_service_open_connections

StatsD

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

Requests Retries Count

The count of requests retries on a service.

Labels: service.

Datadog

  1. service.retries.total

InfluxDB / InfluxDB2

  1. traefik.service.retries.total

Prometheus

  1. traefik_service_retries_total

StatsD

  1. # Default prefix: "traefik"
  2. {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

  1. service.server.up

InfluxDB / InfluxDB2

  1. traefik.service.server.up

Prometheus

  1. traefik_service_server_up

StatsD

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

Labels

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

LabelDescriptionexample
cnCertificate Common Name“example.com”
codeRequest code“200”
entrypointEntrypoint that handled the request“example_entrypoint”
methodRequest Method“GET”
protocolRequest protocol“http”
routerRouter that handled the request“example_router”
sansCertificate Subject Alternative NameS“example.com”
serialCertificate Serial Number“123…”
serviceService that handled the request“example_service@provider”
tls_cipherTLS cipher used for the request“TLS_FALLBACK_SCSV”
tls_versionTLS version used for the request“1.0”
urlService server urlhttp://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.