Alerts and Notifications

When system stability issues arise, timely notifications can be an invaluable tool to help applications and network teams analyze anomalous situations, apply processes, and mitigate issues quickly and efficiently.

Traefik Pilot's notification system can issue alerts in near real-time for connected Traefik instances.

Configuring Alerts

Traefik Pilot's alerts are disabled by default. To enable them, toggle the switch in the top right of the current instance page.

Alerts toggle

When you enable alerts, you will be taken to a screen in your Traefik Pilot profile where you can choose the alerting options you want.

Alerts preferences

Alerts can be sent via email, using a webhook, or both.

Alert Types

Currently, Traefik Pilot offers two types of alerts for Traefik instances.

Health Checks

These alerts can offer near real-time notification when a Traefik instance has lost access to the internet.

When a Traefik instance is connected with Traefik Pilot, a built-in heartbeat mechanism will automatically begin contacting Pilot at intervals.

If Traefik is unable to reach Traefik Pilot within 5 minutes, Pilot will display the instance as unreachable in its web UI. If the instance still has not contacted Pilot after 10 minutes, it will disappear from the Traefik Pilot dashboard, and Pilot will issue a notification that connectivity was lost.

Metrics

For real-time measurement of instance health, see the section on Metrics.

Security

Like most open source software, Traefik is composed of multiple libraries, modules, and components from various sources. Inevitably, code flaws may be discovered that introduce security risks for the software.

With security alerts enabled, Traefik Pilot will periodically scan the common vulnerabilities and exposure (CVE) lists for any new vulnerabilities that may affect Traefik. If one is listed, Traefik Pilot will issue an alert to let admins know it's time to patch.