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

Agent Client Collector CPU protection thresholds

When an agent meets the configured thresholds specified in the agent's acc.yml file, it enters CPU protection mode, either for an individual check or for all checks. Agents in CPU protection mode appear in the agent logs with the syntax Agent Protection.

ParameterDescription
agent_cpu_threshold_disabledTo prevent the agent from shutting itself off when CPU memory reaches a certain threshold, set value to True.Default=False
cpu_percentage_limit

The percentage of the agent's CPU usage that sends the agent into CPU protection mode. Default=5

Note: When working with Windows event and metric checks, set this value to 10.

cpu_protection_behavior

Assign individual for the system to disable only the individual check that passed the cpu_percentage_limit value. If multiple checks crossed the threshold, the check with the highest CPU is disabled.Assign all to disable all checks and pause data collection.

Possible values: all, individual

Default: all

repeated_high_cpu_numThe number of consecutive times CPU consumption exceeds the cpu_percentage_limit for the agent to enter CPU protection mode.Default=3
monitor_interval_secIndicates the frequency, in seconds, that the agent monitor runs to check if the cpu_percentage_limit is exceeded.Default=60
proxy_cpu_percentage_limitThe percentage of the agent's CPU usage when the agent is running proxy checks too frequently, that sends the agent into CPU protection mode.Default=80

Parent Topic:Agent Client Collector Framework reference