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
  • SUSE Observability quick start guides
  • Overview
  • Kubernetes
  • OpenShift
  • Amazon EKS
  • Google GKE
  • Azure AKS
  • KOPS
  • Self-hosted
  • What's next?
  1. Get started

Quick start guide

SUSE Observability

PreviousDocs for all SUSE Observability productsNextSUSE Observability walk-through

Last updated 3 months ago

SUSE Observability quick start guides

Overview

When your SUSE Observability SaaS instance has been set up and configured, you will receive an email from SUSE Observability with the required login details. This quick start guide will help you get started and get your own data into your SUSE Observability SaaS instance.

To integrate your cluster(s) with SUSE Observability you can follow one of these guides for your appropriate environment.


Kubernetes

Set up a Kubernetes integration to collect topology, events, logs, change and metrics data from a Kubernetes cluster and make this available in SUSE Observability.

Supported versions

Supported Kubernetes Version

Kubernetes 1.32

Kubernetes 1.31

Kubernetes 1.30

Kubernetes 1.29

Kubernetes 1.28

Kubernetes 1.27

Kubernetes 1.26

Kubernetes 1.25

Kubernetes 1.24

Kubernetes 1.23

Kubernetes 1.22

Kubernetes 1.21

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for Kubernetes

To set up a SUSE Observability Kubernetes integration you need to have:

  • An up-and-running Kubernetes Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up a Kubernetes integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


OpenShift

Set up an OpenShift integration to collect topology, events, logs, change and metrics data from a OpenShift cluster and make this available in SUSE Observability.

Supported versions

OpenShift Version
Supported Kubernetes Version
OpenShift End of Support

OpenShift 4.17

Kubernetes 1.30

April 1, 2026

OpenShift 4.16

Kubernetes 1.29

December 27, 2025

OpenShift 4.15

Kubernetes 1.28

August 27, 2025

OpenShift 4.14

Kubernetes 1.27

May 1, 2025

OpenShift 4.13

Kubernetes 1.26

November 17, 2024

OpenShift 4.12

Kubernetes 1.25

July 17, 2024

OpenShift 4.11

Kubernetes 1.24

February 10, 2024

OpenShift 4.10

Kubernetes 1.23

September 10, 2023

OpenShift 4.9

Kubernetes 1.22

April 18, 2023

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for OpenShift

To set up a SUSE Observability OpenShift integration you need to have:

  • An up-and-running OpenShift Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up an OpenShift integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


Amazon EKS

Set up an Amazon EKS integration to collect topology, events, logs, change and metrics data from an Amazon EKS cluster and make this available in SUSE Observability.

Supported versions

Kubernetes version
Amazon EKS release
Amazon EKS End of Support
Amazon EKS End of Extended Support

1.32

January 23, 2025

March 23, 2026

March 23, 2027

1.31

September 26, 2024

November 26, 2025

November 26, 2026

1.30

May 23, 2024

July 23, 2025

July 23, 2026

1.29

January 23, 2024

March 23, 2025

March 23, 2026

1.28

September 26, 2023

November 01, 2024

November 26, 2025

1.27

May 24, 2023

July 2024

July 24, 2025

1.26

April 11, 2023

June 2024

June 11, 2025

1.25

February 21, 2023

May 2024

May 1, 2025

1.24

November 15, 2022

January 2024

January 31, 2025

1.23

August 11, 2022

October 11, 2023

October 11, 2024

1.22

April 4, 2022

June 4, 2023

September 1, 2024

1.21

July 19, 2021

February 15, 2023

July 15, 2024

1.20

May 18, 2021

November 1, 2022

N/A

1.19

February 16, 2021

August 1, 2022

N/A

1.18

October 13, 2020

August 15, 2022

N/A

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for Amazon EKS

To set up a SUSE Observability Amazon EKS integration you need to have:

  • An up-and-running Amazon EKS Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up an Amazon EKS integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


Google GKE

Set up a Google GKE integration to collect topology, events, logs, change and metrics data from an Google GKE cluster and make this available in SUSE Observability.

Supported versions

Kubernetes Version
Google GKE release
Google GKE End of Support
Google GKE End of Extended Support

1.32

February, 2025

Q2, 2026

Q1, 2027

1.31

October 22, 2024

December 22, 2025

October 22, 2026

1.30

July 30, 2024

September 30, 2025

July 30, 2026

1.29

January 25, 2024

March 21, 2025

January 25, 2026

1.28

December 4, 2023

February 4, 2025

December 4, 2025

1.27

June 14, 2023

August 31, 2024

June 14, 2025

1.26

April 14, 2023

June 30, 2024

