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

Agent Client Collector Framework configuration properties

Description of the properties that determine the behavior of Agent Client Collector Framework configuration.

PropertyDescription
sn_agent.agent_static_import_char_read_limitThe character read limit for a given payload item. Relates only to the configuration item being processed and not the total attachment size.Default: 1000000
sn_agent.agent_upgrade_wait_timeMaximum number of minutes for an agent to successfully upgrade before entering Warning status.Default: 30
sn_agent.agent_versionThe current ACC-F release version installed on the instance.Type: String
sn_agent.appl_classification_behaviorThe characteristics and behaviors for applications during Agent Discovery. When set to simple, creates a shell CI. Default: simple
sn_agent.auto_upgrade.enabledWhen set to true, the instance automatically upgrades existing Agent Client Collector installations to the version set in the sn\_agent.agent\_version property, if the agent version is lower than the property's version.Type: Boolean Default: false
sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour

The maximum number of Agent Client Collector upgrades possible per MID Server every hour.Type: Integer

Default: 50

Note: Modifying this value may negatively affect system performance.

sn_agent.auto_upgrade.max_upgrades_per_hour

The maximum number of Agent Client Collector upgrades possible for all agents on all MID Servers.Type: Integer

Default: 1000

Note: Modifying this value may negatively affect system performance.

sn_agent.config_publish.max_payload_sizeThe size, in bytes, that the config\_publish\_payload can reach on the MonitoringProbe ECC queue topic before an error is logged and the payload is skipped.Default: 15000000
sn_agent.ecc_queue.max_payload_sizeThe maximum allowable payload size for an ECC queue record to be processed by the agent.Default: 5000000
sn_agent.enable_auto_mid_selection

When set to true, the instance sends a list of MID Servers to the agents. To enable automatic selection of a MID Server from the list, set the auto-mid-selection property to true in the agents’ acc.yml file. Automatic selection of MID Servers ensures that each agent uses the most efficient available MID Server.Default: false

Note: This property determines only whether a list of MID Servers is sent to the agent.

  • If this property was previously set to true and is then set to false, automatic MID selection is performed on the previously sent MID Server list if the auto-mid-selection property is set to true in the acc.yml file.
  • If this property is set to true and the auto-mid-selection property in the acc.yml file is set to false, no automatic MID Server selection is performed.
sn_agent.installer_max_endpointsMaximum number of MID Web Server endpoint URLs to be selected during agent single line installation.Default: 3
sn_agent.keep_alive.alive_durationThe amount of time, in seconds, within which the agent's last_refreshed timestamp must be updated. After this time period, the agent status moves from Up to Warning. If the indicated time period passes again, the status moves from Warning to Down.Default: 120
sn_agent.keep_alive.disconnected_durationThe amount of time, in seconds, within which the last_keepalive timestamp must be updated. After this time period, the agent status changes from Up to Disconnected. Default: 600
sn_agent.logging.verbosityThe minimum level of messages that are logged for Agent Client Collector Framework. Messages with the indicated status and anything more severe are logged.Options: - error - warn - info - debug Default: info
sn_agent.max_sys_ids_in_queryThe maximum number of sys IDs to return during GlideRecord queries.Default: 400000
sn_agent.maximum_mids_to_selectThe maximum number of MID Servers that can be selected for agent setup.Default: 20
sn_agent.min_upgrade_history_per_agentThe minimum number of upgrades saved per agent.Default: 2
sn_agent.registration_key_validity.daysThe number of days after creation of a registration key that the key is valid before it is deleted.Default: 90
sn_agent.registration_key_notification.daysThe number of days before registration key deletion that an email notification is sent to the key's ownership group, informing of pending deletion.Default: 14
sn_agent.sync_filters_interval_minThe number of minutes after which CMDB changes are detected and then synched to the MID Server.Default: 10
sn_agent.time_ago_in_seconds_to_query_ecc_queueWhen processing ecc\_queues, only query those created within the indicated time \(in seconds\).Default: 43200 \(12 hours\)

Parent Topic:Agent Client Collector Framework reference