State timeline chart

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	Sets the title of the chart.
  Display Title	Enable Display Title to display the title on the chart.
  Display Border	Enable Display Border to display a border around the chart.
  Display Background	Enable Display Background to display the chart's background color.
  Display Time	Enable Display Time to display the query time range on the chart.
  Fixed Time	Enable Fixed Time to use a fixed time range for the chart, independent of the global time range set for the dashboard.

• Standard configurations

  Parameter	Description
  Format	Sets the display format for numbers.
  Unit	Sets the unit for numbers.
  Number of Digits after Decimal Point	Sets the number of decimal places to display.
  Display Name	Sets a display name for the field. This name overrides all field names in the chart. To change the name of a specific field, use Field Configuration.
  Color Scheme	Sets the color scheme for the chart. Built-in: Uses the built-in color palette. Solid: Applies a single, solid color that you select. Threshold: Colors the chart based on configured threshold values.

• 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 specific data values with custom text or icons. For example, you can map the Value of 200 to the text Success by setting Mapping Type to Text and Mapping Value to Success. All instances of 200 in the chart will then appear as 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	Sets the display mode for thresholds.
  Threshold	Defines the threshold values for your data. When the Color Scheme is set to Threshold, the chart is colored according to the thresholds defined here.

• Variable Replacement

  Parameter

  Description

  Variable Replacement

  This feature adds a variable-based filter to an individual chart. After configuring variable replacement in General Configurations, Log Service adds a filter to the top-left corner of the chart. You can select a value from this filter, and Log Service automatically substitutes the corresponding variable in the query and analysis statement and re-runs the query. For a configuration example, see Example 2: Configure variable replacement.

• Documentation link

  Parameter	Description
  Add Documentation Link	Adds a custom link or description to the top-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.