check_traefik

README

check_traefik - a monitoring plugin to check Trafik instances

This monitoring plugin checks Traefik by querying the Ping health-check URL.

Example:

Configure your Traefik service to activate ping, e.g. in docker-compose

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"

check_traefik health -I 192.0.2.101 -H traefik.domain.tld --user="monitoring" --password="password"

Coming soon:

Query the API.

• 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.

Documentation

Overview

Copyright © 2022 Jan Kiesewetter <jan@t3easy.de>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.