LogoLogo
StackState.comDownloadSupportExplore playground
StackState v6.0
StackState v6.0
  • StackState docs!
  • Docs for all StackState products
  • 🚀Get started
    • Quick start guide
    • StackState walk-through
    • SUSE Rancher Prime
      • Air-gapped
      • Agent Air-gapped
  • 🦮Guided troubleshooting
    • What is guided troubleshooting?
    • YAML Configuration
    • Changes
    • Logs
  • 🚨Monitors and alerts
    • Monitors
    • Out of the box monitors for Kubernetes
    • Notifications
      • Configure notifications
      • Notification channels
        • Slack
        • Teams
        • Webhook
        • Opsgenie
      • Troubleshooting
    • Customize
      • Add a monitor using the CLI
      • Override monitor arguments
      • Write a remediation guide
  • 📈Metrics
    • Explore Metrics
    • Custom charts
      • Adding custom charts to components
      • Writing PromQL queries for representative charts
      • Troubleshooting custom charts
    • Advanced Metrics
      • Grafana Datasource
      • Prometheus remote_write
      • OpenMetrics
  • 📑Logs
    • Explore Logs
    • Log Shipping
  • 🔭Traces
    • Explore Traces
  • 📖Health
    • Health synchronization
    • Send health data over HTTP
      • Send health data
      • Repeat Snapshots JSON
      • Repeat States JSON
      • Transactional Increments JSON
    • Debug health synchronization
  • 🔍Views
    • Kubernetes views
    • Custom views
    • Component views
    • Explore views
    • View structure
      • Filters
      • Overview perspective
      • Highlights perspective
      • Topology perspective
      • Events perspective
      • Metrics perspective
      • Traces perspective
    • Timeline and time travel
  • 🕵️Agent
    • Network configuration
      • Proxy Configuration
    • Using a custom registry
    • Custom Secret Management
    • Request tracing
      • Certificates for sidecar injection
  • 🔭Open Telemetry
    • Getting started
    • Open telemetry collector
    • Languages
      • Generic Exporter configuration
      • Java
      • Node.js
      • .NET
      • Verify the results
    • Troubleshooting
  • CLI
    • StackState CLI
  • 🚀Self-hosted setup
    • Install StackState
      • Requirements
      • Kubernetes / OpenShift
        • Kubernetes install
        • OpenShift install
        • Required Permissions
        • Non-high availability setup
        • Small profile setup
        • Override default configuration
        • Configure storage
        • Exposing StackState outside of the cluster
      • Initial run guide
      • Troubleshooting
        • Logs
    • Configure StackState
      • Slack notifications
      • Stackpacks
    • Release Notes
      • v1.11.0 - 18/07/2024
      • v1.11.3 - 15/08/2024
      • v1.11.4 - 29/08/2024
      • v1.12.0 - 24/10/2024
      • v1.12.1 - 08/11/2024
    • Upgrade StackState
      • Steps to upgrade
      • Version-specific upgrade instructions
    • Uninstall StackState
    • Air-gapped
      • StackState air-gapped
      • StackState Kubernetes Agent air-gapped
    • Data management
      • Backup and Restore
        • Kubernetes backup
        • Configuration backup
      • Data retention
      • Clear stored data
    • Security
      • Authentication
        • Authentication options
        • File-based
        • LDAP
        • Open ID Connect (OIDC)
        • KeyCloak
        • Service tokens
      • RBAC
        • Role-based Access Control
        • Permissions
        • Roles
        • Scopes
      • Self-signed certificates
  • 🔐Security
    • Service Tokens
    • Ingestion API Keys
  • ☁️SaaS
    • User Management
  • Reference
    • StackState Query Language (STQL)
    • Chart units
Powered by GitBook
LogoLogo

Legal notices

  • Privacy
  • Cookies
  • Responsible disclosure
  • SOC 2/SOC 3
On this page
  • Overview
  • Timeline
  • Telemetry interval
  • Topology time
  • Health
  • Events
  • Time travel
  1. Views

Timeline and time travel

StackState v6.0

PreviousTraces perspectiveNextNetwork configuration

Last updated 10 months ago

Overview

