Docker Image Update Prometheus Exporter

Dieser Exporter prüft für alle laufenden Docker-Container auf dem Host, ob das jeweils verwendete Image-Tag im zugehörigen Registry ein Update aufweist (Digest-Vergleich). Das Ergebnis wird als Metrik für Prometheus exportiert und parallel als Log ausgegeben.

Features

Prüft ausschließlich Images der aktiven (laufenden) Container
Unterstützt beliebige Registries (inkl. private Registries mit Docker-Login)
Exportiert Metrik:
docker_image_update_available{container_name, image, tag}
(1 = Update vorhanden, 0 = aktuell)
Logging der Prüfungen im Terminal

Nutzung

Voraussetzungen

Docker läuft lokal
Zugriff auf /var/run/docker.sock (bei Ausführung in einem Container: Volume mount!)
Go 1.19+ (zum Selbst-Bauen)
Abhängigkeiten:
- github.com/docker/docker
- github.com/regclient/regclient
- github.com/prometheus/client_golang

Build & Run (nativ)

go build -o docker-image-exporter
./docker-image-exporter

Oder via Docker

FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o exporter .

FROM alpine
COPY --from=builder /app/exporter /usr/local/bin/exporter
ENTRYPOINT ["/usr/local/bin/exporter"]

docker build -t docker-image-exporter .
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock -p 9788:9788 docker-image-exporter

Prometheus Konfiguration

Job z.B. so eintragen:

scrape_configs:
  - job_name: 'docker_image_update'
    scrape_interval: 24h          # oder beliebiges passendes Intervall
    static_configs:
      - targets: ['localhost:9788']

Metrik-Beispiel

docker_image_update_available{container_name="/mein_container",image="nginx",tag="latest"} 1
docker_image_update_available{container_name="/db",image="postgres",tag="16"} 0

1 = Update verfügbar, 0 = kein Update nötig.

Hinweise

Für private Registries muss vorab ein docker login erfolgen.
Der Exporter prüft parallelisiert, Logging erfolgt auf der Konsole.
Es werden ausschließlich aktuell laufende Container betrachtet.
Das Intervall für Prometheus sollte je nach Anwendungsfall gewählt werden; typischerweise genügt einmal täglich.

Fragen, Bugs oder Feature-Wünsche?
Gerne im Issue-Tracker oder direkt anpassen!

2.3 KiB Raw Blame History