content.md 2.0 KB

Chronograf

Chronograf is a simple to install graphing and visualization application that you deploy behind your firewall to perform ad-hoc exploration of your InfluxDB data. It includes support for templates and a library of intelligent, pre-configured dashboards for common data sets.

%%LOGO%%

Using this image

Running the container

Chronograf runs on port 8888. It can be run and accessed by exposing that port:

$ docker run -p 8888:8888 chronograf

Mounting a volume

The Chronograf image exposes a shared volume under /var/lib/chronograf, so you can mount a host directory to that point to access persisted container data. A typical invocation of the container might be:

$ docker run -p 8888:8888 \
      -v $PWD:/var/lib/chronograf \
      chronograf

Modify $PWD to the directory where you want to store data associated with the InfluxDB container.

You can also have Docker control the volume mountpoint by using a named volume.

$ docker run -p 8888:8888 \
      -v chronograf:/var/lib/chronograf \
      chronograf

Using the container with InfluxDB

The instructions here are very similar to the instructions when using telegraf with influxdb. These examples assume you are using Docker's built-in service discovery capability. In order to do so, we'll first create a new network:

$ docker network create influxdb

Next, we'll start our InfluxDB container named influxdb:

$ docker run -d --name=influxdb \
      --net=influxdb \
      influxdb

We can now start a Chronograf container that references this database.

$ docker run -p 8888:8888 \
      --net=influxdb
      chronograf --influxdb-url=http://influxdb:8086

Try combining this with Telegraf to get dashboards for your infrastructure within minutes!

Official Documentation

See the official docs for information on creating visualizations.