OpenStack-Exporter

Simple Prometheus exporter for OpenStack.

Build

First clone the repo, and execute Makefile using make tool:

$ git clone https://github.com/iGene/openstack-exporter.git $GOPATH/src/github.com/iGene/openstack-exporter
$ cd $GOPATH/src/github.com/iGene/openstack-exporter
$ make

A Dockerfile is provided in this repo, to build a OpenStack Exporter Docker image, simply run:

$ make build_image

Or to use a pre-built image, pull it from Docker Hub

$ docker pull igenetw/openstack-exporter

Deployment

Configuring OpenStack exporter can be done in 3 ways, choose the one that is suitable for your environment:

1. Configuration File:

$ cp openstack.toml.example openstack.toml
$ docker run -d -p 9183:9183  \
      -v $(pwd)/openstack.toml:/etc/openstack-exporter/openstack.toml \
      --name openstack-exporter \
      igenetw/openstack-exporter:v0.1.0 --config /etc/openstack-exporter/openstack.toml

2. Command line option:

$ docker run -d -p 9183:9183  \
      --name openstack-exporter \
      igenetw/openstack-exporter:v0.1.0 \
      --keystone-url=http://172.22.132.21/identity/v3 \
      --project-name=admin \
      --username=admin \
      --password=secret \
      --domain-name=default \
      --region-name=RegionOne

3. Environment variables:

$ cp -rp openrc.example openrc
$ docker run -d -p 9183:9183  \
      --env-file=openrc \
      --name openstack-exporter \
      igenetw/openstack-exporter:v0.1.0

Check if its working by:

$ curl localhost:9183/metrics