---
sourceDocument: Australia IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/it-operations-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Agent Health dashboard

# Agent Health dashboard {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Agent Health dashboard

The Agent Health dashboard offers ServiceNow customers comprehensive visibility into the status and distribution of agents deployed within their system.
It enables quick assessment of how many agents are active, collecting data, or have stopped due to CPU threshold limits.
This insight helps prioritize operational tasks efficiently by understanding agent health metrics such as status, version, operating system, and assigned MID Server.
Show full answer Show less  

## Prerequisites and Access

* The **Agent Client Collector** application must be installed to utilize the dashboard features.
* Users require the **agentclientcollectoradmin** role to view all dashboard widgets.
* The dashboard can be accessed via:
  * All \> AIOps Dashboards \> AIOps Operational \> Agent Health
  * Workspaces \> Service Operations Workspace, then selecting the AIOps Dashboards icon and Agent Health tab
  * After upgrading to Discovery Admin Workspace version 1.3.1, via Workspaces \> Discovery Admin Workspace \> Insights

## Key Features

* **Agent Status Breakdown:** Pie chart showing agents currently up or down, with clickable colors to list specific agents.
* **Agent by Data Collection Status:** Pie chart indicating which agents have data collection turned on or off.
* **Silent/Off (auto) Agents:** Line graph tracking agents that stopped data collection after crossing a configurable CPU usage threshold.
* **Agent by Version:** Bar chart displaying the distribution of agents by their version numbers.
* **Agent by MID Server:** Bar chart showing how agents are assigned across different MID Servers.
* **Agent by OS:** Bar chart representing agent distribution by operating system.

## Practical Use

This dashboard is valuable for administrators and operations teams who need real-time insights into agent performance and health. It supports proactive management by identifying agents that are offline or resource-constrained and by tracking versions and deployment environments. This enables efficient prioritization and troubleshooting to maintain optimal system monitoring coverage.  
The Agent Health dashboard provides visibility into the status and distribution of agents installed in your system. It allows you to quickly assess the number of deployed agents and their distribution, helping you prioritize
your work more efficiently.
The following example shows the agents in your system that are currently up, which agents are configured to collect data, and which agents have stopped data collection due to having reached their CPU threshold (Silent/Off). It also displays the agents according to their version, OS, and connected MID Server.

## Prerequisites {#agent-health-dashboard__section_o51_zgp_pyb}

The Agent Client Collector application must be installed.

## Required ServiceNow AI Platform roles {#agent-health-dashboard__section_tql_2bs_zxb}

A user must have the agent_client_collector_admin role to see all the widgets in the dashboard.

## Access the Events and alerts dashboard {#agent-health-dashboard__section_w4b_mvm_xxb}

To open the dashboard, use one of the following methods:

* Navigate to AllAIOps DashboardsAIOps OperationalAgent Health.
* Navigate to WorkspacesService Operations Workspace and select the AIOps Dashboards icon (![AIOps Dashboards icon.]()) and then select the Agent Health tab.
* After upgrading to Discovery Admin Workspace version 1.3.1 (August 2024 Store), you can navigate to WorkspacesDiscovery Admin WorkspaceInsights and use the enhanced dashboard.

{#agent-health-dashboard__ul_bdn_yhg_1yb}

## Use case {#agent-health-dashboard__section_wql_2bs_zxb}

For examples of how different people in your organization would use this dashboard, see the use case in the following table.{#agent-health-dashboard__table_xql_2bs_zxb__entry__2}

| User | Dashboard use |
|-|-|
| admin | Visibility into the status of the agents. |
[Table 1. Dashboard use case]

{#agent-health-dashboard__table_xql_2bs_zxb}

## Breakdowns {#agent-health-dashboard__section_apb_mvm_xxb}

Breakdowns available in the Agent Health are:  
* Agent status: The status of the agents currently deployed in your system.
* Agent distribution: The distribution of the agents by the agent version number, the MID Server that the agent is assigned to, and the OS that the agent is working on.
{#agent-health-dashboard__ul_t4y_rz2_qyb}

## Reports {#agent-health-dashboard__section_e5g_3rf_xbc}

{#agent-health-dashboard__table_yyl_b4z_xxb__entry__3}

| Title | Type | Description |
|-|-|-|
| Agent status breakdown | Pie chart | Agents deployed in your system that are up and down. Select the relevant color in the widget to display a list of up or down agents. |
| Agent by data collection status | Pie chart | Agents deployed in your system with data collection turned on and off. Select the relevant color in the widget to display a list of agents with data collection on or off. |
| Silent/Off (auto) agents | Line graph | Agents that automatically stopped collecting data after crossing the CPU usage threshold. The CPU usage threshold is configurable in the acc.yml configuration file. For more information on the acc.yml configuration file, see [Configuration file options](https://www.servicenow.com/docs/_gPlDfn5mF5mSgixcbCHPg "Options available in the acc.yml configuration file."). |
| Agent by version | Bar chart | Breakdown of your deployed agents by their version numbers. |
| Agent by MID Server | Bar chart | Breakdown of the deployed agents according to the MID Server they're assigned to. |
| Agent by OS | Bar chart | Breakdown of your deployed agents according to the operating systems they are working on. |
[ ]

{#agent-health-dashboard__table_yyl_b4z_xxb}

*[\>]: and then