The timeline at the bottom of the StackState UI allows you to travel back in time to the state of the topology at a specific point in the past. You can then navigate through all telemetry available for the selected topology snapshot. Health and events charts in the timeline give an overview of the state of the topology during the selected telemetry interval.

Timeline

Telemetry interval

The telemetry interval specifies the time window for which events, metrics and traces are available in the StackState perspectives. It runs from left to right on the timeline.

The selected telemetry interval can be either relative (live mode), or set to a custom telemetry interval (time travel mode). By default, the telemetry interval is set to a relative telemetry interval - in live mode and shows telemetry from the last hour. You can zoom in/out or set a custom telemetry interval to view telemetry from a specific point in time.

Set the telemetry interval

  • The telemetry interval can be a maximum of 6 months.

The telemetry interval can be set in the following ways:

  • Zoom in

  • Zoom out

  • Use the telemetry interval jumper arrows

  • Set a relative or custom telemetry interval

Topology time

On the timeline, the selected topology time is indicated by the play head - a black line with the current topology time at the top. It's also specified in the Topology time box at the top of the timeline.

Set the topology time

The topology time can be set in the following ways:

  • Click on the timeline

  • Use the topology time jumper arrows

  • Set a custom topology time

  • Click a timestamp

Topology time outside the telemetry interval

You can still browse topology and telemetry as expected:

  • In all perspectives, telemetry is displayed that was generated in the selected telemetry interval and relates to the topology elements that existed at the selected topology time.

Live mode

To stop time travelling and return the topology time to live mode, click Go live or BACK TO LIVE at the top of the screen.

Health

The health state of a view during the selected telemetry interval is displayed as a colour in the timeline Health line.

For single resources, the health will be shown over time, in an overview a grey line is displayed.

Events

To zoom in on an event bar of interest, click and drag to select a smaller telemetry interval around it on the timeline.

Time travel

In each of the StackState perspectives, you can either be in live mode or in the past. In live mode, StackState will constantly poll for new data. When you time-travel through topology or telemetry, you are effectively working with a snapshot of your infrastructure. The data available is based on two selections:

To stop time travelling and return to live mode, click Go live or BACK TO LIVE at the top of the screen.

When a custom telemetry interval is set for the telemetry interval, StackState will pause the and enter .

The topology in StackState is based on a snapshot of your environments as observed at that moment. The moment from which this snapshot is taken is specified by the topology time. By default, StackState is in live mode with the topology time set to the current time. You can to a previous state of the topology by selecting a custom topology time. This helps you to investigate an issue at a certain moment in time. Even if a pod is long gone you can still see how it was connected, its logs, events, related resources, events and more.

If the selected topology time is a time outside the currently selected , the message "The topology time is out of the current telemetry interval" will be displayed and the Topology time box at the top of the timeline will be highlighted black. As the timeline shows the telemetry interval from left to right, the play head indicating the current topology time won't be visible on the timeline.

In the the state of the topology at the selected topology time is visualized.

The Events line in the timeline shows a bar chart with the number of events generated at each point in time. This helps you to see moments in the past with a lot of activity. Note that only events generated by topology elements that existed at the selected are displayed.

A single click on the timeline will move the play head to this point in time, and thus time travel to the state of the topology at the selected . Only events generated by topology elements that existed at the newly selected topology time will now be displayed.

- a specific moment in time for which you want to fetch a snapshot of your Kubernetes resources.

- the time range for which you want to see telemetry and traces.

🔍
Topology Perspective
topology time
time travel mode
time travel
telemetry interval
topology time
topology time
Topology time
Telemetry interval
Timeline
Telemetry interval
Click and drag on the timeline to set a custom telemetry interval on your selection
Click the magnifying glass to double the size of the telemetry interval
Click the time jumper arrows to move the telemetry interval backwards or forwards through time
Use the popup "Set the telemetry interval" to specify a telemetry interval
Topology time
Click anywhere on the timeline to set the topology time to that moment
Click the topology time jumper arrows to move the topology time backwards or forwards in time to the next set of events
Use the popup "Set the topology time" to specify a topology time
Click a timestamp to jump to that specific topology time
Topology time outside telemetry interval
Go live
Health state not available
Click and drag to select a telemetry interval
Go live