Agent Client Collector Framework configuration properties

  • Release version: Zurich
  • Updated July 31, 2025
  • 3 minutes to read

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

    Table 1. Framework configuration properties
    Property Description
    sn_agent.agent_static_import_char_read_limit The 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_time Maximum number of minutes for an agent to successfully upgrade before entering Warning status.

    Default: 30
    sn_agent.agent_version The current ACC-F release version installed on the instance.

    Type: String
    sn_agent.appl_classification_behavior The characteristics and behaviors for applications during Agent Discovery. When set to simple, creates a shell CI.

    Default: simple
    sn_agent.auto_upgrade.enabled When 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_size The 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_size The 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_endpoints Maximum number of MID Web Server endpoint URLs to be selected during agent single line installation.

    Default: 3
    sn_agent.keep_alive.alive_duration The 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_duration The 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.verbosity The 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_query The maximum number of sys IDs to return during GlideRecord queries.

    Default: 400000
    sn_agent.maximum_mids_to_select The maximum number of MID Servers that can be selected for agent setup.

    Default: 20
    sn_agent.min_upgrade_history_per_agent The minimum number of upgrades saved per agent.

    Default: 2
    sn_agent.registration_key_validity.days The 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.days The 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_min The 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_queue When processing ecc_queues, only query those created within the indicated time (in seconds).

    Default: 43200 (12 hours)