ACC Agent self test - Support and Troubleshooting

ACC Agent self test .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } Overview Starting with Agent Client Collector Framework version 6.0.1, agents can run built-in self-diagnostic tests to validate their configuration, connectivity, and system requirements.

Prerequisites Required Versions:

ACC Agent: 6.0.1 or higher Agent client collector Framework Store Application Plugin: Version 6.0.1 or higher Method 1: ServiceNow Instance Navigate to Agent Client Collector → Agents Open the target agent record Click Run Self Test from the Related Links section Tests execute automatically and results appear in the Agent Self Test Run table (sn_agent_self_test_run) for the particular agent

Method 2: Command Line (Local Execution) Execute directly from the ACC installation directory:

Windows:

cd "C:\Program Files\ServiceNow\agent-client-collector\bin" acc.exe self-test --format=json acc.exe self-test --format=json

Linux: cd /etc/servicenow/agent-client-collector/ ./acc self-test --format=json

Sample json output

{ "systemInfo": { "currentDirectory": "C:\\Program Files\\ServiceNow\\agent-client-collector\\bin", "currentUser": "DOMAIN\\xxxxx", "version": "6.0.1", "buildSha": "08ce45081116c750fff604c5ccb035d63e50d2bd", "buildDate": "2025-11-20T02:42:34Z", "os": "windows", "architecture": "amd64" }, "config": { "configFile": { "path": "C:\\ProgramData\\ServiceNow\\agent-client-collector\\config\\acc.yml", "status": "ok" } }, "results": [ { "name": "MID Server Connection", "alias": "MIDConnectionTest", "description": "Test the connection to the MID server over both HTTP(S) and WebSockets", "result": { "status": "PASS", "message": "Successfully connected to MID server over HTTP(S), WebSockets" }, "durationSeconds": 0.5329741 }, { "name": "Powershell Version", "alias": "PowershellTest", "description": "Validates Powershell installation and version", "result": { "status": "FAIL", "message": "Unable to determine Powershell version", "logs": [ { "level": "ERROR", "message": "command timed out after 7s", "timestamp": 1766241824061 } ] }, "durationSeconds": 7.3389315, "errorCode": "ACC-4208" } ], "summary": { "total": 10, "passed": 7, "failed": 1, "skipped": 2, "durationSeconds": 19.7360035 } }

Tables: sn_agent_self_test_run : Holds the test results data for the agent , link to the error code sn_agent_self_test_log : Error log and command executed is provided

Scripts SelfTestHandler : /sys_script_include.do?sys_id=38950df13b7faa10d913f3ea26e45aa8

CheckDefinition: self-test