Manage the Charts Page

Add a Chart

The configuration model for charts is to create graph panels and group them into one or more canvases.

To create a new graph panel on a canvas:

1. Navigate to the Monitoring > Graphs > Charts page.

   The Charts page appears.

2. Do any one of the following:

   • To create a graph in a new canvas, click + New Canvas.

   • To create a graph within an existing canvas, select the desired canvas from the saved canvases and then click Add Graph +.

3. In the General section, provide the general descriptive information for the canvas (new canvas only) and graph:

   Attribute	Description
   Canvas Name	Enter a name for the canvas.
   Description	(Optional) Enter a description for the canvas.
   Graph Name	Enter a name for the graph.
   Graph Type	Select the type of graph from the drop-down list. Options include Time Series, Histogram, and Heatmap.
   Time Range	Choose the time range for the graph. In real-time graphs, the time range sets the x-axis range. For example, selecting 12 hrs means the x-axis shows the last 12 hours of data.

4. Move down to the Query section. In the From section, define from where the data for the graph is coming:

   Attribute	Description
   Group	Choose the device group or network group.
   Device	Choose a device from the group.
   Topic / Rule	Choose the Paragon Insights topic/rule name. You can choose rolled-up measurements of fields you configured in rules. The rolled-up measurements are displayed in the list as topic/rule_roll-up-order. For example, my-rule_hourly and my-rule_yearly. The roll-up measurement’s fields are listed as original-field-name_aggregation-type. For example, field-name_count and field-name_mean. Rolled-up measurements use aggregate functions on field data collected over a time to summarize the data into a single data point. You can configure how frequently the field data must be rolled-up or summarized. The default roll-up order (frequency) available in Paragon Automation are daily, hourly, monthly, weekly, or yearly.

5. In the Select section, select the data field and apply aggregation and transformation types to the data:

   Attribute	Description
   Field	Choose a field name. This list is derived based on the fields defined in the selected topic/rule.
   Aggregation	(Optional) In the drop-down list, choose a data aggregation type.
   Transformation	(Optional) In the drop-down list, choose a data transformation type.

6. In the Where section, filter data based on field and KPI key:

   Attribute	Description
   Tag Key / Field	(Optional) Choose a key or field. A key is an index field such as interface name. This list is derived based on the keys and fields defined in the selected topic/rule. You can set a maximum of two tags with WHERE conditions. You can use the AND option to satisfy both conditions and use OR option to satisfy either of the conditions you define.
   Condition	Choose the conditional for the WHERE statement such as greater than, less than, matches with, equal to, and so on. The condition is used to check the right operand input against the left operand value.

7. In the Group By section, specify how to group the data based on time interval, fill, and KPI keys:

   Attribute	Description
   $_interval	(Optional) Specify a time interval by which to group the data. If you set the time interval in GROUP BY field as $_interval, then Grafana sets the time interval for data aggregation based on the number of points received in TSDB.
   fill(null)	(Optional) Choose how to show a time interval when no data arrives from the device: null (default) Report the timestamp and null as the output value. none Report no timestamp and no output value. 0 Report 0 as the output value. previous Report the value from the previous time interval as the output value. linear Report the results of linear interpolation as the output value.
   Tag Key (the + icon)	(Optional) Choose a tag by which to group the data. A key is an index field such as interface name. This list is derived based on the keys and fields defined in the selected topic/rule.

8. (Optional) Move down to the Visualization section, and define y-axis details.

   You can enter the minimum value, maximum value, and label for y-axis. You can also choose a unit for y-axis such as bytes, Kilobytes, parts per million, and so on.

9. Click Save to save the graph and display the data.

Tip:

You can use the following tips when working with graphs:

• To sort canvases on the Saved Canvas page, click on the column headings.

• To reorganize graphs on the screen, hover your mouse near the upper-left corner of a graph panel and click-and-drag it to the desired position.

• To resize a graph, hover your mouse over the lower-right corner of the graph panel and click-and-drag it to the desired size.

• To change the color of graph elements, click the color bar for the desired line item under the graph.

• To zoom in on a graph, click and drag across the desired section of the graph; to zoom out, double-click on the graph.

• To isolate an element on the graph, click its related line item under the graph; to view all elements again, click the same line item.

Edit or Delete Charts

In the Graph canvas, you can edit or delete a chart or delete a canvas.

• To edit a chart, click the pencil icon located in the top right corner of the chart itself.

• To delete a chart, click the trash can icon located in the top right corner of the chart itself.

• To delete a canvas, click the trash can icon located in the top right corner of the canvas.