Agent Client Collector Framework reference

Reference topics provide additional information about mapping and fine-tuning application services using Agent Client Collector Framework lists and forms.

Agent Client Collector user roles
Administrators can assign user roles to grant access to the Agent Client Collector. The following standard roles for the Agent Client Collector Framework (ACC-F) are included in the ServiceNow system with the Agent Client Collector installed on it.
Agent Client Collector Framework default checks
Agent Client Collector Framework provides default checks with the base system.
Agent Client Collector diagnostic self tests
The following table describes each diagnostic self-test that runs in the Agent Self Test Run (sn_agent_self_test_run) table.
Agent Client Collector performance and footprint for URL monitoring
The following tables display the agent performance KPIs and its footprint on the host during URL monitoring data collection execution on different operation systems.
Agent Client Collector certificate revocation reasons
The following table lists and describes the possible reasons for revoking an Agent Client Collector certificate to stop communication between the agent and ITOM cloud services.
Agent Client Collector check definition page
The fields to be configured on the Check Definition page, when creating a check definition.
Agent Client Collector data collection properties
Description of the properties that determine the behavior of Agent Client Collector data collection.
Agent Client Collector policy collection properties
Description of the properties that determine the behavior of Agent Client Collector policy collection.
Agent Client Collector Framework configuration properties
Description of the properties that determine the behavior of Agent Client Collector Framework configuration.
Agent Client Collector data collection tables
Agent Client Collector performs data collection based on the scoped apps that you've installed. Agent Client Collector Framework performs basic data collection, and Agent Client Collector for Visibility Content performs enhanced data collection.
Account commands for LocalService, LocalSystem, and gMSA during Windows installation
When installing an agent on a Windows host using a LocalService, LocalSystem, or gMSA account, you must run msi commands to enable the accounts.
Verify API is associated with a live agent
Call the AgentNowHandler.hasAgent API to determine if the CI is associated with a live agent. The API gets a sys_id of the CI and returns a true/false result.
Configuration file options
Options available in the acc.yml configuration file.
Synchronization properties for validating Agent Client Collector plugins
Use the following properties when synchronizing public certificates from the MID Server to the Agent Client Collector.
Agent Client Collector statuses
The following table lists and describes the Agent Client Collector statuses.
Agent Client Collector log levels
The following table displays the available log levels which indicate the severity of Agent Client Collector events.
Agent Client Collector log rotation parameters
If Agent Client Collector logs get too large, they can drain system resources. To ensure system efficiency, configure parameters in the acc.yml file by which to rotate logs out of the system's storage (Windows default location = C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml. Linux default location = /etc/servicenow/agent-client-collector/acc.yml).
Agent Client Collector CPU protection thresholds
When an agent meets the configured thresholds specified in the agent's acc.yml file, it enters CPU protection mode, either for an individual check or for all checks. Agents in CPU protection mode appear in the agent logs with the syntax Agent Protection.
Golden image structure and modularity
The following table outlines the structure and modularity of the golden image mode for cloning agents, based on the operating system (OS) in use.
Agent Client Collector health instance scan checks
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.
Agent onboarding configuration settings
The settings you can customize when generating an Agent Onboarding installation plan. Toggle settings to activate and enable customization.
Agent installation plan steps
After you complete agent onboarding, the system generates an installation plan. The following table describes each step in the plan and the commands or actions required.
Agent Client Collector upgrade properties
System properties that control Agent Client Collector upgrade behavior, including the target version, rate limits, retry logic, and timeouts.
Agent Client Collector upgrade error codes
Error codes generated during Agent Client Collector upgrades, with descriptions and resolution steps.
Supported platforms for Agent Client Collector auto-upgrade
Operating systems and package types supported for Agent Client Collector auto-upgrade, and the minimum agent version required.
MSI installation parameters
The following table describes the MSI parameters used when preparing an agent for installation on a gold image and used with a non-persistent virtual desktop infrastructure (NPVDI) machine.

Parent Topic:Agent Client Collector reference

title	Agent Client Collector Framework reference
description	Reference topics provide additional information about mapping and fine-tuning application services using Agent Client Collector Framework lists and forms.
locale	en-US
canonical_url	https://www.servicenow.com/docs/r/it-operations-management/agent-client-collector/agent-client-collector-reference.html
release	brazil
product	Agent Client Collector
classification	agent-client-collector
topic_type	reference
last_updated	2026-09-10
reading_time_minutes	3
breadcrumb	Agent Client Collector referenceAgent Client CollectorIT Operations Management