Agent Health dashboard

concept brazil Updated Sep 10, 2026 2 min read agent-health-dashboard.md
Raw file servicenow.com

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.

[Omitted image "agent-health-dashboard.png"] Alt text: Agent Health Dashboard

Prerequisites

The Agent Client Collector application must be installed.

Required ServiceNow AI Platform roles

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

Access the Events and alerts dashboard

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

  • Navigate to All > AIOps Dashboards > AIOps Operational > Agent Health.
  • Navigate to Workspaces > Service Operations Workspace and select the AIOps Dashboards icon ([Omitted image "aiops-operational-icon.png"] Alt text: 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 Workspaces > Discovery Admin Workspace > Insights and use the enhanced dashboard.

Use case

For examples of how different people in your organization would use this dashboard, see the use case in the following table.

User Dashboard use
admin Visibility into the status of the agents.

Breakdowns

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.

Reports

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.

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.

Search documentation
Search document titles and file paths on the brazil branch