Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le check Stats Kernel by SNMPv1v2 va récupérer les statistiques de votre kernel pour vous les renvoyer sous forme de métriques visibles dans l'interface de visualisation.


Panel

Paramétrage

Le check utilise la ligne de commande suivante :


Code Block
languagebash
themeEmacs
$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_stats_kernel
    -H "$HOSTADDRESS$"
    -p "$_HOSTLINUX-BY-SNMP__PORT$"
    -t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
    -F "$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-BASE-PATH$/$_HOSTLINUX-BY-SNMP__WORKING-FOLDER-TMP-DIRNAME$"
    --snmp_version "2"
    --community "$_HOSTLINUX-BY-SNMP__V1V2-COMMUNITY$"

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Excerpt Include
Modèle linux-by-SNMPv1v2
Modèle linux-by-SNMPv1v2
nopaneltrue

Les données communes pour certain checks

Excerpt Include
Stats Disks by SNMPv1v2 ( pour le modèle linux-by-SNMPv1v2__advanced )
Stats Disks by SNMPv1v2 ( pour le modèle linux-by-SNMPv1v2__advanced )
nopaneltrue

Données spécifiques pour ce check

Pas de données spécifiques pour ce check

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce check

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Excerpt
Section

Données globales

Section
NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
No Format
USERPLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken/libexec /var/lib/shinken/libexec

Chemin absolu contenant les sondes installés par Shinken.

No Format
LINUX-BY-SNMP__SHINKEN__VENDOR

Non modifiable

( Sauf Admin Shinken )

--shinken-additional-packs shinken-additional-packs

Dossier fournit par shinken.

No Format
LINUX-BY-SNMP__SHINKEN__PACKNAME

Non modifiable

( Sauf Admin Shinken )


linux-by-SNMP__shinken linux-by-SNMP__shinken

Dossier contenant les sondes.

No Format
LINUX-BY-SNMP__SHINKEN__PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--
No Format
USERPLUGINSDIR/LINUX-BY-SNMP__SHINKEN_VENDOR/
LINUX-BY-SNMP__SHINKEN__PACKNAME
/var/lib/shinken-user/libexec/shinken-additional-packs/linux-by-SNMP__shinken

Chemin absolu du dossier contenant les sondes du pack linux-by-SNMP__shinken ( non modifiable ).

Excerpt Include
Memory by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
Memory by SNMPv3 ( pour les modèles linux-by-SNMPv3_( noAuthNoPriv / authNoPriv / authPriv ))
nopaneltrue

Résultat

Exemple

Panel

Interprétation des données

Statut

  • Il peut prendre 3 valeurs  OK / CRITIQUE / INCONNU 

    • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :


Info

Le check calcule des moyennes par rapports aux mesures de ses dernières exécutions. Alors, l'intervalle d'exécution du check va affecter la période sur laquelle ces moyennes sont calculées.

  • Un intervalle d'exécution rapide donnera des moyennes plus volatiles, où il sera plus facile d'observer des pics.
  • Un intervalle d'exécution lent donnera des moyennes plus lissées.

Afin d'assurer la cohérence des données remontée entre chaque exécution, le check détermine l'intervalle d'exécution et va retourner un statut INCONNU lorsque les dernières mesurent sont trop récentes ou trop anciennes.

  • Si le check est configuré pour s'exécuter toutes les cinq minutes de 8h à 00h, la première exécution à 8h aura des dernières mesures anciennes de 8h, et retournera un statut INCONNU.
  • Si le check est configuré pour s'exécuter une fois par jour à midi, et qu'à 12h10 le check est exécuté de force, il aura des mesures trop récentes et retournera un statut INCONNU.


Situation Statut Exemple
  • Les moyenne n'a pas pu être calculé. Les mesures sont trop récentes.
INCONNU 
Panel

  • Les moyenne n'a pas pu être calculé. Les mesures sont dépassées.
INCONNU 
Panel

  • Les moyenne n'a pas pu être calculé. Aucune mesure n'a été trouvée.
INCONNU 
Panel


Résultat

Le résultat contient un message indiquant le statut du check.

Résultat Long

Pas de résultat long.

Métriques

Définition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
pgfault_by_spgfault/sNombre d'erreurs de page ( mineures et majeures ) par seconde.----
pgmajfault_by_spgmajfault/sNombre d'erreurs de page majeures par secondes.----
ctxt_by_sctxt/sNombre de changements de contexte.----
processes_by_sprocesses/sNombre de processus créés par seconde.----

Exemple

Panel

Erreurs et pré-requis

Erreurs de configuration de l'hôte à superviser ( spécifique à ce check )

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 l'erreur suivante les erreurs suivantes :

Panel

Image RemovedImage Added

Panel

Image RemovedImage Added


RESOLUTION :

Info
titleRemarque

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.

Info
titleRemarque

Les instructions suivantes sont à exécuter sur le ou les pollers shinken.

Code Block
languagebash
themeEmacs
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.


Warning

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
Section

SNMP agent is not configured with extended exec 'shinken__linux-by-snmp__stats-kernel__stats_vmstats'

Section

Le check demande une configuration supplémentaire afin d'exécuter des commandes via des requêtes SNMP. Sans cette configuration, l'erreur suivante sera générée :

Panel

Image Removed

Section
RESOLUTION :
Section

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

Code Block
languagebash
themeEmacs
vim /etc/snmp/shinken/linux-by-SNMP__shinken.conf
# vim /etc/snmp/snmpd.conf
Section

Rajoutez cette ligne si elles n'y est pas :

Code Block
themeConfluence
extend shinken__linux-by-snmp__stats-kernel__stats_vmstats /bin/sh -c "export LC_LANG=C && unset LANG &&  cat /proc/stat /proc/vmstat | grep -E 'ctxt\|processes\|pgfault\|pgmajfault\|intr'"

service snmpd restart # Ou bien en utilisant systemctl systemctl restart snmpd
Section

Il faudra ensuite redémarrer le serveur SNMP ( snmpd )

Code Block
languagebash
themeEmacs

Excerpt Include
Erreurs du pack linux-by-SNMP__shinken
Erreurs du pack linux-by-SNMP__shinken
nopaneltrue

...