Metrics

Traefik supports 4 metrics backends:

Global Metrics

MetricDataDogInfluxDBPrometheusStatsD
Configuration reloads
Last Configuration Reload Success
TLS certificates expiration

Configuration Reloads

The total count of configuration reloads.

Datadog

  1. config.reload.total

InfluxDB

  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

  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

  1. traefik.tls.certs.notAfterTimestamp

Prometheus

  1. traefik_tls_certs_not_after

StatsD

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

EntryPoint Metrics

MetricDataDogInfluxDBPrometheusStatsD
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

  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

  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

  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

  1. traefik.entrypoint.connections.open

Prometheus

  1. traefik_entrypoint_open_connections

StatsD

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

Router Metrics

MetricDataDogInfluxDBPrometheusStatsD
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

  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

  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

  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

  1. traefik.router.connections.open

Prometheus

  1. traefik_router_open_connections

StatsD

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

Service Metrics

MetricDataDogInfluxDBPrometheusStatsD
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

  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

  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

  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

  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

  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

  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.