All Products
Search
Document Center

Simple Log Service:State timeline chart

Last Updated:Jun 20, 2026

This topic describes the general settings for state timeline charts.

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 be used for time series. When used with time series data, you can set a threshold to 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

    Displays the chart title when enabled.

    Display Border

    Displays a border around the chart when enabled.

    Display Background

    Displays a background color in the chart when enabled.

    Display Time

    Displays the query time in the chart when enabled.

    Fixed Time

    Fixes the query and analysis time range so that it is not affected by the global time of the dashboard.

  • 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 instead.

    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

    Determines 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

    Specifies whether to connect null values 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

    Enabling Custom Time Range customizes the time range for the chart.

    X-axis Start Value

    Select the start field for the x-axis. This parameter is available only when Custom Time Range is enabled.

    X-axis End Value

    Select the end field for the x-axis. This parameter is available only when Custom Time Range is enabled.

    Axis Y

    Select the field for the y-axis. This parameter is available only when Custom Time Range is enabled.

  • Legend configuration

    Parameter

    Description

    Display Legend

    Enabling Display Legend displays the chart legend.

    Sorting Method

    The sorting order of items in the legend.

    Legend Position

    The position of the legend 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

    Enabling Display Axis X displays the x-axis.

    Axis X Title

    The title of the x-axis.

    Axis X Height

    The height of the x-axis.

    By default, Simple Log Service automatically sets the height of the x-axis.

    Format

    Specifies the time format for the x-axis. This option is 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

    Enabling Display Axis Y displays the y-axis.

    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 sets the width of the y-axis.

  • 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 piece of additional information for each query. Use the ${{field}} syntax to substitute values from the query results.

  • Threshold

    Parameter

    Description

    Threshold Mode

    The display mode for thresholds.

    Threshold

    The data thresholds.

    If you set Color Scheme to Threshold and configure thresholds here, the system colors the chart based on the corresponding threshold colors.

  • Variable replacement

    Parameter

    Description

    Variable Replacement

    Variable replacement acts as a variable-based filter for a single chart. After you configure variable replacement 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 allows you to apply custom visualization settings to the results of a specific query or to a single column within those results. For details on the available options, 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 to a dashboard 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.