traefik.config.reload.total

Total configuration reloads

Dimensions:None

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

▸