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 )

UNKNOWN – 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.

UNKNOWN – 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é.

UNKNOWN – Session error: Socket receive error: host unreachable

La tentative de connexion à l'hôte a échoué à atteindre l'hôte.

Cette erreur peut être générée à cause d'une mauvaise configuration de pare-feu.

UNKNOWN – Session error: Socket receive error: connection refused


La tentative de connexion à l'hôte a été refusé.

Cette erreur peut intervenir lorsque :

  • Un pare-feu bloque la requête
  • Le service SNMP du serveur à supervisé n'est pas démarré.

UNKNOWN – 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.

UNKNOWN – Session error: Unexpected report: unknown user name

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


UNKNOWN – Session error: Unexpected report: unsupported security level.


L'authentification SNMP v3 a échoué. La méthode d'authentification n'est pas authorisé.



Cette erreur peut intervenir lorsque :

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

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

MONITORED HOST - BAD STATE – No [ ... ] data found. This might be due to :


Deux erreurs sont possibles :

  • La vue SNMP configuré n'a pas les droits suffisants.
  • La configuration SNMP n'inclus pas les options "extend" nécessaires au bon fonctionnement des checks.



RESOLUTION :

Il faut vérifier les deux étapes suivantes de la configuration :

Disks Usage by SNMPvX

UI CONFIGURATION - PARAMETER ISSUE – Found [...] mounted partitions on the host, but none is matching the filtering parameters. 

  • Aucun point de montage ne correspond aux paramètres d'inclusions ou d'exclusions :
    • LINUX-BY-SNMP__DISKS-USAGE__INCLUDE-MOUNTPOINTS 
    • LINUX-BY-SNMP__DISKS-USAGE__EXCLUDE-MOUNTPOINTS



RESOLUTION :

Les paramètres suivants doivent être mise à jour :

  • LINUX-BY-SNMP__DISKS-USAGE__INCLUDE-MOUNTPOINTS 
  • LINUX-BY-SNMP__DISKS-USAGE__EXCLUDE-MOUNTPOINTS


Afin de mieux régler les paramètres de filtre, la commande suivante permet de lister les partitions disponibles sur le linux supervisé :

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

df -TP

MONITORED HOST - BAD STATE – No disks data found.

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" ).

vim /etc/snmp/shinken/linux-by-SNMP__shinken.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

Connection Failed by SNMPvX

Stats NFS by SNMPvX

Erreurs de configuration du poller shinken

Erreurs communes à certains checks


POLLER - BAD STATE – Failed to compute average [ ... ] Got 'Permission denied (os error13)

POLLER - BAD STATE – Failed to create sample storage

Les checks concernés sont :

  • Network Interfaces by SNMPv1v2
  • Network Interfaces by SNMPv3
  • Stats Kernel by SNMPv1v2
  • Stats Kernel by SNMPv1v3
  • Stats Disks by SNMPv1v2
  • Stats Disks by SNMPv3


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