Exposes the health of Stacks, Services, Nodes and Node Clusters from the Docker Cloud API, to a Prometheus compatible endpoint.
The application can be run in a number of ways, the main consumption is the Docker hub image infinityworksltd/docker-cloud-exporter
.
Required
DOCKERCLOUD_USER
// Username of your docker cloud accountDOCKERCLOUD_APIKEY
// Generated through the docker cloud admin interface
Optional
DOCKERCLOUD_NAMESPACE
// Specify this if you wish to show metrics for an organisation your user has access to. Specify the name of the org in this env var.METRICS_PATH
// Path under which to expose metrics.LISTEN_PORT
// Port on which to expose metrics. Defaults to 9174LOG_LEVEL
// Optional - Set the logging level, defaults to Info
Run manually from Docker Hub:
docker run -d -e DOCKERCLOUD_USER="XXXXXXXX" -e DOCKERCLOUD_APIKEY="XXXXXXX" -p 9174:9174 infinityworks/docker-cloud-exporter
Build a docker image:
docker build -t <image-name> .
docker run -d -e DOCKERCLOUD_USER="XXXXXXXX" -e DOCKERCLOUD_APIKEY="XXXXXXX" -p 9174:9174 <image-name>
docker-cloud-exporter:
tty: true
stdin_open: true
environment:
- DOCKERCLOUD_USER="xxxx"
- DOCKERCLOUD_APIKEY="xxxxxx"
expose:
- 9174:9174
image: infinityworks/docker-cloud-exporter:latest
Metrics will be made available on port 9174 by default, or you can pass environment variable LISTEN_ADDRESS
to override this.
An example printout of the metrics you should expect to see can be found in METRICS.md
.