LogoLogo
StackState.comDownloadSupportExplore playground
SUSE Observability
SUSE Observability
  • SUSE Observability docs!
  • Docs for all SUSE Observability products
  • 🚀Get started
    • Quick start guide
    • SUSE Observability walk-through
    • SUSE Rancher Prime
      • Air-gapped
      • Agent Air-gapped
    • SUSE Cloud Observability
  • 🦮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
      • Derived State monitor
      • 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
      • Transactional Increments JSON
    • Debug health synchronization
  • 🔍Views
    • Kubernetes views
    • Custom views
    • Component views
    • Explore views
    • View structure
      • Overview perspective
      • Highlights perspective
      • Topology perspective
      • Events perspective
      • Metrics perspective
      • Traces perspective
      • Filters
      • Keyboard shortcuts
    • Timeline and time travel
  • 🕵️Agent
    • Network configuration
      • Proxy Configuration
    • Using a custom registry
    • Custom Secret Management
      • Custom Secret Management (Deprecated)
    • Request tracing
      • Certificates for sidecar injection
  • 🔭Open Telemetry
    • Overview
    • Getting started
      • Concepts
      • Kubernetes
      • Kubernetes Operator
      • Linux
      • AWS Lambda
    • Open telemetry collector
      • Sampling
      • SUSE Observability OTLP APIs
    • Instrumentation
      • Java
      • Node.js
        • Auto-instrumentation of Lambdas
      • .NET
      • SDK Exporter configuration
    • Troubleshooting
  • CLI
    • SUSE Observability CLI
  • 🚀Self-hosted setup
    • Install SUSE Observability
      • Requirements
      • Kubernetes / OpenShift
        • Kubernetes install
        • OpenShift install
        • Alibaba Cloud ACK install
        • Required Permissions
        • Override default configuration
        • Configure storage
        • Exposing SUSE Observability outside of the cluster
      • Initial run guide
      • Troubleshooting
        • Advanced Troubleshooting
        • Support Package (Logs)
    • Configure SUSE Observability
      • Slack notifications
      • E-mail notifications
      • Stackpacks
      • Advanced
        • Analytics
    • Release Notes
      • v2.0.0 - 11/Sep/2024
      • v2.0.1 - 18/Sep/2024
      • v2.0.2 - 01/Oct/2024
      • v2.1.0 - 29/Oct/2024
      • v2.2.0 - 09/Dec/2024
      • v2.2.1 - 10/Dec/2024
      • v2.3.0 - 30/Jan/2025
      • v2.3.1 - 17/Mar/2025
      • v2.3.2 - 22/Apr/2025
      • v2.3.3 - 07/May/2025
    • Upgrade SUSE Observability
      • Migration from StackState
      • Steps to upgrade
      • Version-specific upgrade instructions
    • Uninstall SUSE Observability
    • Air-gapped
      • SUSE Observability air-gapped
      • SUSE Observability Kubernetes Agent air-gapped
    • Data management
      • Backup and Restore
        • Kubernetes backup
        • Configuration backup
      • Data retention
      • Clear stored data
    • Security
      • Authentication
        • Authentication options
        • Single password
        • File-based
        • LDAP
        • Open ID Connect (OIDC)
          • Microsoft Entra ID
        • KeyCloak
        • Service tokens
        • Troubleshooting
      • RBAC
        • Role-based Access Control
        • Permissions
        • Roles
        • Scopes
      • Self-signed certificates
      • External secrets
  • 🔐Security
    • Service Tokens
    • API Keys
  • ☁️SaaS
    • User Management
  • Reference
    • SUSE Observability Query Language (STQL)
    • Chart units
    • Topology Identifiers
Powered by GitBook
LogoLogo

Legal notices

  • Privacy
  • Cookies
  • Responsible disclosure
  • SOC 2/SOC 3
On this page

Overview

After purchasing SUSE Cloud Observability from the Cloud Provider Marketplace, your SUSE Cloud Observability environment is provisioned.

