Skip to content
Use the Agent Client Collector \(ACC\) admin workspace › Use ITOM Infra Services Workspace › ITOM Infra Services Workspace › ITOM Visibility › IT Operations Management
Release: Australia · Updated: 2026-05-18 · Official documentation · View source

Run diagnostics on an Agent Client Collector agent

Run automated self-tests on an Agent Client Collector (ACC) agent from the ITOM Infra Services Workspace to identify and address agent issues. View agent errors and invoke the relevant remediation steps.

Before you begin

  • Agent Client Collector Framework version 6.2.0 or higher must be installed.
  • The agent status must be Up to start a diagnostic run.
  • Role required: agent_client_collector_admin

About this task

Agent diagnostics runs automated self-tests on an ACC agent directly from the agent record. After a run completes, results appear on the All Results, Full Diagnostics, and Partial Diagnostics tabs.

Procedure

  1. Navigate to Workspaces > ITOM Infra Services Workspace.

  2. Select Manage ACC agents to view the list of ACC agents.

  3. Select an agent on the Agents tab to open the agent record.

  4. In the agent feature tree, select Diagnostic tests.

Image omitted: diagnostic-tests.png
Diagnostic tests for an agent

  1. Select Run full diagnostics.

    Results populate across the All Results, Full Diagnostics, and Partial Diagnostics tabs after the run completes. Runs can take up to 60 seconds.

    If results don't appear within 60 seconds, the run timed out. Refresh the page and check for any errors.

    If the MID Server associated with the agent is not reachable, diagnostic runs cannot complete. Verify that the MID Server is running before retrying.

  2. Select an individual test to open its detail page.

    The detail page shows the following information:

AreaDescription
Summary fieldsSeverity, last result, last run timestamp, and the agent the test ran on.
Result History tabA chronological list of past runs with status and expandable log output. Log lines can be copied to the clipboard.
Troubleshooting Guide tabStep-by-step remediation suggestions.Appears only when the test has a known error code with linked guidance.

  1. Select Run this test to run the single test from the page.

  2. To rerun only the failed tests, select Rerun failed tests.

    This button appears only when the run produced failures. Selecting it re-executes only the failed tests and leaves passing tests unchanged.

Parent Topic:Use the Agent Client Collector (ACC) admin workspace