Polling agents: advanced settings

Christophe BENNOURINE

March 07, 2023 15:33

Parameters types and default values

Polling agents monitoring SNMP devices rely on default values for the following parameters:

```
snmpcalldefaulttimeout
```
- Maximum response time (in milliseconds) for an SNMP request to a device
- Default value: 2000ms
```
snmpcalldefaultretrycount
```
- Number of additional retries for an SNMP request to a device
- Default value: 0
```
snmpcalldefaultwalktimeout
```
- Maximum response time (in milliseconds) for an SNMP request to a device during an SNMP inventory
- Default value: 30000ms
```
snmpcalldefaultwalkretrycount
```
- Number of additional attempts for an SNMP request to a device during an SNMP inventory
- Default value: 0
```
snmpalertduration
```
- Duration (in seconds) before global alert is triggered (not related to alerts configured on widgets, for example in case of invalid transformation expression)
- Default value: 300s
```
snmprecoverduration
```
- Duration (in seconds) before global alert recovery (not related to alerts configured on widgets)
- Default value: 300s
```
minimumtimeremainingforsnmpcalls
```
- Minimum time (in milliseconds) allocated to SNMP device monitoring by the polling agent
- Default value: 5000ms

All these values can be modified in the polling agent registry, via a REG_SZ registry key (string value) to be created in:

HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\RG Systemes\RG Supervision\plugins

This key will have to carry the name of the option to be overloaded, and a value according to one of the 2 following formats:

Integer (global setting)
- Applied to all SNMP devices monitored by the polling agent
JSON object (granular setting)
- In the format
```
{"AB01-C2-D3" : 5000, "default": 3000}
```
- Applied to the mentioned device IDs
- Otherwise, the value written in the "default" key is applied
- If none of these keys are present, the default value is applied

The following examples are valid regardless of the option chosen. Be careful to respect the default unit (see Parameters types and default values).

I want my polling agent to make up to 5 attempts per SNMP request for all devices it monitors:
- ```
snmpcalldefaultretrycount = 5
```
I want my polling agent to wait up to 3 seconds per SNMP request for all devices it monitors:
- ```
snmpcalldefaulttimeout = 3000
```
I want my polling agent to make up to 5 attempts per SNMP request on my device "AB01-C2-D3", but only 2 for all others:
- ```
snmpcalldefaultretrycount = {"AB01-C2-D3" : 5, "default": 2}
```
I want my polling agent to wait up to 3 seconds per SNMP request on my "AB01-C2-D3" device, 5 seconds on my "EF45-G6-H7" device, but only 2s for all others:
- ```
snmpcalldefaulttimeout = {"AB01-C2-D3" : 3000, "EF45-G6-H7": 5000, "default": 2000}
```