Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Agent Client Collector data collection properties

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

PropertyDescription
sn_agent.host-data_collection_refresh_duration_secondsThe 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_minutesThe 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_discoWhen 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_daysMaximum 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_versionIndicates 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_orderSpecify 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_orderSpecify 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_containerWhen set to true, indicates that data collection is disabled for containerized agents.Default: true

Parent Topic:Agent Client Collector Framework reference