Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Panel

title	Sommaire

Table of Contents

style	none

Contexte

Le check Stats NFS by SNMPv3 va récupérer les statistiques de votre NFS pour vous les renvoyer sous forme de métriques visibles dans l'interface de Visualisation.

Panel

Paramétrage

Le check utilise une des lignes de commandes suivantes selon le modèle d'hôte utilisé :

Code Block

language	bash
theme	Emacs
title	Commande noAuthNoPriv

$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_stats_nfs
    -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 "3"
    --user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
    --level "noAuthNoPriv"

Code Block

language	bash
theme	Emacs
title	Commande authNoPriv

$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_stats_nfs
    -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 "3"
    --user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
    --auth_password "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-AUTH$"
    --auth_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-AUTH$"
    --level "authNoPriv"

Code Block

language	bash
theme	Emacs
title	Commande authPriv

$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_stats_nfs
    -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 "3"
    --user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
    --auth_password "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-AUTH$"
    --priv_passphrase "$_HOSTLINUX-BY-SNMP__V3-PASSPHRASE-PRIV$"
    --auth_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-AUTH$"
    --priv_protocol "$_HOSTLINUX-BY-SNMP__V3-PROTOCOL-PRIV$"
    --level "authPriv"

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
nopanel	true

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

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation

Description

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 ))
nopanel	true

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 :

Situation	Statut	Exemple
Les données ont bien étés collectés.	OK

Résultat

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

Résultat Long

Pas de résultat long.

Métriques

Nom de la métrique	Description
WB_by_s	Quantité de données écrites par seconde ( B/s ).
RB_by_s	Quantité de données lues par seconde ( B/s ).
proc2_W_by_s	Nombre d'écritures par seconde ( NFS version 2 ).
proc2_R_by_s	Nombre de lectures par seconde ( NFS version 2 ).
proc3_W_by_s	Nombre d'écritures par seconde ( NFS version 3 ).
proc3_R_by_s	Nombre de lectures par seconde ( NFS version 3 ).
proc4_W_by_s	Nombre d'écritures par seconde ( NFS version 4 ).
proc4_R_by_s	Nombre de lectures par seconde ( NFS version 4 ).

Erreurs et pré-requis

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

Section
Permission denied: SNMP daemon (snmpd) cannot access /proc/net/rpc/nfsd

Section

Le check va lire le fichier '/proc/net/rpc/nfsd' ce qui nécessite les droits de lecture.

Panel

Section
RESOLUTION :

Section

Cette erreur est très fréquemment générée par le module de sécurité SELinux.
Vous pouvez vérifier si SELinux est activé avec la commande :

Code Block

language	bash
theme	Emacs

sestatus

Vous devriez observer parmi le résultat les ligne suivante :

Code Block

language	bash
theme	Emacs

SELinux status:                 enabled
Current mode:                   enforcing

Si SELinux est bien activé et en mode 'enforcing' , vous pouvez alors rajouter des règles afin de permettre au service SNMP (snmpd) à accéder aux fichiers voulus.
Si un autre module de sécurité est installé sur votre hôte distante, il faudra le configurer de façon similaire.

RÉSOLUTION PAR SCRIPT :

Dans le script de configuration d'hôte livré dans le pack, une option permet de rajouter ces règles.
Déployez le dossier 'supervised-host' sur votre hôte (scp, ftp ..).
Sur l'hôte distante, exécutez :

Code Block

language	bash
theme	Emacs

cd supervised-host
./configure-host.sh --configure-selinux

RÉSOLUTION MANUELLE :

Sur l'hôte distante, exécutez les commandes suivantes :

Code Block

language	bash
theme	Emacs

mkdir -p /etc/selinux/shinken
vim /etc/selinux/shinken/linux-by-SNMP__shinken.te

Dans le fichier, remplissez et sauvegardez :

Code Block

theme	Confluence

module linux-by-SNMP__shinken 1.0;
require {
    type snmpd_t;
    type sysctl_rpc_t;
    type faillog_t;
    class file { read open getattr };
    class dir { search };
}
# Rules for check Stats NFS by SNMPvXXX
# Allow snmpd to read /proc/net/rpc/nfsd
allow snmpd_t sysctl_rpc_t:file { read open getattr };
# Autorisation pour accéder au dossier /proc/net/rpc
allow snmpd_t sysctl_rpc_t:dir { search };

# Rules for check Connection Failed by SNMPvXXX
# Allow snmpd to read /var/log/btmp
allow snmpd_t faillog_t:file { read open getattr };

Puis exécutez :

Code Block

language	bash
theme	Emacs

checkmodule -M -m -o "/etc/selinux/shinken/linux-by-SNMP__shinken.mod" "/etc/selinux/shinken/linux-by-SNMP__shinken.te"
semodule_package -o "/etc/selinux/shinken/linux-by-SNMP__shinken.pp" -m "/etc/selinux/shinken/linux-by-SNMP__shinken.mod"
semodule -i "/etc/selinux/shinken/linux-by-SNMP__shinken.pp"

Ces commandes vont compiler, empaqueter et installer le module SELinux créé.

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

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

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

theme	Emacs

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

theme	Confluence

extend shinken__linux-by-snmp__stats-nfs__nfsd /bin/sh -c "export LC_LANG=C && unset LANG && cat /proc/net/rpc/nfsd"

Section

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

Code Block

language	bash
theme	ConfluenceEmacs

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

Excerpt Include

	Erreurs communes du pack linux-by-SNMP__shinken
	Erreurs communes du pack linux-by-SNMP__shinken
nopanel	true

Page tree

Versions Compared

Old Version 14

New Version 15

Key

Contexte

Paramétrage

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Données spécifiques pour ce check

Données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Données globales

Résultat

Exemple

Interprétation des données

Statut

Résultat

Résultat Long

Métriques

Erreurs et pré-requis

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

Permission denied: SNMP daemon (snmpd) cannot access /proc/net/rpc/nfsd

SNMP agent is not configured with extended exec 'shinkenlinux-by-snmpstats-nfs__nfsd'

Page tree

Page History

Versions Compared

Old Version 14

New Version 15

Key

Contexte

Paramétrage

Données utilisées provenant des modèles

Données communes pour les checks des modèles

Données spécifiques pour ce check

Données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Données globales

Résultat

Exemple

Interprétation des données

Statut

Résultat

Résultat Long

Métriques

Erreurs et pré-requis

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

Permission denied: SNMP daemon (snmpd) cannot access /proc/net/rpc/nfsd

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

SNMP agent is not configured with extended exec 'shinkenlinux-by-snmpstats-nfs__nfsd'