N/A

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for Google GKE

To set up a SUSE Observability Google GKE integration you need to have:

  • An up-and-running Google GKE Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up a Google GKE integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


Azure AKS

Set up an Azure AKS integration to collect topology, events, logs, change and metrics data from an Azure AKS cluster and make this available in SUSE Observability.

Supported versions

Kubernetes Version
AKS GA
Azure AKS End of Life
Platform support

1.32

June 2024

March 2026

Until 1.36 GA

1.31

November 2024

November 2025

Until 1.35 GA

1.30

June 2024

July 2025

Until 1.34 GA

1.29

March 2024

Januanry 2025

Until 1.33 GA

1.28

November 2023

November 2024

Until 1.32 GA

1.27

July 2023

July 2024

July 2025

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for Azure AKS

To set up a SUSE Observability Azure AKS integration you need to have:

  • An up-and-running Azure AKS Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up a Azure AKS integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


KOPS

Set up a KOPS integration to collect topology, events, logs, change and metrics data from an KOPS cluster and make this available in SUSE Observability.

Supported versions

Supported Kubernetes Version

Kubernetes 1.32

Kubernetes 1.31

Kubernetes 1.30

Kubernetes 1.29

Kubernetes 1.28

Kubernetes 1.27

Kubernetes 1.26

Kubernetes 1.25

Kubernetes 1.24

Kubernetes 1.23

Kubernetes 1.22

Kubernetes 1.21

Kubernetes 1.20

Kubernetes 1.19

Kubernetes 1.18

Kubernetes 1.17

Kubernetes 1.16

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for KOPS

To set up a SUSE Observability KOPS integration you need to have:

  • An up-and-running KOPS Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to grant SUSE Observability Agents permissions to access the Kubernetes API.

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up a KOPS integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


Self-hosted

Set up a Self-hosted integration to collect topology, events, logs, change and metrics data from an Self-hosted cluster and make this available in SUSE Observability.

Supported versions

Supported Kubernetes Version

Kubernetes 1.32

Kubernetes 1.31

Kubernetes 1.30

Kubernetes 1.29

Kubernetes 1.28

Kubernetes 1.27

Kubernetes 1.26

Kubernetes 1.25

Kubernetes 1.24

Kubernetes 1.23

Kubernetes 1.22

Kubernetes 1.21

Kubernetes 1.20

Kubernetes 1.19

Kubernetes 1.18

Kubernetes 1.17

Kubernetes 1.16

Supported runtime

Supported runtime

ContainerD

CRI-O

Prerequisites for Self-hosted

To set up a SUSE Observability Self-hosted integration you need to have:

  • An up-and-running Self-hosted Cluster.

  • Helm version 3.13.1 or higher.

  • A user with the permission to create privileged pods, ClusterRoles and ClusterRoleBindings:

    • ClusterRole and ClusterRoleBinding are needed to:

      • Grant SUSE Observability Agents permissions to access the Kubernetes API

    • SUSE Observability Agents need to run in a privileged pod to be able to gather information on network connections and host information.

Set up a self-hosted integration

To get data from a Kubernetes cluster into SUSE Observability, follow the steps described below:

  1. Add the SUSE Observability helm repository to the local helm client:

    helm repo add suse-observability https://charts.rancher.com/server-charts/prime/suse-observability
    helm repo update
  2. In the SUSE Observability UI, open the main menu by clicking in the top left of the screen and go to StackPacks > Integrations > Kubernetes.

  3. Install a new instance of the Kubernetes StackPack:

    • Specify a Kubernetes Cluster Name

      • This name will be used to identify the cluster in SUSE Observability

    • Click install.

  4. Deploy the SUSE Observability Agent, Cluster Agent, Checks Agent and kube-state-metrics on your Cluster using the helm command provided in the SUSE Observability UI after you have installed the StackPack.

    • Once the Agents have been deployed, they will begin collecting data and push this to SUSE Observability


What's next?

Before you begin, check the .

When running on a self-hosted air-gapped environment prepare the agent installation first with the .

Before you begin, check the .

Before you begin, check the .

Before you begin, check the .

Before you begin, check the .

Before you begin, check the .

Generate a secret for the mutating validation webhook which is part of

Before you begin, check the .

🚀
air-gapped instructions
request tracing
SUSE Observability walk-through
Amazon EKS
Azure AKS
Google GKE
Kubernetes
KOPS
OpenShift
Self-hosted
prerequisites for Kubernetes
prerequisites for Kubernetes
prerequisites for Kubernetes
prerequisites for Kubernetes
prerequisites for Kubernetes
prerequisites for Kubernetes
prerequisites for Kubernetes