Line Chart
A Line Chart is a type of chart used to visualize data that changes over time or across categories. It consists of data points connected by lines, making it easy to identify trends and patterns.
Widget Settings
In addition to the common widget settings, this widget has unique configuration options.
Data Settings
The widget supports two dimension groups: Dimension 1 and Dimension 2. You can add multiple dimensions to each group. For dimensions, you can hide empty values, assign click actions, and configure the Display setting (Always / By variable / By formula). You can also add measures. Additionally, for each measure you can set line thickness, enable Data labels, and specify their size.
The availability of color configuration modes for dimensions and measures depends on the widget’s configuration.
| 1 Dimension | 2 Dimensions | |
|---|---|---|
| 1 Measure | For the dimension: Color settings unavailable For the measure, allowed rule mode: 1. Solid | For Dimension 1: Color settings unavailable For Dimension 2, available modes: 1. Disabled 2. By values (only rules with Solid mode are allowed) 3. By rule (only dimension-based rules added to the widget are allowed) For the measure: Color settings unavailable |
| Multiple Measures | For the dimension: Color settings unavailable For measures, allowed rule mode: 1. Solid | For measures: Color settings unavailable |
Display Settings
Text Size
Controls the text size in the widget, excluding measure Data labels.
Dimension Limits
- Dimension 1 Limit and Dimension 2 Limit control the number of data points (or series) displayed on the chart.
Hide Empty Values
Enable this option to exclude empty values from the chart.
Hint
When enabled, hovering over a data point in Browse mode displays a hint with detailed information about the underlying data.
Chart Type
Controls how lines are rendered: Standard lines, Area, or Stacked area. You can also enable line smoothing, show total Data labels (for stacked area charts), and adjust the label text size.
Legend
For details on legend configuration, see Widgets.
X-Axis
For the X-axis, you can enable a title and configure label rotation and height.
Y-Axis
For the Y-axis, you can enable a title, set label width, and define a custom range.
- Y-axis values on the graph start not from 0, but from the minimum value present in the measures.
- If the defined range is smaller than a measure’s value, the graph automatically scales to accommodate the data. Values outside the visible range are displayed without markers beyond the chart boundary.
- You can independently enable or disable either axis.
Filtering Settings
The widget supports standard filtering settings.
- Filters configured within the widget cannot be removed in Browse mode.
- When a filter is applied via click in Browse mode, the corresponding points on the line are highlighted.
Widget Configuration in YAML
You can configure the widget not only visually but also in the YAML editor. The table below lists the keys and values available for configuration. For details on using the value key, see Dimension and Measure Values in YAML. Supported data formats are described on the corresponding page. General widget parameters are covered in Widget Configuration in YAML.
Data Settings in YAML
| Key | Type | Definition |
|---|---|---|
| title | string | Title |
| showMarkdown | boolean | Description |
| markdownText | string | Description text |
| markdownMeasures | — | Measures in description |
| dimensionsFirstGroup | — | Dimension 1 |
| dimensionsSecondGroup | — | Dimension 2 |
| measures | — | Measures |
| sorting | — | Sorting |
Dimension 1 (key: dimensionsFirstGroup)
| Key | Type | Definition |
|---|---|---|
| name | string | Dimension title |
| value | — | Dimension formula |
| dbDataType | enum | Dimension data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| hierarchyDimensions | — | Hierarchy dimensions If added, the indicator is defined as a hierarchy |
| onClick | — | Click actions Not applied if hierarchical |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Hierarchical Dimension for Dimension 1 (key: hierarchyDimensions)
| Key | Type | Definition |
|---|---|---|
| name | string | Dimension title |
| value | — | Dimension formula |
| dbDataType | enum | Dimension data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| onClick | — | Click actions |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Dimension 2 (key: dimensionsSecondGroup)
| Key | Type | Definition |
|---|---|---|
| name | string | Dimension title |
| value | — | Dimension formula |
| dbDataType | enum | Dimension data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| hierarchyDimensions | — | Hierarchy dimensions If added, the indicator is defined as a hierarchy |
| onClick | — | Click actions Not applied if hierarchical |
| color | — | Color: - DISABLED — disabled- VALUES — by values- RULE — by ruleNot applied if: 1. Indicator is hierarchical 2. No dimension is added to the first group |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Hierarchical Dimension for Dimension 2 (key: hierarchyDimensions)
| Key | Type | Definition |
|---|---|---|
| name | string | Dimension title |
| value | — | Dimension formula |
| dbDataType | enum | Dimension data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| hideEmptyValues | boolean | Hide empty values |
| onClick | — | Click actions |
| color | — | Color: - DISABLED — disabled- VALUES — by values- RULE — by ruleNot applied if no dimension is added to the first group |
| displayCondition | — | Display (display condition) |
| arrayNesting | boolean | Array nesting |
Measures in YAML (key: measures)
| Key | Type | Definition |
|---|---|---|
| name | string | Measure title |
| value | — | Measure formula |
| dbDataType | enum | Measure data type |
| format | enum | Format |
| formatting | enum | Formatting |
| formattingTemplate | string | Custom formatting Only for CUSTOM formatting |
| lineThickness | enum | Line thickness: - THIN — thin- THICK — thick |
| showLabels | — | Data labels |
| color | — | Color: - AUTO — auto- BASE — solid- RULE — by ruleNot displayed if dimensions are added to both groups |
| displayCondition | — | Display (display condition) |
Show Value Labels (key: showLabels)
| Key | Type | Definition |
|---|---|---|
| enabled | boolean | Enable/disable labels |
| size | number | Label size |
Display Settings in YAML
| Key | Type | Definition |
|---|---|---|
| paddings | string | Side paddings |
| titleSize | number | Title size |
| titleColor | — | Title color: - AUTO — auto- BASE — solid |
| titleWeight | enum | Font weight: - NORMAL — normal- BOLD — bold |
| markdownTextSize | number | Markdown description text size Available only if Description is enabled |
| textSize | number | Text size |
| firstDimensionLimit | number | Dimension 1 limit |
| secondDimensionLimit | number | Dimension 2 limit |
| hideEmptyValues | boolean | Hide empty values |
| showHint | boolean | Hint |
| chartType | enum | Chart type: - LINE — standard lines- AREA — area- STACKED_AREA — stacked area |
| lineSmoothing | boolean | Line smoothing |
| legend | — | Legend |
| showTotalLabels | — | Total Data labels Only for STACKED_AREA type |
| xAxis | — | X-axis settings |
| yAxis | — | Y-axis settings |
Total Value Labels (key: showTotalLabels)
| Key | Type | Definition |
|---|---|---|
| enabled | boolean | Enable/disable total labels |
| size | number | Label size |
X-Axis Settings (key: xAxis)
| Key | Type | Definition |
|---|---|---|
| enabled | boolean | Enable/disable X-axis |
| rotation | number | Label rotation |
| height | number | Label height |
| showTitle | boolean | Title |
Y-Axis Settings (key: yAxis)
| Key | Type | Definition |
|---|---|---|
| enabled | boolean | Enable/disable Y-axis |
| width | number | Label width |
| showTitle | boolean | Title |
| rangeSwitch | boolean | Enable/disable custom range |
| range | — | Range values |
Range Values in YAML (key: range)
| Key | Type | Definition |
|---|---|---|
| min | number | Minimum value |
| max | number | Maximum value |
Filtering Settings in YAML
| Key | Type | Definition |
|---|---|---|
| filterMode | enum | Filter mode: - DEFAULT — default- SINGLE — single selection- DISABLED — disabled |
| ignoreFilters | boolean | Ignore filters |
| filters | — | Filters |
| aggregateFilters | — | Aggregate filters |
| stateName | string | State |
Example of a Configured Widget in the YAML Editor
- key: LINE_CHART
apiVersion: "16"
type: LINE_CHART
settings:
displayCondition:
mode: DISABLED
textSize: 12
xAxis:
showTitle: false
enabled: true
lineSmoothing: true
showMarkdown: false
ignoreFilters: false
markdownMeasures: []
legend:
position: BOTTOM
align: CENTER
dimensionsFirstGroup:
- displayCondition:
mode: DISABLED
dbDataType: STRING
onclick: []
name: Events
format: STRING
value:
mode: FORMULA
formula: '"event_log"."event_name"'
formatting: AUTO
onClick: []
filters: []
titleSize: 14
title: ""
filterMode: DEFAULT
yAxis:
rangeSwitch: false
showTitle: false
range: {}
enabled: true
measures:
- displayCondition:
mode: DISABLED
color:
mode: BASE
value: "#00d2d3"
lineThickness: THIN
dbDataType: STRING
name: count (distinct incident_id)
format: NUMBER
value:
mode: TEMPLATE
templateName: countDistinct
dbType: CH
tableName: case_table
columnName: incident_id
formatting: AUTO
valueLabel:
size: 12
enabled: true
showLabels:
enabled: true
size: 12
dimensionsSecondGroup: []
markdownText: ""
stateName: null
sorting: []
chartType: AREA
stateGuid: f12c435a-43b8-4f98-8fc5-220adba5ffcb
secondDimensionLimit: 50
firstDimensionLimit: 15
showTotalLabels:
size: 12
enabled: false
titleColor:
mode: AUTO
titleWeight: NORMAL
Was the article helpful?