# Service Health Dashboard

The Service Health dashboard provides a real-time view of core platform services, host connectivity, and API endpoint availability across your <code class="expression">space.vars.product\_name</code> 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 <code class="expression">space.vars.product\_acronym</code> 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:

```bash
pcdctl compute service list --service nova-compute
```

#### Image Service health

| Status       | Description                                                                                                                              |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Healthy      | <code class="expression">space.vars.product\_acronym</code> 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

<table><thead><tr><th width="348.05859375">Status</th><th>Description</th></tr></thead><tbody><tr><td>Healthy</td><td>The storage service on the host is operating normally.</td></tr><tr><td>Needs Action</td><td>One or more hosts running the Persistent Storage Service require attention.</td></tr></tbody></table>

#### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.platform9.com/private-cloud-director/2026.1/monitoring-and-observability/service-health-dashboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.