Paramètres de la sonde SNMP
Cette liste de paramètres peut être transmise aux sondes SNMP.
Pour obtenir des instructions sur la configuration des paramètres de sonde, consultez Configurer les paramètres de sonde.
| Paramètre | Description | Valeur par défaut |
|---|---|---|
| oid_spec_list | Liste de spécifications OID, une par ligne. Chaque spécification doit être dans l'un des deux formats suivants :
{OID Children} renvoie à une liste de nœuds enfants séparés par des virgules dans les entrées de la table donnée. Par exemple, « ifEntry.ifIndex,ifEntry.ifDescr,ifEntry.ifType » sont des enfants OID de la table « iso.org.dod.internet.mgmt.mib-2.interfaces.ifTable ». Pour plus de commodité, le préfixe d'entrée de table peut être ignoré. (Les enfants précédents peuvent être spécifiés comme suit : « ifIndex,ifDescr,ifType ».) Tout enfant peut inclure un qualificateur de filtre entre parenthèses. Par exemple, l'enfant « entPhysicalContainedIn(=0) » spécifie les entrées de table renvoyées uniquement si la valeur de « entPhysicalContainedIn » est égale à 0. Les opérateurs pris en charge dans l'expression sont les suivants :
Si plusieurs enfants ont une expression de filtre, une correspondance sur l'un des enfants entraîne la lecture de cette entrée. Tout contenu inclus entre (et inséré après) // est ignoré (commentaires). Tout OID qui ne commence pas par « 1.3.6.1 » ou « iso.org.dod.internet » est automatiquement précédé de « 1.3.6.1. ». |
requis |
| source | Adresse IP ou nom d'hôte de l'appareil sur lequel interroger SNMP. | requis |
| index | Index à appliquer après la chaîne de communauté pour l'indexation de la chaîne de communauté de style Cisco (pour l'interrogation du VLAN). | 0 |
| credential_id | Paramètre sys_id d'informations d'identification spécifiques, qui doit être utilisé de préférence avant tout autre. Ce paramètre est destiné à une utilisation interne et n'est pas pris en charge. | aucun |
| credential_tag | Balise d'informations d'identification devant être utilisée. Ce paramètre est destiné à une utilisation interne et n'est pas pris en charge. | aucun |
| timeout | Valeur de délai d'attente (en millisecondes) d'une réponse, plutôt que la valeur par défaut. Vous pouvez utiliser ce paramètre pour remplacer le paramètre de configuration du MID Server SNMP mid.snmp.request.timeout. Remarque : lorsque le paramètre use_getbulk est défini sur true, la valeur de délai d'expiration correspond à une demande GETBULK individuelle. |
1 500 |
| established_session_timeout | Intervalle d'attente (en millisecondes) d'une réponse après la réception d'au moins une réponse. Des valeurs supérieures peuvent être utiles pour collecter des données complètes et précises. Vous pouvez utiliser ce paramètre pour remplacer le paramètre de configuration du MID Server SNMP mid.snmp.session.timeout. | 500 |
| debug | Active la journalisation du débogage. Définir sur vrai pour le mode de débogage. | faux |
| request_interval | Intervalle (en millisecondes) entre les demandes successives d'OID lorsqu'une réponse n'a pas été reçue, jusqu'à ce que la valeur de délai d'expiration (ou established_session_timeout) soit atteinte. Si cette valeur est définie sur au moins la même valeur de délai d'expiration (ou established_session_timeout), une seule demande est envoyée pour un OID particulier. Si vous modifiez la valeur de délai d'expiration (ou established_session_timeout), ajustez l'intervalle de demande en même temps pour éviter d'envoyer trop ou pas assez de demandes pour le même OID, comme il convient pour un environnement donné. | 400 |
| request_delay | Intervalle (en millisecondes) entre la réception d'une réponse et la transmission de la demande suivante. La valeur par défaut est 0 (aucun délai). Cette valeur peut être définie pour ralentir le taux global d'une requête SNMP. | 0 |
| result_format | Renvoie les charges utiles au format JSON pour les sondes suivantes :
Avertissement : l'utilisation de ce paramètre avec d'autres sondes entraîne la défaillance du capteur. |
JSON |
| use_getbulk | Active l'utilisation des demandes GETBULK SNMP pour récupérer des données tabulaires auprès d'appareils SNMP au lieu d'utiliser plusieurs demandes GETNEXT SNMP. Pour les données tabulaires, la demande GETBULK est plus efficace. Quel que soit le type de demande, certains appareils peuvent ne pas renvoyer de résultats lorsqu'ils exécutent d'autres tâches. Ce paramètre est utilisé au niveau de la sonde. La demande GETBULK peut également être définie pour un MID Server individuel, ou globalement pour tous les MID Servers. Les paramètres sont répertoriés par ordre de priorité :
Les paramètres established_session_timeout, request_interval, et request_delay sont ignorés lorsque use_getbulk est défini sur vrai. Au lieu de cela, le paramètre retries est disponible. La configuration du délai d'expiration est la même que celle utilisée par use_getscalar. Par défaut, les sondes suivantes utilisent des demandes GETBULK (la valeur du paramètre est true).
Remarque : ces sondes ont une valeur timeout de 5 000. |
faux |
| use_getscalar | Permet l'utilisation de la récupération et de la gestion simplifiées des valeurs scalaires auprès des appareils SNMP. Les paramètres established_session_timeout, request_interval et request_delay sont ignorés lorsque use_getscalar est défini sur vrai. Au lieu de cela, les paramètres retries et timeout sont disponibles. La configuration du délai d'expiration est la même que celle utilisée par use_getbulk. |
faux |
| retries | Nombre de tentatives supplémentaires de Découverte pour terminer une demande GETBULK individuelle (consultez la rubrique use_getbulk) ou une demande GETNEXT lorsque le paramètre use_getscalar est défini sur vrai. | 2 |