For the complete documentation index, see llms.txt. This page is also available as Markdown.

Service Health Dashboard

Monitor the real-time status of platform services, hosts, and API endpoints in Private Cloud Director.

The Service Health dashboard provides a real-time view of core platform services, host connectivity, and API endpoint availability across your Private Cloud Director setup. Use it to quickly identify services that need attention and drill down to per-host details for troubleshooting.

Access the dashboard

The dashboard is accessible to users with administrator access. To open it, select the heart icon in the top-right corner of the PCD UI, next to the settings icon.

Dashboard overview

The dashboard opens to a summary view with three cards:

Card
Description

Service Health

Overall health of core platform services.

Host Health

Connectivity and service status across hosts.

API Endpoints Health

Availability of platform API endpoints.

Each card shows the counts of healthy, warning, and critical items, along with a status summary. Select a tab to view the details for each category.

Service Health tab

The Service Health tab lists the following platform services:

Service
Description

Compute Service

Handles virtual machine provisioning and management.

Image Service

Manages VM images and snapshots.

Persistent Storage Service

Provides persistent block storage for virtual machines.

Networking Service

Manages virtual networks, subnets, and routing.

Each service row displays:

Field
Description

Status badge

The current health state of the service.

Host counts

A count of healthy, warning, and critical hosts for that service.

Last checked

The timestamp of the most recent health check.

Next check

The timestamp of the next scheduled health check.

Status values

Status
Description

Healthy

The service is operating normally across all hosts.

Needs Action

One or more hosts require attention. The count of affected hosts appears in the badge.

Per-host details

Select the chevron on a service row to expand it. The expanded view shows the following for each host:

Column
Description

Host Name

The hostname of the host running the service.

Cluster Name

The cluster the host belongs to.

Service Health

The health state of the service on that host.

Connectivity Status

The connectivity state of the host.

Role Status

Whether the service role is configured on the host.

IP Addresses

IP addresses associated with the host.

For Persistent Storage Service, the expanded view lists each configured storage backend separately with its own health status per host.

Compute Service health

The overall health of the Compute Service is determined by the percentage of hosts with the hypervisor role that are in an unhealthy state:

Condition
Reported status

50% or more hosts are unhealthy

Unhealthy

More than 25% but fewer than 50% of hosts are unhealthy

Warning

25% or fewer hosts are in an offline state

Healthy

Individual host health for the Compute Service is determined as follows:

Condition
Reported status

Host state is not ok

Unhealthy

Host state is ok and host is in maintenance mode

Warning

Host state is ok and Compute Service status for the host is ok

Healthy

Host state is ok and Compute Service status for the host is not ok

Unhealthy

To retrieve the Compute Service health status at the host level, run:

Image Service health

Status
Description

Healthy

PCD can connect to the Image Service and the service API is responding normally.

Needs Action

One or more hosts running the Image Service require attention.

Persistent Storage Service health

Status
Description

Healthy

The storage service on the host is operating normally.

Needs Action

One or more hosts running the Persistent Storage Service require attention.

Networking Service health

Status
Description

Healthy

The networking service on the host is operating normally.

Needs Action

One or more hosts running the Networking Service require attention.

Host Health tab

The Host Health tab shows a flat table of all hosts in your setup with the health status of each service per host.

The following columns are available:

Column
Description

Host Name

The hostname of the host.

Cluster

The cluster the host belongs to.

Connectivity Status

The connectivity state of the host.

Compute Service

Health status of the Compute Service on the host.

Image Service

Health status of the Image Service on the host.

Persistent Storage Service

Health status of the Persistent Storage Service on the host.

Networking Service

Health status of the Networking Service on the host.

IP Addresses

IP addresses associated with the host.

Use the search bar to filter by host name. Select Refresh to update the data. Select Manage Columns to show or hide columns.

API Endpoints Health tab

The API Endpoints Health tab lists the health status of individual platform API endpoints. The table shows the time the data was last updated.

The following columns are available:

Column
Description

Services

The name of the API endpoint or service.

Status

The current health state.

Error Details

Error information if the endpoint is unavailable.

Actions

A Refresh button to manually trigger a health check for that endpoint.

URL

The endpoint URL. Hidden by default; enable it using Manage Columns.

Select Refresh to update all entries. Select Manage Columns to adjust which columns are visible.

Was this helpful?