Exploring the Telegraf Database via Chronograf

One of the easiest ways to explore the data being written to your InfluxCloud account is through your browser using Chronograf.

1. Launch Chronograf

Start by clicking the Launch Chronograf button from the subscription management page.

The following page appears:

Next, click on the Login with Auth0 button and you will be presented with a login page (shown below) which prompts you for a username and password.

Use the credentials you provided to create your account during the sign-up process. These are the same credentials that you use to sign into InfluxCloud here: https://cloud.influxdata.com/

The login credentials being requested here are NOT the same admin credentials for the InfluxCloud. Those are used to connect Chronograf, Influx CLI or your custom application to your InfluxCloud instance. Within Chronograf, these have been used to automatically configure an InfluxDB Source which you will see later.


2. Explore Telegraf data with Query Explorer

After logging into Chronograf, you will see a Status page with some information about what is happening in your InfluxCloud account. Along the left side of the screen, you will see a menu with a few different icons. Hovering over them will popup menu options that you can choose from. To get to the query explorer, select the icon 3rd from the top that looks like a small line graph.

It looks pretty empty now, but you can start exploring your data by clicking the Add a Query button in the center of the screen. This will open up a new Query Editor which will allow you to start interactively building a new InfluxQL query.

Underneath the query window, you will see three columns labeled Databases, Measurements, and Fields. By default, Telegraf will insert your new data into a database called telegraf with a retention policy named autogen. Chronograf combines these in this column so it looks like telegraf.autogen, exactly how you would reference it when writing your InfluxQL query. Selecting that database will populate the Measurements column with a list of all the measurements available in that database (this is equivalent to running the SHOW MEASUREMENTS command in the InfluxCLI).

Select the cpu measurement to reveal the tags associated with that measurement. You can select one or more of the tags which will populate the final Fields column with the list of the available values with that tag. Let’s select the cpu-total tag and the usage_idle field. Now you should see a graph of usage_idle vs time displayed below your selection as well as an InfluxQL query that is populated above.


3. Functions and Grouping

By default, the field is graphed using the mean function. To change this (or add additional functions), click on the 1 Function button next to the usage_idle field and select the functions you’d like to graph. You can also select no functions to see just the raw data.

You’ll also notice that the data has been grouped into 10s buckets by default. You can change this by selecting the Group by 10s dropdown next to the Fields label and selecting a different group by.

Of course, all of these changes can also be done manually by editing the InfluxQL query that was generated for you.

You’ve now successfully explored Telegraf data with Chronograf in InfluxCloud. To learn more about the system metrics Telegraf is sending to your instance or cluster, as well as more information about what you can do with Telegraf see our Telegraf documentation. For more information about Chronograf, see our Chronograf documentation.