Technologies/Traefik/traefik.config.reload.total
TraefikTraefikMetric

traefik.config.reload.total

Total configuration reloads
Dimensions:None
Available on:PrometheusPrometheus (1)DatadogDatadog (1)Native (1)
Interface Metrics (3)
PrometheusPrometheus
Total number of configuration reloads
Dimensions:None
DatadogDatadog
Total count of configuration reloads
Dimensions:None
Native
Total number of configuration reloads
Dimensions:None
Sources
traefik_config_reloads_totaldoc.traefik.io
traefik.config.reload.totaldocs.datadoghq.com
traefik.config.reload.totaldoc.traefik.io

Technical Annotations (39)

Configuration Parameters (5)
--providers.dockerrecommended: true
Enables Docker provider to watch for container events
providers.file.watchrecommended: true
Enables configuration file watching, but requires directory mounting in Docker to function properly
providersThrottleDurationrecommended: tune per-provider in 2.7+
Controls throttling of configuration updates from providers
providers.file.filename
Problematic approach that fails to detect changes with Docker volume mounts
providers.file.directory
Working alternative that properly detects file changes in mounted directories
Error Signatures (1)
502 Bad Gatewayhttp status
CLI Commands (6)
docker events --since 5m --filter type=container --filter event=startdiagnostic
docker exec -it traefik sh -lc 'ls -l /var/run/docker.sock'diagnostic
docker compose configdiagnostic
docker logs traefik --since 15mdiagnostic
--providers.file.filename=/config/dynamic.ymldiagnostic
--log.level=DEBUGdiagnostic
Technical References (27)
/var/run/docker.sockfile pathDocker providercomponentconfiguration channelcomponentprovider APIcomponentfile providercomponentorchestratorconceptserver list refreshconceptconfiguration flappingconceptconfiguration watchercomponentKubernetescomponentTLS ALPN acme challengecomponentcertificate renewalconceptcert-managercomponentpreLoadConfigurationcomponentinotifycomponentloadConfigurationcomponentIngressRoutecomponentdynamic configconceptKubernetes CRDcomponentSIGHUPconceptConfigMapcomponentmiddlewarecomponentstopChancomponentServer structcomponentsafe packagecomponentfs notifyconceptdynamic.ymlfile path
Related Insights (14)
Configuration changes not applied due to missed redeployment or socket permissionswarning
▸
Configuration channel throttling drops error messages affecting metric reliabilitywarning
▸
Dynamic configuration file changes not detected when file is directly mounted in Dockerwarning
▸
Configuration reload causes transient 502 errors during server list refreshwarning
▸
Configuration flapping causes unnecessary costly reloadswarning
▸
High provider configuration input prevents reloadswarning
▸
Global providersThrottleDuration delays ACME certificate renewalwarning
▸
TLS certificate updates not detected without configuration file modificationcritical
▸
Long-lived connections retain old config versions causing memory bloat during frequent reloadswarning
▸
Large route configurations consume excessive memory during reload operationswarning
▸
TLS certificate renewal requires manual reload with read-only file providercritical
▸
Touch-based file provider reload fails with read-only ConfigMap mountswarning
▸
Goroutines leak in custom middlewares during config reloadwarning
▸
File provider configuration reload fails with mounted files in Dockerwarning
▸