Difference between revisions of "Chronograf Integration"

Revision as of 19:28, 12 January 2021

Overview

QuantaStor has numerous real-time stats dashboards built into the main web management user interface that cover what most users and administrators need. In some cases though it can be useful to have visibility into other metrics and to be able to setup custom dashboards for visualizing performance and other historical storage information. QuantaStor internally uses Telegraf and InfluxDB to collect and store real-time stats and these can be easily used by other open source dashboard systems like Chronograf to make custom displays. The following instructions go over how to setup Chronograf with QuantaStor so that these advanced dashboards may be setup.

How to Install Chronograf for Performance Monitoring

1. Go to the Chronograf download page: https://portal.influxdata.com/downloads
2. Click the version button under the Chronograf section (for example, "v1.7.12" button) and navigate to the "Unbuntu & Debian" install section.
3. Follow the instructions in the "Unbuntu & Debian" install section on the desired QuantaStor system.

   For example,

   wget https://dl.influxdata.com/chronograf/releases/chronograf_1.8.9.1_amd64.deb

   sudo dpkg -i chronograf_1.8.9.1_amd64.deb

4. Record the InfluxDB "username" and "password" for the QuantaStor system by executing: cat /etc/telegraf/telegraf.conf

   Your will see the InfluxDB credentials in the telegraf.conf file.

5. Launch Chronograf in Chrome: http://ip-address-of-where-you-installed-chronograf:8888

   For example,

   http://10.0.16.60:8888

6. Enter the InfluxDB credentials you recorded when prompted.

To see a system context diagram of Telegraf+InfluxDB+Chronograf please see: https://www.influxdata.com/time-series-platform/chronograf/

You are now ready to create a custom QuantaStor dashboard using Chronograf!

How to Create a Chronograf Custom Dashboard

1. Launch Chronograf in Chrome: http://ip-address-of-where-you-installed-chronograf:8888
2. Enter the InfluxDB credentials you recorded when prompted.
3. Click the Dashboards Menu/Icon
4. Click "+ Create Dashboard" button
5. Name your dashboard by typing over the "Name This Dashboard" text
6. Click "+ Add Data" or "+ Add Cell" button"
7. Click quantastor.quantastor
8. Select what you want to monitor in "ceph" and title your graph by replacing the "Untitled Graph" text

   For example, title your graph using the names of the fields you select for monitoring.

9. Click the ""Visualization"" button to change chart types
10. Change sample time in the dropdown combo in upper RHS. e.g. Change "Past 5m" to "Past 24h"

For additional information, see:

• Creating a dashboard tutorial- https://docs.influxdata.com/chronograf/v1.7/guides/create-a-dashboard/
• Hiding regions in a dashboard- https://docs.influxdata.com/chronograf/v1.7/guides/presentation-mode/
• Using pre-created dashboards- https://docs.influxdata.com/chronograf/v1.7/guides/using-precreated-dashboards/
• Gettings started with pre-created dashboards- https://dzone.com/articles/how-predefined-dashboards-in-influxdatas-chronogra
• Advanced: Chronograf and Dashboarding- https://www.influxdata.com/training/advanced-chrongraf-and-dashboarding/?aliId=eyJpIjoiTkJ1ZkxjaG44R3FFVElHTSIsInQiOiJKRVNhSmpNR2RiRklmR2RyY2FqRzJRPT0ifQ%253D%253D

Chronograf JSON Details

1. Get and Post Chronograf Dashboards Examples:

   https://www.influxdata.com/blog/chronograf-dashboard-definitions/

2. Chronograf API:

   https://aapi.io/apis/api/InfluxData_InfluxDataChronograf_ChronografAPI_1.3.10.0/#explore