https://github.com/t3easy/check_traefik
Monitoring plugin to check a Traefik instance
https://github.com/t3easy/check_traefik
Last synced: 6 months ago
JSON representation
Monitoring plugin to check a Traefik instance
- Host: GitHub
- URL: https://github.com/t3easy/check_traefik
- Owner: t3easy
- License: gpl-2.0
- Created: 2022-04-29T13:41:13.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-06-22T16:52:30.000Z (about 2 years ago)
- Last Synced: 2025-05-22T08:37:21.276Z (about 1 year ago)
- Language: Go
- Size: 47.9 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# check_traefik - a monitoring plugin to check Trafik instances
This monitoring plugin checks [Traefik](https://traefik.io/traefik/) by querying the [Ping](https://doc.traefik.io/traefik/operations/ping/) health-check URL.
## Example:
Configure your Traefik service to activate ping, e.g. in docker-compose
```yaml
services:
frontend:
image: traefik:v2.6
command:
# ...
# Enable ping and use custom routing
- --ping=true
- --ping.manualrouting=true
labels:
traefik.enable: "true"
traefik.http.middlewares.auth-monitoring.basicauth.users: monitoring:$$2y$$05$$9kDJQAJckPliR0Px7Qcxs.LRPpeC4G.cF7F87Fa1NJXW6/9YOKTLa
traefik.http.routers.ping.entrypoints: https
traefik.http.routers.ping.middlewares: auth-monitoring
traefik.http.routers.ping.rule: Host(`traefik.domain.tld`) && PathPrefix(`/ping`)
traefik.http.routers.ping.service: ping@internal
traefik.http.routers.ping.tls: "true"
```
```shell
check_traefik health -I 192.0.2.101 -H traefik.domain.tld --user="monitoring" --password="password"
```
## Coming soon:
Query the [API](https://doc.traefik.io/traefik/operations/api/#endpoints).
* Compare the response of `/api/version` against latest GitHub release or a static version.
* Check the response of `/api/overview` for total, warnings and errors.