Skip to main content
Version: 8.1

Event Threshold Settings

Inductive University

Agent Event Threshold Settings

Watch the video

Overview‚Äč

One of the main functions of the controller is to keep track of connected agents and report when an agent starts to experience performance problems, logs many errors in a short time, or unexpectedly goes offline. Agent events are held in the controller's configured database in the agent_events table. Within this table, you can find three types of event categories: agent, metric, and task. The agent event category is used for major connectivity events, such as loss of connectivity from an agent. The metric event category is used for events that report abnormal agent health statistics, such as abnormally high CPU usage. The task event category does not affect metrics, and is detailed in the Gateway Task Results section.

General Settings‚Äč

To view the event thresholds, go to the Config page on the Gateway Webpage and select Enterprise Administration > Event Thresholds.

Alarm Evaluation‚Äč

This section is for activity and metric events, you can configure alarms to trigger when an event is reported at the warning or error level. You can also set the alarm pipeline that will process the generated alarms. These alarms are triggered by value changes, with the alarm being cleared as soon as it becomes active.

SettingDescription
Enable Activity AlarmsIf true, alarms will be generated for agent activity events, such as when an agent stops responding.
Enable Metrics AlarmsIf true, alarms will be generated for agent metric events.
Enable Task AlarmsIf true, alarms will be generated when a scheduled task fails.
Warning PriorityThe priority assigned to all of the warning thresholds. Options are: Diagnostic, Low, Medium, High, Critical.
Error PriorityThe priority assigned to all of the error thresholds. Options are: Diagnostic, Low, Medium, High, Critical.
Active PipelineThe Pipeline to use for active events. Note that this Pipeline must be created before the alarm event happens, and that the name is case-sensitive. The format should be:

project:ProjectName:``/``pipeline:PipelinePath

Where ProjectName is the name of the project the pipeline resides in, PipelinePath is the path to the pipeline in the project, including any folders. This syntax follows the same pattern as the Name column on the Gateway's Alarm Pipelines page.
Ack PipelineThe Pipeline to use for acknowledgement events. Note that this Pipeline must be created before the alarm event happens, and that the name is case-sensitive.

project:ProjectName:``/``pipeline:PipelinePath

Where ProjectName is the name of the project the pipeline resides in, PipelinePath is the path to the pipeline in the project, including any folders. This syntax follows the same pattern as the Name column on the Gateway's Alarm Pipelines page.

Activity Monitor‚Äč

The Activity Monitor configures how agent inactivity is reported. When contact is lost with an agent, an inactivity warning or error event is fired if the configured time in minutes has elapsed since last contact.

SettingDescription
Inactivity Warning (Minutes)The number of minutes before a warning threshold alarm is activated. (Default is 5.)
Inactivity Error (Minutes)The number of minutes before an error threshold alarm is activated. (Default is 15.)

Advanced Properties - System Metric Thresholds‚Äč

In addition to inactivity alarms, alarms can be set on all agents when certain metrics like CPU usage, number of clients, error rates, and more are reached. Each one has both a warning and an error level.

SettingDescription
CPU Usage Warning (%)The warning level of an Agent's CPU usage. (Default is 70.)
CPU Usage Error (%)The error level of an Agent's CPU usage. (Default is 90.)
Memory Usage Warning (%)The warning level of an Agent's memory (RAM) usage. (Default is 70.)
Memory Usage Error (%)The error level of an Agent's memory (RAM) usage. (Default is 90.)
Errors Per Minute WarningThe warning level of an Agent's error rate (minute). The contents of the Agent's errors can be checked in the Agent's console. (Default is 2.)
Errors Per Minute ErrorThe error level of an Agent's error rate (minute). The contents of the Agent's errors can be checked in the Agent's console. (Default is 5.)
Errors Per Hour WarningThe warning level of an Agent's hourly error rate. The contents of the Agent's errors can be checked in the Agent's console. (Default is 20.)
Errors Per Hour ErrorThe error level of an Agent's hourly error rate. The contents of the Agent's errors can be checked in the Agent's console. (Default is 60.)
Connected Clients WarningThe number of clients connected to that Agent required to raise a warning alarm. (Default is 50.)
Connected Clients ErrorThe number of clients connected to that Agent required to raise an error alarm. (Default is 100.)
DB Utilization Warning (%)Triggered when the utilization of the DB connection pool exceeds the specified percentage. (Default is 80.)
DB Utilization Error (%)Triggered when the utilization of the DB connection pool exceeds the specified percentage. (Default is 100.)