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

By default, Chronograf listens on port 10000 and stores its data in a volume at /var/lib/chronograf. You can start an instance with:

$ docker run -p 10000:10000 chronograf

You can also use a custom configuration file or environment variables to modify Chronograf settings.

Using a custom config file

A sample configuration file can be obtained by:

$ docker run --rm chronograf -sample-config > chronograf.toml

Once you've customized chronograf.conf, you can run the Chronograf container with it mounted in the expected location (note the name change!):

$ docker run -d \
      -p 10000:10000 \
      -v /path/to/chronograf.toml:/opt/chronograf/config.toml

Using environment variables (preferred)

You may have noticed that the default Bind value in the configuration is set to 127.0.0.1:10000, though the container will listen on 0.0.0.0:10000 instead. This is due to a CHRONOGRAF_BIND environment variable being set in the Dockerfile to provide a sensible default within the Docker context. Other environment variables can override configuration settings following the CamelCase to CHRONOGRAF_CAMEL_CASE pattern:

SETTING ENV VAR
Bind CHRONOGRAF_BIND
LocalDatabase CHRONOGRAF_LOCAL_DATABASE
QueryResponseBytesLimit CHRONOGRAF_QUERY_RESPONSE_BYTES_LIMIT

Official Documentation

See the official docs for information on creating visualizations.