You will receive an email from SUSE Cloud Observability with the required login details and links to your environment. This quick start guide will help you get started and get your own data into your SUSE Cloud Observability deployment.

Getting Started - First Steps

  1. Setup a password

  2. Login to your SUSE Cloud Observability Instance

  3. Install SUSE Observability agent to your cluster

  4. Change your personal account details

Setup a password

The email from SUSE Cloud Observability contains a unique link which allows you to set your initial password on the account. This must be performed before you can login and configure the observability environment.

Accessing your SUSE Observability Environment

Login in to your SUSE Cloud Observability environment by clicking on the unique link in the email you received from SUSE Cloud Observability. Entering your password will take you to the configuration screen in order to add clusters.

Install SUSE Observability agent to your cluster

SUSE Cloud Observability uses StackPacks in order to make it easier to configure your downstream clusters and get data into the observability environment.

Initially you should be taken to the following screen, to get here, in the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Kubernetes.

Once you are in the Kubernetes StackPack screen, it is very simple to add a cluster to the observability environment.

Enter a name for the cluster you wish to observe, it does not have to match the cluster name used in 'kubeconfig'.

The Kubernetes cluster name must start and end with a lower case letter or digit and can consist of only lower case letters, digits, dots and dashes (. -)

Enter the name and click the Install button. This should take you to the following screen with the cluster flagged as 'Waiting for data'

Click on the cluster name, this will expand this section and reveal a series of information including prerequisits and commands which can be used on your existing clusters to add them to your observability environment.

Review the information and ensure you have the correct permissions to your Kubernetes environment, ensure you are running a supported version of Kubernetes.

These commands are unique to your observability deployment and include the required API Keys and URLs. Select the approriate commands for your cluster, there are sections for EKS, RKE, generic Kubnernetes cluster and many more.

These commands will install the SUSE Cloud Obervability agents and connect the cluster to your SUSE Cloud Observability environment.

After the the cluster has been connected, there should be a green tick in the SUSE Cloud Observability UI.

At this point you can begin exploring your data.

Change your personal account details

Step 4 from your email is to update your personal information. Click the unique link from the email and add your basic personal details as needed. You can also setup 2FA authentication from this section if required.

Explore your data

To start exploring your data, open the main menu by clicking in the top left of the screen and go to Kubernetes to reveal a list of observable items.

Select 'Clusters' from the infrastructure section which should show a list of monitored clusters, select your cluster to reveal one of the many built in views.

At this point you can start exploring the data for your cluster or add more clusters from which to gather data.

For further information on how to use SUSE Cloud Observability, including creating custom views please see the standard documentation.

SUSE Cloud Observability Limitations

Note that SUSE Cloud Observability does not provide out of the box RED signals (Rate, Errors and Duration), only the Rate signal is shown. This feature is available with SUSE Rancher Prime. Customers that need these signals to have a complete Observability solution should contact SUSE to discuss SUSE Rancher Prime, alternatively this data can be collected using the OpenTelemetry collectors.

Additional Information


Last updated 29 days ago

You can use the commands directly from the UI or you can deploy to your downstream clusters by following the commands provided in the 'Deploy the StackState Agent and Cluster Agent' section in the

For further information, including prerequisites and supported Kubernetes versions for your platform, please refer to the .

  1. 🚀Get started

SUSE Cloud Observability

SUSE Cloud Observability

PreviousAgent Air-gappedNextWhat is guided troubleshooting?
  • Overview
  • Getting Started - First Steps
  • Setup a password
  • Accessing your SUSE Observability Environment
  • Install SUSE Observability agent to your cluster
  • Change your personal account details
  • Explore your data
  • SUSE Cloud Observability Limitations
  • Additional Information
quick-start guide
quick start guide
SUSE Cloud Observability - StackPacks
SUSE Cloud Observability - Adding A Cluster
SUSE Cloud Observability - Post Install
SUSE Cloud Observability - Exploring Your Data
SUSE Cloud Observability - Cluster View