Agent Client Collector health instance scan checks

  • Release version: Zurich
  • Updated May 7, 2026
  • 1 minute to read

    • The Agent Client Collector (ACC) health instance scan suite includes checks that detect anomalies and issues on your instance. Use this reference to identify what each check does and when it applies.

    Table 1. ACC Health Instance Scan Suite checks
    Check name Description
    ACC duplicate agent for host CI Identifies configuration items (CIs) associated with multiple active agents, indicating potential issues with CI identification.
    ACC Error Framework Verifies whether the ACCErrorManager has been created, which enables associating errors to the relevant ACC scoped app.

    Detects whether an automation source application, automation error category, and automation error code exist for the Agent Client Collector Framework application.
    ACC find modified script includes Detects modified Agent Client Collector Framework script includes that might have been altered post-upgrade.
    ACC skipped upgrades Reports upgrades that were skipped since the last upgrade.
    Note:
    Skipped upgrades don't generate an error message.
    ACC verify plugin folder hierarchy Validates the correct creation of ACC Plugin folders and flags duplicate folders that may cause synchronization issues.
    ACC active policies count Counts the number of active published policies. If the number exceeds 300, consolidate the policy to improve performance.
    ACC agent to MID Connection Verifies the connection of 1000 agents per 1-GB Java Virtual Machine (JVM) to confirm the MID Server isn't overloaded. If overloaded, configure additional JVMs or redistribute agents to other MID Servers.
    ACC verify sn_agent CI counts match Confirms that the records in the sn_agent_ci_extended_info and sn_agent_cmdb_ci_agent tables match, verifying data consistency for agents.
    ACC ICS Diagnostics Tool Analyzes the ServiceNow instance and its setup with ITOM Cloud Services.
    ACC automation_error_msg cleaner Verifies that the Agent Issues table cleaner exists and is enabled, ensuring ACC-specific error records are regularly cleaned up and the table remains manageable.
    ACC Verify global.ACCInstanceScanUtil exists Detects that the global.ACCInstanceScanUtil file is installed for instances starting with the Xanadu release or later. Without this file, several ACC Health Instance Scan checks don't run.

    Additional information

    For details on importing the global.ACCInstanceScanUtil script include, see the Script Include ACCInstanceScanUtil [KB1630132] article in the HI Knowledge Base.

    For details on running the ACC health instance scan, see Run the Agent Client Collector (ACC) health instance scan as a scheduled job.