Agent Health dashboard

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
    • Summarize
    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 in ServiceNow provides comprehensive visibility into the status and distribution of agents installed within your system. It enables you to quickly evaluate how many agents are deployed, their operational status, and key attributes such as version, operating system, and assigned MID Server. This insight helps you prioritize tasks efficiently and maintain optimal agent performance.

    Show full answer Show less

    Prerequisites and Access

    • The Agent Client Collector application must be installed.
    • Users require the agentclientcollectoradmin role to access all dashboard widgets.
    • The dashboard can be accessed via the navigation paths:
      • All > AIOps Dashboards > AIOps Operational > Agent Health
      • Workspaces > Service Operations Workspace > AIOps Dashboards icon > Agent Health tab
      • After upgrading to Discovery Admin Workspace version 1.3.1 (August 2024 Store), via Workspaces > Discovery Admin Workspace > Insights for an enhanced view.

    Key Features

    • Agent Status Monitoring: Visualizes agents that are currently up or down.
    • Data Collection Status: Shows which agents have data collection enabled or disabled.
    • CPU Threshold Monitoring: Identifies agents that have automatically stopped data collection after exceeding a configurable CPU usage threshold (set in acc.yml).
    • Agent Distribution Breakdowns: Displays agent distributions by version number, assigned MID Server, and operating system.

    Reports and Visualizations

    • Agent Status Breakdown: Pie chart showing deployed agents that are up or down, with interactive selection to view corresponding agent lists.
    • Agent by Data Collection Status: Pie chart highlighting agents with data collection on or off, with drill-down capability.
    • Silent/Off (auto) Agents: Line graph showing agents that stopped data collection due to CPU threshold breaches.
    • Agent by Version: Bar chart categorizing agents by their version numbers.
    • Agent by MID Server: Bar chart displaying agents according to their assigned MID Server.
    • Agent by OS: Bar chart showing agent distribution across operating systems.

    Use Case

    The dashboard delivers critical operational insights for administrators and IT teams by providing real-time data on agent health and performance, helping to quickly identify issues, allocate resources, and maintain system stability.

    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.

    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 (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.
    Table 1. Dashboard use case
    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.