I don't maintain this repository very well, so please fork and use this.
Exporter for docker container state
Prometheus exporter for docker container state, written in Go.
One of the best known exporters of docker container information is cAdvisor.
However, cAdvisor does not export the state of the container.
This exporter will only export the container status and the restarts count.
The docker_state_exporter
listens on HTTP port 8080 by default.
For Docker run.
sudo docker run -d \
-v "/var/run/docker.sock:/var/run/docker.sock" \
-p 8080:8080 \
karugaru/docker_state_exporter \
-listen-address=:8080
For Docker compose.
---
version: '3.8'
services:
docker_state_exporter:
image: karugaru/docker_state_exporter
volumes:
- type: bind
source: /var/run/docker.sock
target: /var/run/docker.sock
ports:
- "8080:8080"
This exporter will export the following metrics.
- container_state_health_status
- container_state_status
- container_state_oomkilled
- container_state_startedat
- container_state_finishedat
- container_restartcount
These metrics will be the same as the results of docker inspect.
This exporter also exports the standard Go Collector and Process Collector.
This exporter will do a docker inspect every time prometheus pulls.
If a large number of requests are made, there will be performance issues. (I think. Not verified.)
So, this app caches the result of docker inspect for 1 second.
So, please note that if you set the scrape_interval of prometheus to less than one second, you may get the same result back.
I am running this application on Docker (linux/amd64). I have not tested it in any other environment.
git clone https://github.com/karugaru/docker_state_exporter
cd docker_state_exporter
sudo docker build -t docker_state_exporter_test .
sudo docker run -d \
-v "/var/run/docker.sock:/var/run/docker.sock" \
-p 8080:8080 \
docker_state_exporter_test \
-listen-address=:8080