This topic describes how to configure a state timeline chart.
Overview
A state timeline chart displays state changes over time. Each field is presented as a horizontal band. State regions can be rendered with or without values. A state timeline chart supports strings, Boolean values, and time series. If you use time series, you can specify thresholds to convert numeric values into states.
For more information about the entry point to add a state timeline chart, see Add a chart (Pro) to a dashboard.
General Configurations
On the General Configurations tab, you can configure global settings for a chart.
Basic Configurations
Parameter
Description
Title
The title of the chart.
Display Title
If you turn on Display Title, the title of the chart is displayed.
Display Border
If you turn on Display Border, the borders of the chart are displayed.
Display Background
If you turn on Display Background, the background color of the chart is displayed.
Display Time
If you turn on Display Time, the query time range of the chart is displayed.
Fixed Time
If you turn on Fixed Time, the query time range of the chart is independent of the global time range of the dashboard.
Standard Configurations
Parameter
Description
Format
The display format of numeric values.
Unit
The unit of numeric values.
Number of Digits after Decimal Point
The decimal places of numeric values.
Display Name
The name of the display field.
If you specify a value for Display Name, the value is used as the names for all display fields in the chart. If you want to change the name of a display field, you must configure parameters on the Field Configuration tab.
Color Scheme
The color scheme of the chart.
Built-in: uses the built-in color scheme.
Solid: uses the color that you select.
Threshold: uses different colors for different values based on the specified thresholds for the values.
Timeline Configurations
Parameter
Description
Display Value
The display mode of values in the chart.
Alignment Mode
The alignment mode of values in the chart.
Value Font Size
The font size of values in the chart.
Line Width
The distance between state regions in the chart.
Row Height
The distance between rows in the chart.
Transparency
The transparency of the chart.
Merge Equal Consecutive Values
If you turn on Merge Equal Consecutive Values, consecutive values are merged in the chart.
Connect Null Values
Specifies whether to connect null values in the chart.
Query and Analysis Configurations
Parameter
Description
Axis X Field
Select a field as the x-axis.
Axis Y Field
Select a field as the y-axis.
Category Column
Select a field as the categorical field.
Custom Time Range
If you turn on Custom Time Range, you can configure custom settings.
X-axis Start Value
Select a start field for the x-axis. This parameter is required only if you turn on Custom Time Range.
X-axis End Value
Select an end field for the x-axis. This parameter is required only if you turn on Custom Time Range.
Y-axis
Select a field as the y-axis. This parameter is required only if you turn on Custom Time Range.
Legend Configurations
Parameter
Description
Display Legend
If you turn on Display Legend, the legend of the chart is displayed.
Sorting Order
The order in which the legend items are sorted.
Legend Position
The position of the legend in the chart.
Actions
Single: When you click a legend item, only the data that corresponds to the legend item is displayed in the chart.
Switch: When you click a legend item, the data that corresponds to the legend item is hidden or displayed in the chart.
Maximum Width (Height)%
The maximum width and height of the legend.
Axis X
Parameter
Description
Display Axis X
If you turn on Display Axis X, the x-axis of the chart is displayed.
Axis X Title
The title of the x-axis.
Axis X Height
The height of the x-axis.
By default, Simple Log Service automatically specifies the height of the x-axis.
Format
The time display format of the x-axis. This parameter takes effect only if you turn on Time Series Mode. You can also specify a custom format. For more information, see String + Format.
Drag and Zoom
The drag and zoom mode of the chart.
Global: If you drag the chart, all charts in the dashboard change.
Single: If you drag the chart, only the chart changes.
Axis Y
Parameter
Description
Display Axis Y
If you turn on Display Axis Y, the y-axis of the chart is displayed.
Axis Y Title
The title of the y-axis.
Axis Y Position
The position of the y-axis.
Axis Y Width
The width of the y-axis.
By default, Simple Log Service automatically specifies the width of the y-axis.
Value Mapping
Parameter
Description
Value Mapping
The settings of value mapping. You can replace values in the chart with text or icons.
For example, if you set Value to 200, Mapping Type to Text, and Mapping Value to Success, all values of 200 in the chart are replaced with Success.
Tooltip Configurations
Parameter
Description
Additional Information
The additional information. You can add additional information for each query statement. You can add
${{field}}in the additional information to reference the field in the query statement.Threshold
Parameter
Description
Threshold Mode
The display mode of the thresholds.
Threshold
The thresholds of numeric values.
If you set Color Scheme to Threshold and specify thresholds for numeric values in the Threshold section, the values in the chart are displayed in different colors based on the specified thresholds.
Variable Replacement
Parameter
Description
Variable Replacement
The settings of variable replacement. You can click AddVariable Replacement to add a filter of the Replace Variable type to a chart. After you configure the settings of variable replacement on the General Configurations tab, Simple Log Service adds a filter in the upper-left corner of the chart. You can select a value from the filter drop-down list. After you select a value, Simple Log Service automatically replaces the variable in the query statement of the chart with the variable value indicated by the value that you select, and performs a query and analysis operation. For more information, see Example 2: Configure variable replacement.
Documentation
Parameter
Description
Add Documentation Link
The button that allows you to specify custom document links and descriptions. After you configure the settings, the specified information is displayed in the upper right corner of the chart.
Field Configuration
On the Field Configuration tab, you can configure personalized display settings for the results of a single query statement or for a single column of data in the results. For more information, see Field Configuration.
For example, in the A > c1 section, you can configure settings for the c1 field in the results of Query Statement A. In the B section, you can configure settings for the results of Query Statement B. In the following figure, the red block indicates the c1 field in the results of Query Statement A, and the green block indicates the results of Query Statement B.
Interaction Occurrences
Interaction occurrences are used to analyze a single field or the results of a single query statement from a finer-grained dimension. Supported types of interaction occurrences include Open Logstore, Open Saved Search, Open Dashboard, Open Trace Analysis, Open Trace Details, and Create Custom HTTP URL. For more information, see Interaction occurrences.
For example, in the A > c1 section, you can configure an interaction occurrence for the c1 field in the results of Query Statement A. When you configure an interaction occurrence for the c1 field in the results of Query Statement A, select Open Logstore from the drop-down list. After you configure the interaction occurrence, you can click a point on the c1 field in the state timeline chart and choose Open Logstore. Then, you are navigated to the Logstore that you specify.
