Frequently asked questions (FAQ)

Known Issues

What applications are supported in Chronograf?

Chronograf offers pre-created dashboards for several Telegraf input plugins/applications. We list those applications below and link to their Telegraf documentation:

Enable and disable applications in your Telegraf configuration file. See the Telegraf Configuration documentation for more information.

How do I connect Chronograf to an InfluxEnterprise cluster?

The connection details form requires additional information when connecting Chronograf to an InfluxEnterprise cluster.

When you enter the InfluxDB HTTP bind address in the Connection String input, Chronograf automatically checks if that InfluxDB instance is a data node. If it is a data node, Chronograf automatically adds the Meta Service Connection URL input to the connection details form. Enter the HTTP bind address of one of your cluster’s meta nodes into that input and Chronograf takes care of the rest.

Cluster connection details

Note that the example above assumes that you do not have authentication enabled. If you have authentication enabled, the form requires username and password information. For more details about monitoring an InfluxEnterprise cluster, see the Monitor an InfluxEnterprise Cluster guide.

What visualization types does Chronograf support?

Chronograf’s dashboards support six visualization types.

Line

Show time series in a line graph.

Cluster connection details

Stacked

Show time series arranged on top of each other.

Cluster connection details

Step-Plot

Show time series in a staircase graph.

Cluster connection details

SingleStat

Show the most recent value of a time series.

Cluster connection details

If a cell’s query includes a GROUP BY tag clause, Chronograf sorts the different series lexicographically and shows the most recent field value associated with the first series. For example, if a query groups by the name tag key and name has two tag values (chronelda and chronz), Chronograf shows the most recent field value associated with the chronelda series.

If a cell’s query includes more than one field key in the SELECT clause, Chronograf returns the most recent field value associated with the first field key in the SELECT clause. For example, if a query’s SELECT clause is SELECT "chronogiraffe","chronelda", Chronograf shows the most recent field value associated with the chronogiraffe field key.

Line+Stat

Show time series in a line graph and overlay the time series’ single most recent value.

Cluster connection details

Bar

Show time series in a bar chart. Bar graphs are available in versions 1.3.3.0+.

Cluster connection details

What does the status column indicate on the Host List page?

The status icon is a high-level measure of your host’s health. If Chronograf has not received data from a host for the past minute, the status icon is red. If Chronograf has received data from a host within the past minute, the status icon is green.

Why is my host’s status red when data are still arriving?

There are several possible explanations for an inaccurate red status icon:

The status icon depends on your host’s local time in UTC. Use the Network Time Protocol (NTP) to synchronize time between hosts; if the hosts’ clocks aren’t synchronized with NTP, the status icon can be inaccurate.

The status icon turns red when Chronograf has not received data from a host for the past minute. Chronograf uses data from Telegraf to perform that calculation. By default, Telegraf sends data in ten-second intervals; you can change that interval setting in Telegraf’s configuration file. If you configure the setting to an interval that’s greater than one minute, Chronograf assumes that the host is not reporting data and changes the status icon to red.

Why does the query builder break after I add my template variable to a query?

Currently, adding a template variable to a cell’s query renders the query builder unusable. If you click on a database in the builder’s Databases column after adding a template variable to your query, Chronograf simply overwrites your existing query. Note that this behavior does not apply to Chronograf’s pre-created template variable: :dashboardTime:.

This is a known issue and it will be fixed in a future release.

This documentation is open source. See a typo? Please, open an issue.


Need help getting up and running? Get Support