{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":28632,"path":"it-operations-management/agent-client-collector/acc-framework-configuration-properties.md","title":"Agent Client Collector Framework configuration properties","bundle":null,"doc_type":null,"release":"australia","body":"\n# Agent Client Collector Framework configuration properties\n\nDescription of the properties that determine the behavior of Agent Client Collector Framework configuration.\n\n<table id=\"table_w1r_qgs_xyb\"><thead><tr><th>\n\nProperty\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\n**sn\\_agent.agent\\_static\\_import\\_char\\_read\\_limit**\n\n</td><td>\n\nThe character read limit for a given payload item. Relates only to the configuration item being processed and not the total attachment size.Default: 1000000\n\n</td></tr><tr><td>\n\n**sn\\_agent.agent\\_upgrade\\_wait\\_time**\n\n</td><td>\n\nMaximum number of minutes for an agent to successfully upgrade before entering **Warning** status.Default: 30\n\n</td></tr><tr><td>\n\n**sn\\_agent.agent\\_version**\n\n</td><td>\n\nThe current ACC-F release version installed on the instance.Type: String\n\n</td></tr><tr><td>\n\n**sn\\_agent.appl\\_classification\\_behavior**\n\n</td><td>\n\nThe characteristics and behaviors for applications during Agent Discovery. When set to **simple**, creates a shell CI. Default: simple\n\n</td></tr><tr><td>\n\n**sn\\_agent.auto\\_upgrade.enabled**\n\n</td><td>\n\nWhen 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\n\nDefault: false\n\n</td></tr><tr><td>\n\n**sn\\_agent.auto\\_upgrade.max\\_upgrades\\_per\\_handler\\_per\\_hour**\n\n</td><td>\n\nThe maximum number of Agent Client Collector upgrades possible per MID Server every hour.Type: Integer\n\nDefault: 50\n\n**Note:** Modifying this value may negatively affect system performance.\n\n</td></tr><tr><td>\n\n**sn\\_agent.auto\\_upgrade.max\\_upgrades\\_per\\_hour**\n\n</td><td>\n\nThe maximum number of Agent Client Collector upgrades possible for all agents on all MID Servers.Type: Integer\n\nDefault: 1000\n\n**Note:** Modifying this value may negatively affect system performance.\n\n</td></tr><tr><td>\n\n**sn\\_agent.config\\_publish.max\\_payload\\_size**\n\n</td><td>\n\nThe 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\n\n</td></tr><tr><td>\n\n**sn\\_agent.ecc\\_queue.max\\_payload\\_size**\n\n</td><td>\n\nThe maximum allowable payload size for an ECC queue record to be processed by the agent.Default: 5000000\n\n</td></tr><tr><td>\n\n**sn\\_agent.enable\\_auto\\_mid\\_selection**\n\n</td><td>\n\nWhen 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\n\n**Note:** This property determines only whether a list of MID Servers is sent to the agent.\n\n-   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.\n-   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.\n\n</td></tr><tr><td>\n\n**sn\\_agent.installer\\_max\\_endpoints**\n\n</td><td>\n\nMaximum number of MID Web Server endpoint URLs to be selected during agent single line installation.Default: 3\n\n</td></tr><tr><td>\n\n**sn\\_agent.keep\\_alive.alive\\_duration**\n\n</td><td>\n\nThe 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\n\n</td></tr><tr><td>\n\n**sn\\_agent.keep\\_alive.disconnected\\_duration**\n\n</td><td>\n\nThe 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\n\n</td></tr><tr><td>\n\n**sn\\_agent.logging.verbosity**\n\n</td><td>\n\nThe minimum level of messages that are logged for Agent Client Collector Framework. Messages with the indicated status and anything more severe are logged.Options:\n\n-   error\n-   warn\n-   info\n-   debug\n\nDefault: info\n\n</td></tr><tr><td>\n\n**sn\\_agent.max\\_sys\\_ids\\_in\\_query**\n\n</td><td>\n\nThe maximum number of sys IDs to return during GlideRecord queries.Default: 400000\n\n</td></tr><tr><td>\n\n**sn\\_agent.maximum\\_mids\\_to\\_select**\n\n</td><td>\n\nThe maximum number of MID Servers that can be selected for agent setup.Default: 20\n\n</td></tr><tr><td>\n\n**sn\\_agent.min\\_upgrade\\_history\\_per\\_agent**\n\n</td><td>\n\nThe minimum number of upgrades saved per agent.Default: 2\n\n</td></tr><tr><td>\n\n**sn\\_agent.registration\\_key\\_validity.days**\n\n</td><td>\n\nThe number of days after creation of a registration key that the key is valid before it is deleted.Default: 90\n\n</td></tr><tr><td>\n\n**sn\\_agent.registration\\_key\\_notification.days**\n\n</td><td>\n\nThe 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\n\n</td></tr><tr><td>\n\n**sn\\_agent.sync\\_filters\\_interval\\_min**\n\n</td><td>\n\nThe number of minutes after which CMDB changes are detected and then synched to the MID Server.Default: 10\n\n</td></tr><tr><td>\n\n**sn\\_agent.time\\_ago\\_in\\_seconds\\_to\\_query\\_ecc\\_queue**\n\n</td><td>\n\nWhen processing ecc\\_queues, only query those created within the indicated time \\(in seconds\\).Default: 43200 \\(12 hours\\)\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Agent Client Collector Framework reference](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/agent-client-collector/agent-client-collector-reference.md)\n\n"}}