Bar, Line and Area Visualizations

Bar, Line and Area Visualizations for Logs and Traces

The bar, line and area Visualization in Circonus is designed for the display of log and trace data. Bar charts are often used for comparison, where line and area charts are used to show trends over time.

If you want to display Circonus metric time series (from the Integrations library) please use the Time Series Builder.

Working with bar, line and area charts

To use the bar, line or area you will you first need to select the metrics which define your X and Y axis and values.

Y-axis metrics

Y-axis Metric Aggegations

You define multiple values for the Y-axis by clicking on the + Add at the bottom of the Metrics Y-axis panel. This allows you to define Y-axis value or dot size.

To define your Y-axis values:

  1. Select Y-axis aggregation.

    There are multiple aggregations that can be applied to the Y-axis field like:

  1. Select the field that the aggregation is to be applied to.

  2. Enter a string in the Custom Label field to change the display label.

The > Advanced option allows you to create the query using JSON this recommended for advanced users only.

For an explanation of all available Y-axis aggreggations see: Metric Aggregations.

X-axis buckets

The X-axis of this chart is the buckets axis. You define buckets for the X-axis, for a split area on the chart, or for split charts.

X-axis Bucket Aggegations

The buckets aggregations determine what information is being retrieved from your data set.

Before you choose a buckets aggregation, decide if you are splitting slices within a single chart or splitting into multiple charts. A multiple chart split must run before any other aggregations.

When you split a chart, you can change if the splits are displayed in a row or a column by clicking the Rows | Columns selector.

This chart uses a bucket aggregation known as Sibling Pipeline aggregation.

Types of aggregations available for the X-axis of the bar, line and area charts are:

Filters

If you selected Filters as your aggregation for the Y-Axis. You can specify a set of filters for the data. You can specify a filter as a DQL query string, Lucene syntax or in JSON format, just as in the Logs Explorer search bar. Both the use of Lucene and JSON are recommended only for advanced users.

Click + Add Filter to add another filter. Click the Label button to open the label field, where you can type in a name to display on the visualization. You’ll find the Label button above the DQL button.

Sub-aggregations

Once you’ve specified an X-axis aggregation, you can define sub-aggregations to refine the visualization. Click + Add to define a sub-aggregation, then choose Split Area or Split Chart, then select a sub-aggregation from the list of types.

When multiple aggregations are defined on a chart’s axis, you can use the up or down arrows to the right of the aggregation’s type to change the aggregation’s priority.

Enter a string in the Custom Label field to change the display label.

Chart Color Picker

You can customize the colors of your visualization by clicking the color dot next to each label to display the color picker.

You can click the Advanced link to display more customization options for your metrics or bucket aggregation:

  • JSON Input is a text field where you can add specific JSON-formatted properties to merge with the aggregation definition, as in the following example:
{ "script" : "doc['grade'].value * 1.2" }

Use of the JSON Input is recommended for advanced users only.

The availability of these options varies depending on the aggregation you choose.

Metrics & axes

Select the Metrics & Axes tab to change the way each individual metric is shown on the chart. The data series are styled in the Metrics section, while the axes are styled in the X and Y axis sections.

Metrics Modify how each metric from the Data panel is visualized on the chart.

  • Chart type allows you to choose between Area, Line, and Bar types.

  • Mode allows you to choose whether to stack the different metrics, or plot them next to each other.

  • Value Axis allows you to choose the axis you want to plot this data too (the properties of each are configured under Y-axes).

  • Line mode allows you to choose whether the outline of lines or area charts appear smooth, straight, or stepped.

Y-axis Style all the Y-axes of the chart.

  • Position is the Y-axis (left or right for vertical charts, and top or bottom for horizontal charts).

  • Mode defaults to normal, but you can select Silhouette, wiggle or percentage.

  • Scale type scaling of the values (linear, log, or square root).

  • Title allows you to set the title of axis. If defaults to the metric name.

  • Show Labels allows you to hide axis labels.

  • If Filter Labels is enabled some labels will be hidden in case there is not enough space to display them.

  • Align allow you to enter the number in degrees for how much you want to rotate labels.

  • Truncate allows you to enter the size in pixels to which the label is truncated.

Custom extents

  • Scale to data bounds You can check this box if you want to change both upper and lower bounds defaults for the Y-axis (which fare zero and maximum) to match the values returned in the data.

  • Set axis extents allow you to define custom minimum and maximum for each axis.

X-axis

  • The Position of the X-Axis (left or right for horizontal charts, and top or bottom for vertical charts).

  • Show axis lines and labels allows you to hide axis labels.

  • Show labels allows you to hide labels.

  • Filter Labels is enabled some labels will be hidden in case there is not enough space to display them.

  • Align allows you to enter the number in degrees for how much you want to rotate labels.

  • Truncate allows you to enter the size in pixels by which the label is truncated.

Panel Settings

These settings apply to the entire chart and not just the individual data series.

Settings

  • Show Tooltip allows you to enable or disable the display of tooltip on hovering over chart objects.
  • Current Time Marker shows a line that indicates the current time.
  • Show values on chart allows you to display value on charts.

Grid options

You can enable grid on the chart. By default grid is displayed on the category axis only.

  • X-axis allows you to disable the display of grid lines on category axis.

  • Y-axis allows you to choose on which (if any) of the value axes you want to display grid lines.

Threshold line

Allows you to enable a Threshold line, you can choose the threshold value, the line weight, style (Full, Dashed, Dot-dashed) and the color.


Next: Maps