Agent Client Collector data collection properties

reference brazil Updated Sep 10, 2026 1 min read acc-data-collection-properties.md
Raw file servicenow.com

Description of the properties that determine the behavior of Agent Client Collector data collection.

Property

Description

sn_agent.host-data_collection_refresh_duration_seconds

The amount of time (in seconds) between agent data collections on the host. Applicable only when no host CI is assigned to the agent.Default: 43200 (12 hours)

sn_agent.disco_minimum_threshold_for_rediscovery_minutes

The minimum number of minutes since the last endpoint Discovery on a given IP before Discovery can be triggered again. This property prevents running endpoint Discovery too often, such as in cases where a network intermittently has a break or a laptop is repeatedly rebooted.Default: 60

sn_agent.disco_disable_ci_clobber_of_agentless_disco

When set to true, indicates that data collected by the ServiceWatch or ServiceNow Discovery sources takes precedence over Agent Client Collector when the threshold in the sn_agent.disco_ci_clobber_of_agentless_disco_threshold_days property hasn’t been exceeded.Default: true

sn_agent.disco_ci_clobber_of_agentless_disco_threshold_days

Maximum number of days since an existing CI has been discovered using agentless Discovery where the existing CI is linked instead of being rediscovered by the agent. Takes effect when endpoint_disco_disable_ci_clobber_of_agentless_disco = true and over 14 days (by default) have passed since a non-ACC Discovery source (such as ServiceWatch or ServiceNow) has discovered the CI. After this threshold has been exceeded, agent Discovery can execute and overwrite an existing CI regardless of whether the CI has been previously discovered by a non-ACC Discovery source. This process presents the most recently discovered data in the CMDB.Default: 14

sn_agent.ci_prefers_ip_version

Indicates whether IPv4 or IPv6 is the preferred version when saving an IP Address value in the IP Address field of the CI record.Default: 4

sn_agent.ci_serial_number.pref_order

Specify the order of the fields to locate a serial number value to be saved to the host CI's serial_number field during agent data collection. Values must be comma-separated, without spaces, and in lowercase.Default: bios,system,uuid,baseboard,chassis

sn_agent.mac_ci_name_pref_order

Specify the order of the values by which the CI record's Name field is populated during macOS data collection. Values must be comma-separated, without spaces, and in lowercase.Default: name,hostname,computer_name,local_hostname

sn_agent.host_data_collection.disable_when_container

When set to true, indicates that data collection is disabled for containerized agents.Default: true

**Parent Topic:**[Agent Client Collector Framework reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/agent-client-collector/agent-client-collector-reference.md)
Search documentation
Search document titles and file paths on the brazil branch