Use the health dashboard

Learn how to access and view the StackRox Kubernetes Security Platform health dashboard.

2 minute read

The StackRox system health dashboard provides a single interface for viewing information about the StackRox Kubernetes Security Platform components to help users assess their health.

Health dashboard is only available on the StackRox Kubernetes Security Platform version 3.0.53 and newer.

To access the health dashboard:

  1. On the StackRox Portal, select Platform Configuration > System Health.

The health dashboard organizes information in the following 5 groups:

  1. Cluster Health - Showcases the overall state of the StackRox cluster.
  2. Vulnerability Definitions - Showcases the last update time of vulnerability definitions.
  3. Image Integrations - Showcases the health of all registries that you’ve integrated.
  4. Notifier Integrations - Showcases the health of any notifiers (Slack, email, Jira, and others) you’ve integrated.
  5. Backup Integrations - Showcases the health of any backup providers you’ve integrated.

The dashboard lists the following states for different components:

  1. Healthy - The component is functional.
  2. Degraded - The component is partially unhealthy. This state means the cluster is functional, but some components are unhealthy and require attention.
  3. Unhealthy - This component isn’t healthy and requires immediate attention.
  4. Uninitialized - The component hasn’t yet reported back to Central to have its health assessed. An uninitialized state may sometimes require attention, but often components report back the health status after a while or when the integration is used.

Cluster health

The Cluster Overview shows information about your StackRox Kubernetes Security Platform cluster health. It reports the health information about the following:

  1. Collector Status - It shows whether the Collector pod, which the StackRox Kubernetes Security Platform is using is reporting healthy.
  2. Sensor Status - It shows whether the Sensor pod, which the StackRox Kubernetes Security Platform is using is reporting healthy.
  3. Sensor Upgrade - It shows whether the Sensor is running the correct version when compared with Central.
  4. Credential Expiration - It shows if the credentials for the StackRox Kubernetes Security Platform are nearing expiration.

Clusters in the Uninitialized state aren’t reported in the number of clusters secured by the StackRox Kubernetes Security Platform until they check in.

Vulnerabilities definition

The Vulnerabilities Definition section shows the last time vulnerability definitions were updated and if the definitions are up to date.

Integrations

There are 3 integration sections Image Integrations, Notifier Integrations, and Backup Integrations. Similar to the Cluster Health section, these sections list the number of unhealthy integrations if any exist. Otherwise, all integrations report as healthy.

The Integrations section lists the healthy integrations as 0 if any of the following conditions are met:

  • You haven’t integrated the StackRox Kubernetes Security Platform with any third-party tools, or
  • You have integrated with some tools, but disabled the integrations, or haven’t set up any policy violations.

Generate a diagnostic bundle

You can also generate a diagnostic bundle from the health dashboard. See the Generate a diagnostic bundle topic for more information.

Questions?

We're happy to help! Reach out to us to discuss questions, issues, or feature requests.

© 2021 StackRox Inc. All rights reserved.