Data visualization settings

To configure a custom dashboard widget, you must select a chart type. Additional configuration fields appear based on the chart type that you select.

For more information about the configuration fields for each chart type, see:

Area chart

This chart type has these configuration fields:

Field

Description

Order by

The sort order of data points horizontally.

You cannot change this configuration. In this chart type, the x-axis is a timeline and data points are ordered chronologically.

Aggregation
How to aggregate data. Select one of these options:
  • Count — Counts the total number of rows in the returned dataset.
  • Max — Returns the maximum value in the field that you specify.
  • Min — Returns the minimum value in the field that you specify.
  • Sum — Calculates the sum total of the values in the field that you specify.
For more information, see the description for Aggregation Field.

Aggregation Field

The Data Explorer field containing values to be aggregated. Aggregates are calculated for each unique value in the selected Group By field.

Note: The Aggregation Field does not appear when Aggregation is set to Count.
Tip: For more information, see Data Explorer fields.

Aggregation Title

An axis label that describes the aggregated data. For example, Number of users.

This field is optional.

Map

This chart type has these configuration fields:

Field

Description

Group By

The Data Explorer field to group rows of data by.

You cannot change this configuration. In this chart type, data is grouped by geographic location using ISO country codes.

Aggregation
How to aggregate data. Select one of these options:
  • Count — Counts the total number of rows in the returned dataset.
  • Max — Returns the maximum value in the field that you specify.
  • Min — Returns the minimum value in the field that you specify.
  • Sum — Calculates the sum total of the values in the field that you specify.
For more information, see the description for Aggregation Field.

Aggregation Field

The Data Explorer field containing values to be aggregated. Aggregates are calculated for each unique value in the selected Group By field.

Note: The Aggregation Field does not appear when Aggregation is set to Count.
Tip: For more information, see Data Explorer fields.

Legend Name

A label that describes the aggregated data. This label appears in the chart legend.

Horizontal bar chart

This chart type has these configuration fields:

Field

Description

Group By

The Data Explorer field to group rows of data by.

In a bar chart, each bar represents a unique value in the selected Group By field.

Tip: For more information, see Data Explorer fields.

Number of Groups
The number of bars to display in a bar chart, up to a maximum of 10, where each bar represents a unique value in the selected Group By field.
Note: Bar chart widgets always display groups with the highest values.

Aggregation
How to aggregate data. Select one of these options:
  • Count — Counts the total number of rows in the returned dataset.
  • Max — Returns the maximum value in the field that you specify.
  • Min — Returns the minimum value in the field that you specify.
  • Sum — Calculates the sum total of the values in the field that you specify.
For more information, see the description for Aggregation Field.

Aggregation Field

The Data Explorer field containing values to be aggregated. Aggregates are calculated for each unique value in the selected Group By field.

Note: The Aggregation Field does not appear when Aggregation is set to Count.
Tip: For more information, see Data Explorer fields.

Aggregation Title

An axis label that describes the aggregated data. For example, Number of users.

This field is optional.

Vertical bar chart

This chart type has these configuration fields:

Field

Description

Group By

The Data Explorer field to group rows of data by.

In a bar chart, each bar represents a unique value in the selected Group By field.

Tip: For more information, see Data Explorer fields.

Number of Groups
The number of bars to display in a bar chart, up to a maximum of 10, where each bar represents a unique value in the selected Group By field.
Note: Bar chart widgets always display groups with the highest values.

Aggregation
How to aggregate data. Select one of these options:
  • Count — Counts the total number of rows in the returned dataset.
  • Max — Returns the maximum value in the field that you specify.
  • Min — Returns the minimum value in the field that you specify.
  • Sum — Calculates the sum total of the values in the field that you specify.
For more information, see the description for Aggregation Field.

Aggregation Field

The Data Explorer field containing values to be aggregated. Aggregates are calculated for each unique value in the selected Group By field.

Note: The Aggregation Field does not appear when Aggregation is set to Count.
Tip: For more information, see Data Explorer fields.

Aggregation Title

An axis label that describes the aggregated data. For example, Number of users.

This field is optional.

Pie chart

This chart type has these configuration fields:

Field

Description

Group By

The Data Explorer field to group rows of data by.

In a pie chart, each slice represents a unique value in the selected Group By field.

Tip: For more information, see Data Explorer fields.

Aggregation
How to aggregate data. Select one of these options:
  • Count — Counts the total number of rows in the returned dataset.
  • Max — Returns the maximum value in the field that you specify.
  • Min — Returns the minimum value in the field that you specify.
  • Sum — Calculates the sum total of the values in the field that you specify.
For more information, see the description for Aggregation Field.

Aggregation Field

The Data Explorer field containing values to be aggregated. Aggregates are calculated for each unique value in the selected Group By field.

Note: The Aggregation Field does not appear when Aggregation is set to Count.
Tip: For more information, see Data Explorer fields.

Multi bar chart

This chart type has these configuration fields:

Field

Description

Series Count

The number of series to be defined for the widget. Maximum of 4.

X-Axis Field

An axis based on the @timestamp field that shows changes over time.

Series are grouped together at points in time for comparison. This grouping is called a cluster. Clusters are presented on the x-axis based on timeline distribution.

You cannot change this configuration.

Timestamp View

The data roll-up setting for the database.

You cannot change this configuration.

This configuration is set to Hourly. However, when data is visualized, the timeline changes dynamically to scale the results based on the currently selected date range.

Y-Axis Name (Optional)

A label that describes the aggregated data. For example, Number of users.

This field is optional.

Note: The Multi Bar Chart chart type uses the Count aggregation method. For more information, see the description for Series.

Order (Optional)

The sort order of clusters horizontally.

You cannot change this configuration. In this chart type, the x-axis is a timeline and clusters are ordered chronologically.

Tip: The sort order of series inside a cluster is based on the order of the Series # subsections.

Series

Changes to the number of values in a specified Data Explorer field over time. The values included in the count depend on filter criteria.

Note: The Multi Bar Chart chart type uses the Count aggregation method.

In the widget, each series is represented by a unique color.

To define a series, fill in these configuration fields:
  • Label — A label that describes the series. This label appears in the chart legend.

  • Filter for — The Data Explorer field containing values to be counted.

  • Operator — A function that determines which values are counted.

    Available operators depend on the selected Filter for option. For more information, see Query Builder.

  • Value — The value that the operator evaluates or compares against.

    If the selected operator is:

    • exists — This configuration field is not applicable. All values in the specified Data Explorer field are counted.
    • Anything else — This configuration field is used to filter the data returned from the specified Data Explorer field. Only values matching the provided criteria are counted.