Create time series data visualizations
Show changes in data over time. Use different time series visualizations to emphasize different aspects of the data, such as trends or individual values.
Before you begin
Role required: Anyone with access to data can create a visualization of that data on any dashboard that they can edit. Users with the itil, report_user, admin, or viz_creator role can create a visualization in the Visualization Designer. When you create a visualization in the Visualization Designer, it is saved to the Library. For more information on access, see Report_view access control and Platform Analytics roles.
About this task
A time series is an ordered sequence of metrics taken continuously over time. The following business cases are some of the uses of a time series:
- Identifying trends, patterns, and outliers in data.
- Identifying turning points, such as whether a change in policy led to a change in indicator scores.
- Evaluating the relationships between data sources.
When you are selecting a visualization for a time series, consider whether you want to emphasize the trend in the data or specific changes in the data. Also consider whether you want to show one data source or compare several related data sources.
For information about the use of a Time series visualization in a dashboard, see the Developer Site. This site gives information about Time series data visualization components in the UI Builder, and some configuration options may differ from the Visualization Designer.
For an example of creating a time series visualization, see Time series data visualization example.
Procedure
Navigate to All > Platform Analytics > Library > Data Visualizations, or open an in-line dashboard and select Edit.
Select Create data visualization.
Configure the Header and border. Header and border options are the same for all data sources.
| Header and border fields | Description |
|---|---|
| Show border | Option to display a line around the component. |
| Show header | The visualization header, including title and icons. |
| Show header separator | Option to display a line separating the header from the rest of the component. |
| Chart title | Title of the visualization. |
| Title alignment | Choose Start to align the title with the start of line, End to align it with the end of the line, or Center for center alignment. |
| Description | A short overview about the visualization that the end user sees. Descriptions help users find the visualization. |
| Wrap title | Option to wrap long titles onto a second line. If false, displays an ellipsis to truncate long titles. |
| Wrap labels | Select to wrap long elements labels on the axis. |
| Max label size, px | Specify the maximum label size for element names on the axis. Default=100 px. |
| Line of truncation | Specify where to truncate long labels with an ellipsis. Options are 1, 2, and 3. |
| Bare | Option to remove padding around data visualization to provide more compact positioning on the page. Only available when Show border is turned off. |
| Show refresh option | Option to show or hide the refresh option from data visualizations. If cache is enabled on a dashboard, the Refresh option is always hidden. |
| Show export options | Option to show or hide the visualization's export types. |
| Header background color | Specify the color behind the title of the visualization. |
| Title color | Specify the text color of the title. The default title color is black, but you can choose a color that contrasts better with the header background. Only available when Header background color is selected. |
Choose a data source.
For general descriptions of the data sources, see Data sources for data visualizations.
Table (available in the base system). When you select a table, you can filter it by custom or preconfigured conditions. Custom conditions can include questions or Service Catalog variables.
Configured report sources appear in the Predefined conditions list. For more information, see Report sources.
To help you create a custom filter, there is a preview list of records that would be included in the visualization. You can change which fields are shown as columns and the width of columns in the list actions.
Preview record list for table source data visualization with list actions shown.
- Indicator \(available in the base system\). You can filter the indicator scores by breakdowns and elements.
**Note:** Benchmark indicators are not supported.
Conditional filter for indicator data source on data visualization.
**Note:**
You might have a multiple select \(is one of\) or dynamic \(is \(dynamic\)\) operator on the breakdown element filter. These operators require the indicator and breakdown to support them. For more information about the configurations that support these operators, see ["Is one of" and "Is \(Dynamic\)" operators on breakdown conditions in data visualizations](performance-analytics/condition-operators-ind-bkdowns.md).
- MetricBase \(available if MetricBase is enabled\). When you select a MetricBase data source, you have the option of constructing a custom filter for it using conditions and related list conditions, as with Table data sources.
- Usage Insights \(available with the User Experience PAR Integration application, to users with a required role\). Choose one of up to three KPIs included with this application, depending on the visualization type. For more information, see [Usage Insights data sources for data visualizations](uxa-data-sources.md).
**Note:** You can select multiple data sources for this visualization, but they must be of the same type: table, indicator, Usage Insights, or MetricBase. For more information, see [Multiple data sources](multiple-data-sources.md).
Select the options for your data source.
- If your visualization represents table data, go to Table data options for time series data visualizations.
- If your visualization represents indicator data, go to Indicator data options for time series data visualizations.
- If your visualization represents Usage Insights data, go to Usage Insights data options for time series data visualizations.
- If your visualization represents MetricBase data, go to MetricBase data options for time series data visualizations.
- Under Presentation, provide display and color information.
| Field | Description |
|---|---|
| Display settings: Each visualization type, such as Area and Column, has a different set of display settings. See Display settings for time series data visualizations. | |
| Y axis | |
| Hide axis | Option to hide the primary axis. |
| Primary axis title | Title to display on the vertical axis of the visualization.This property applies only when Hide primary axis is false. If there is more than one Y-axis, you have additional axis titles, representing the properties yAxis1Title, yAxis2Title, etc. Add a Y-axis scale for a metric in the More options menu for the metric. |
| Axis range - from | Starting point for the values on the primary axis. |
| Axis range - to | End point for the values on the primary axis. |
| Show grid | Shows a grid of fine lines perpendicular to the primary axis, to help align values against that axis. |
| Axis style | Style of the primary axis. - Clean `clean`: Adds a straight line to the primary axis. - No tick lines `noTicks`: Option to remove all marks from the primary axis. - Standard `default`: Adds a line and tick marks to the primary axis. |
| X axis | |
| X axis title | Title to display on the horizontal axis of the visualization. |
| Show grid | When enabled, grid lines appear on the visualization. |
| Legend | |
| Show legend | Option to display the legend. Activated automatically at 400% zoom. |
| Show legend value | Option to display the value corresponding to the area of the chart you hover on. The value displays as a tooltip and in the chart legend. |
| Legend position | Legend location relative to the chart: Above, Below, Right, or Left |
| Horizontal alignment | Horizontal alignment of elements in the legend: Start, Center, or End |
| Max legend item width, px | Number of pixels after which the item in the legend is truncated. |
| Expand legend vertically | When turned on, the legend contents take as much space as needed to fit the legend without scrolling, instead of the maximum 2 lines. |
| Data label | |
| Show data labels | Option to display the score for each data point. |
| Colors | |
| Set color type | Type of color scheme to apply to the component. Options include:
This option is available only for Table data sources and only if no more than one data source or metric is added, and a Group by is defined. Note: Single color is only available when no Group by is selected. |
- Under Chart interaction, set what if anything happens when a viewer clicks a chart or a chart segment on the visualization.
| Field | Description |
|---|---|
| Allow chart interaction | Enable an event to occur when a user clicks in a visualization or one of its segments. |
| Action | Choose the event that occurs when a user clicks in a visualization or one of its segments. Choices depend on the visualization type and data source. Applies only when Allow chart interaction is on. For more information, see Chart interactions in a data visualization.
Note: The last level of drill down in the Platform Analytics experience is always a Core UI list. Records do not open in Workspace embedded lists. Drill down to chart supports only table data sources. |
Select Save.
Navigate to All > Platform Analytics > Library > Data Visualizations to return to the Data Visualization list.
What to do next
- Add a visualization to a dashboard from the Visualization Designer
- Share a data visualization in the Visualization Designer
Use cases for different time series visualization types
Time series visualizations can emphasize the trend in the data or specific changes in the data. They can show one data source or compare several related data sources.- Table data options for time series data visualizations
The following Data configuration options are available for all time series type visualizations of table data. - Indicator data options for time series data visualizations
The following Data configuration options are available for all time series type visualizations of indicator scores. - Usage Insights data options for time series data visualizations
The following Data configuration options are available for all time series type visualizations of Usage Insights data. - MetricBase data options for time series data visualizations
The following data options are available for all time series type visualizations of MetricBase data. - Display settings for time series data visualizations
Each time series visualization type has a different set of display settings. - Configure a forecast in a time series data visualization
If a time series visualization is configured to show forecasts, you can configure the forecasts for that visualization. - Options for time series data visualizations with multiple metrics
If you are showing multiple metrics in a time series data visualization, you can set the group by, visualization type, and Y-axis scale for each metric. You can also have filters on a dashboard apply only to specific metrics. - Time series data visualization example
Time series visualizations show the changes in data over time. This example starts with a single indicator data source and adds more complexity.
Parent Topic:Creating data visualizations