Contexte

Vous retrouverez dans cette page les erreurs fréquentes liées à une mauvaise configuration, authentification ou problèmes de connexion.

Les Erreurs

Erreurs de connexion ( communes à tous les checks )

Session error: timeout

La connexion SNMP est configuré par défaut pour se couper si aucune réponse n'est perçu après cinq secondes ( paramétrable avec LINUX-BY-SNMP__TIMEOUT ).


Cette erreur peut intervenir lorsque :

  • Aucun accès réseau n'est disponible vers l'hôte.
  • En SNMP v1 ou v2, la communauté utilisée est incorrecte.
  • En SNMP v3, la clef privée ( LINUX-BY-SNMP__V3-PASSPHRASE-PRIV ) utilisée est incorrecte.

Failed to create SNMP session. Got error: failed to lookup address information: Name or service not known

La résolution DNS de l'hôte a échoué.


Session error: Unexpected report: authentication failure

L'authentification SNMP v3 a échoué.



Cette erreur peut intervenir lorsque :

  • En SNMP v3, le mot de passe ( LINUX-BY-SNMP__V3-PASSPHRASE-AUTH ) utilisée est incorrecte.
  • En SNMP v3, la méthode de hachage ( LINUX-BY-SNMP__V3-PROTOCOL-AUTH ) utilisée est incorrecte.

Session error: Unexpected report: unknown user name

L'utilisateur SNMP v3 utilisé n'existe pas.




Erreurs de configuration de l'hôte à superviser ( communes à tous les checks )

Les deux erreurs suivantes peuvent arriver sur la version SNMPv2 et SNMPv3.

End of current MIB view: no data is available for the requested OID range.

No such object: the requested OID is not available in the configuration view of the MIB.


En SNMPv2 ou SNMPv3, assurez-vous que la communauté (SNMPv2) ou l'utilisateur (SNMPv3) utilisé sur l'hôte supervisé dispose des permissions nécessaires pour accéder à l'arbre SNMP.


Résolution :

Les instructions suivantes sont à exécuter sur l'hôte supervisé.


Arrêtez le service SNMP.

service snmpd stop


Ouvrez le fichier de configuration SNMP. ( "/etc/snmp/shinken/linux-by-SNMP__shinken.conf" ou "/etc/snmp/snmpd.conf" selon votre configuration ).

vim /etc/snmp/shinken/linux-by-SNMP__shinken.conf
# vim /etc/snmp/snmpd.conf


Configuration SNMPv2 :

Vérifiez que la communauté dispose bien des autorisations nécessaires.

#       sec.name        source        community
com2sec notConfigUser   default       public
 
#       groupName       securityModel  securityName
group   notConfigGroup  v1             notConfigUser
group   notConfigGroup  v2c            notConfigUser

#       name          incl/excl     subtree         mask(optional)
view    shinken       included      .1.3.6.1
 
#        group           context  sec.model  sec.level  prefix  read        write  notif
access   notConfigGroup  ""       any        noauth     exact   shinken  none   none


Explication des paramètres :

  • com2sec : Associe un nom de sécurité notConfigUser à la communauté SNMP public.

  • group : Associe ce nom de sécurité à un groupe notConfigGroup pour SNMPv2c.

  • view : Définit une vue nommée shinken qui inclut tout l'arbre SNMP ( .1.3.6.1 ).

  • access : Donne à notConfigGroup un accès en lecture à la vue shinken.


Configuration SNMPv3

Pour SNMPv3, assurez-vous que l'utilisateur SNMP est bien défini avec les bons droits d'accès.

#       groupName       securityModel  securityName
group   notConfigGroup  usm            shinken

#       name          incl/excl     subtree         mask(optional)
view    shinken       included      .1.3.6.1

#        group           context  sec.model  sec.level  prefix  read        write  notif
access   notConfigGroup  ""       any        noauth     exact   shinken  none   none


Explication des paramètres :

  • group : Associe cet utilisateur au groupe notConfigGroup .

  • view : Définit une vue nommée shinken qui inclut tout l'arbre SNMP ( .1.3.6.1 ).

  • access  : Donne à notConfigGroup un accès en lecture sécurisé à la vue shinken.


Redémarrez le service SNMP  :

service snmpd start

Disks Usage by SNMPvX

No mounted partition has been found on the host. Please ensure host's snmpd.conf allow disks data to be fetched.

Le serveur SNMP doit être configuré pour autoriser la récupération des informations des disques. S'il n'est pas configuré, vous obtiendrez l'erreur suivante :


Résolution :

Les instructions suivantes sont à exécuter sur l'hôte supervisé.


Arrêtez le service SNMP.

service snmpd stop


Ouvrez le fichier de configuration SNMP. ( "/etc/snmp/shinken/linux-by-SNMP__shinken.conf" ou "/etc/snmp/snmpd.conf" selon votre configuration ).

vim /etc/snmp/shinken/linux-by-SNMP__shinken.conf
# vim /etc/snmp/snmpd.conf


Vérifiez que cette ligne est présente, ou ajoutez la : includeAllDisks 10%

includeAllDisks 10%


Redémarrez le service SNMP  :

service snmpd start

Stats CPU by SNMPvX

Ntp Sync by SNMPvX

Ntp Sync Chrony by SNMPvX

Erreurs de configuration du poller shinken

Network Interfaces by SNMPvX

Permission denied

Le poller qui exécutera les checks nécessite un droit d'écriture et de lecture dans le répertoire décrit par LINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH/LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME, par défaut /tmp/shinken.

Vous pouvez obtenir les erreurs suivantes :

Résolution

Cette série de commandes ne peut être effectuée qu'en ayant les droits root.

Donc en étant connecté au compte root ou en ayant fait la commande "su" au préalable.

Les instructions suivantes sont à exécuter sur vos pollers

shinken_tmp_dirname="shinken"
mkdir --parents /tmp/$shinken_tmp_dirname
chown -R root:shinken /tmp/$shinken_tmp_dirname
chmod -R g+rwx /tmp/$shinken_tmp_dirname
Explication

1.  La commande mkdir --parents /tmp/$shinken_tmp_dirname crée un récursivement un répertoire.

2. La commande chown -R root:shinken /tmp/$shinken_tmp_dirname modifie le groupe du dossier /tmp/shinken.

  • Cela garantit que des droits peuvent être appliqués au groupe shinken sur ce dossier.

3. La commande chmod -R g+rwx /tmp/$shinken_tmp_dirname applique immédiatement les droits nécessaires au dossier /tmp/shinken pour le groupe shinken.

  • Les droits de lecture, d'écriture et d'exécution sont ajoutés au dossier. Cela permet aux sondes de créer et lire des fichiers dans le dossier /tmp/shinken.


Il est nécessaire d'adapter la variable shinken_tmp_dirname si vous avez modifié l'un des deux variables suivantes :

  • LINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH
  • LINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME