Configure a state timeline chart-Simple Log Service(SLS)-阿里云帮助中心

Overview

A state timeline chart displays discrete states that change over time. Each field or time series is rendered as a unique horizontal band. State regions can be displayed with or without values. This chart is ideal for visualizing string or boolean states but can also work with time series data. When used with time series, thresholds convert numerical values into discrete states.

To add a chart to a dashboard, see Add a chart to a dashboard.

General configuration

Configure global settings for the chart.

Basic configurations

Parameter	Description
Title	The chart title.
Display Title	Shows the chart title when enabled.
Display Border	Shows a border around the chart when enabled.
Display Background	Shows a background color for the chart when enabled.
Display Time	Shows the query time in the chart when enabled.
Fixed Time	Locks the query and analysis time range so that it is not affected by the dashboard's global time setting.

Standard configurations

Parameter	Description
Format	The display format for numbers.
Unit	The unit for numbers.
Number of Digits after Decimal Point	The number of decimal places for numbers.
Display Name	The display name for the field. This name overrides all other field names in the chart. To rename a specific field, use field configuration.
Color Scheme	The color scheme for the chart. Built-in: Uses the built-in colors. Solid: Uses a single color. Threshold: Colors the chart based on configured thresholds.

Timeline configuration

Parameter	Description
Display Value	Controls how values are displayed in the chart.
Alignment Mode	The alignment of values in the chart.
Value Font Size	The font size of values in the chart.
Line Width	The border width of the state regions in the chart.
Row Height	The height of each row in the chart.
Transparency	The transparency of the chart.
Merge Equal Consecutive Values	Enabling Merge Equal Consecutive Values merges consecutive, identical values into a single block.
Connect Null Values	Controls whether null values are connected in the chart.

Query and analysis configuration

Parameter	Description
Axis X Field	Select the field to use for the x-axis.
Axis Y Field	Select the field to use for the y-axis.
Category Column	Select a field for categorization.
Custom Time Range	Customizes the time range for the chart when enabled.
X-axis Start Value	Select the start field for the x-axis. Available only when Custom Time Range is enabled.
X-axis End Value	Select the end field for the x-axis. Available only when Custom Time Range is enabled.
Axis Y	Select the field for the y-axis. Available only when Custom Time Range is enabled.

Legend configuration

Parameter	Description
Display Legend	Displays the chart legend when enabled.
Sorting Method	The sort order of legend items.
Legend Position	The legend position on the chart.
Actions	Single: When you click a legend item, only its corresponding data is displayed. Switch: Toggles the visibility of the corresponding data when you click a legend item.
Maximum width (height)%	The width of the legend.

x-axis

Parameter	Description
Display Axis X	Displays the x-axis when enabled.
Axis X Title	The title of the x-axis.
Axis X Height	The height of the x-axis. By default, the height is set automatically.
Format	The time format for the x-axis. Available only in time series mode. Custom formats are supported.
Drag and Zoom	The drag-to-zoom behavior of the chart. Global: Dragging to zoom on this chart also zooms all other charts on the dashboard. Single: Dragging to zoom affects only this chart.

y-axis

Parameter	Description
Display Axis Y	Displays the y-axis when enabled.
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, the width is set automatically.

Value mapping

Parameter

Description

Value Mapping

Replaces values in the chart with custom text or icons.

For example, if you set Value to 200, Mapping Type to Text, and Mapping Value to Success, all instances of 200 in the chart are replaced with Success.

tooltip configuration

Parameter	Description
Additional Information	Adds extra information to the tooltip. You can add one entry per query. Use the `${{field}}` syntax to substitute values from query results.

Threshold

Parameter

Description

Threshold Mode

The display mode for thresholds.

Threshold

The data thresholds.

When Color Scheme is set to Threshold, the chart is colored based on the threshold values configured here.

Variable replacement

Parameter	Description
Variable Replacement	Variable replacement serves as a variable-based filter for a single chart. After you configure it in General Configurations, a filter appears in the upper-left corner of the chart. Selecting a value from the filter replaces the variable in the query and analysis statement and re-runs the query and analysis. For a configuration example, see Example 2: Configure variable replacement.

Documentation link

Parameter	Description
Add Documentation Link	Adds a custom documentation link or description to the upper-right corner of the chart.

Field configuration

Field configuration lets you apply custom visualization settings to the results of a specific query or to a single column within those results. For details, see Field configuration.

For example, A > c1 configures settings for the c1 field from query A, while B configures settings for all results from query B.

Interaction events

Interaction events enable drill-down analysis on a single field or query result. Supported events include Open Logstore, Open Saved Search, Open Dashboard, Open Trace Analysis, Open Trace Details, and Custom HTTP Link. For more information, see Add interaction events for drill-down analysis.

For example, A > c1 indicates that you are setting an interaction event for the c1 field from query A. If you set the interaction event for the c1 field to Open Logstore, you can click any point on the c1 field in the chart and then click Open Logstore to navigate to the specified Logstore.