docker_state_exporter

Docker State Exporter

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.

Installation and Usage

The docker_state_exporter listens on HTTP port 8080 by default.

Docker

For Docker run.

docker run -d \
  -v "/var/run/docker.sock:/var/run/docker.sock:ro" \
  -p 127.0.0.1:8080:8080 \
  danarmor/docker_state_exporter \
  -listen-address=:8080

For Docker compose.

---
version: '3.8'

services:
  docker_state_exporter:
    image: danarmor/docker_state_exporter
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:8080:8080"

Metrics

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

These metrics will be the same as the results of docker inspect.

This exporter also exports the standard Go Collector and Process Collector.

Caution

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.

Development building and running

I am running this application on Docker (linux/amd64). I have not tested it in any other environment.

Build

git clone https://github.com/DanArmor/docker_state_exporter
cd docker_state_exporter
docker build -t docker_state_exporter_test .

Run

docker run -d \
  -v "/var/run/docker.sock:/var/run/docker.sock:ro" \
  -p 127.0.0.1:8080:8080 \
  docker_state_exporter_test \
  -listen-address=:8080

Why this fork created:

Original exporter doesn't provide exit code metric, this fork does. Also some improvements here and there.