Contexte
Le check Disks Usage SSH analyse les partitions afin de détecter un éventuel manque d'espace libre ( toutes les partitions qui ne sont pas de type tmpfs ).
- Un tableau récapitulatif de toutes les partitions est affiché dans les métriques.
- Ce check indique la proportion occupée ainsi que l'espace utilisé, l'espace libre et la taille de chaque disque.
Paramétrage
Le check utilise la ligne de commande suivante :
$LINUXBYSSH_SHINKEN_PLUGINSDIR$/check_linux_health_by_ssh_rust --check check_disks_usage
-H "$HOSTADDRESS$"
-u "$_HOSTSSH_USER$"
-p "$_HOSTSSH_PORT$"
-i "$_HOSTSSH_KEY$"
-P "$_HOSTSSH_KEY_PASSPHRASE$"
-U "$_HOSTSTORAGE_UNIT$"
-w "$_HOSTSTORAGE_WARN$"
-c "$_HOSTSTORAGE_CRIT$"
-m "$_HOSTSTORAGE_MOUNTS$"
-x "$_HOSTSTORAGE_EXCLUDE_MOUNTS$"
Données utilisées provenant du modèle
Données communes pour les checks des modèles
Authentification
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
SSH_KEY | l'Hôte ( Onglet Données ) | -- | $SSH_KEY_KEY$ | ~/.ssh/id_rsa | Chemin vers la clé SSH privé de l'utilisateur shinken, sur le serveur hébergeant le Poller qui exécutera le check.
|
SSH_KEY_PASSPHRASE | l'Hôte ( Onglet Données ) | -- | $SSH_KEY_PASSPHRASE$ | '' | Phrase secrète utilisée pour déchiffrer la clé privée de l'utilisateur ( si celle-ci est protégée par une passphrase ). La clé privée déchiffré est ensuite utilisée pour authentifier l'utilisateur. |
SSH_PORT | l'Hôte ( Onglet Données ) | -- | $SSH_PORT$ | 22 | Port de connexion SSH. |
SSH_USER | l'Hôte ( Onglet Données ) | -- | $SSH_USER$ | shinken | Nom de l'utilisateur pour se connecter sur le serveur supervisé. |
Données spécifiques pour ce check
| Donnée | Modifiable sur | Unité | Valeur par défaut | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
STORAGE_CRIT | l'Hôte ( Onglet Données ) | % | 90 % | Définit le pourcentage d'utilisation disque d'au moins une partition à partir duquel le check passe en CRITIQUE. | ||||||||||
STORAGE_WARN | l'Hôte ( Onglet Données ) | % | 80 % | Définit le pourcentage d'utilisation disque d'au moins une partition à partir duquel le check passe en ATTENTION . | ||||||||||
STORAGE_MOUNTS | l'Hôte ( Onglet Données ) | -- | ALL | Définit une liste de points de montage qui seront analysés, séparées par des virgules.
| ||||||||||
STORAGE_EXCLUDE_MOUNTS | l'Hôte ( Onglet Données ) | -- | NONE | Définit une liste de points de montage à exclure de l'analyse, séparées par des virgules.
| ||||||||||
STORAGE_UNIT | l'Hôte ( Onglet Données ) | -- | GB | Définit l'unité d'affichage: B, KB, MB, GB ou TB. |
Données utilisées provenant du check
Pas de données spécifiques pour ce check
Résultat
Exemple
Interprétation des données
Statut
Il peut prendre 4 valeurs différentes OK / CRITIQUE / ATTENTION / INCONNU .
Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
- STORAGE_CRIT
- STORAGE_WARN
Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.
Situation | Statut | Exemple |
|---|---|---|
| CRITIQUE |
|
| ATTENTION |
|
Résultat
Le résultat contient le statut du check, ainsi que le nombre de disques dépassant les seuils.
Résultat long
Le résultat long contient un tableau listant les disques trouvés avec :
- Le taux d'utilisation du disque en %.
- La quantité de données utilisées avec l'unité définit dans la variable STORAGE-UNIT.
- La quantité de donnée totale avec l'unité définit dans la variable STORAGE-UNIT.
Métriques
Définition
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| ( NOM_PARTITION )_total | STORAGE_UNIT | Quantité de mémoire totale du disque | -- | -- |
| ( NOM_PARTITION )_used | STORAGE_UNIT | Quantité de mémoire disque utilisée ( utilisant l'unité choisie dans les données ) | ( NOM_DISQUE )_total * STORAGE_WARN / 100 | ( NOM_DISQUE )_total * STORAGE_CRIT / 100 |
| ( NOM_PARTITION )_used_pct | % | Pourcentage d'occupation du disque | STORAGE_WARN | STORAGE_CRIT |
Exemple
Remarques
On remarque que les 3 colonnes Usage / Used / Total ( présentes dans le tableau du résultat long ) ne sont pas tout à fait corrects ( en termes de valeur, par rapport à la taille physique de vos disques ).
- En réalité, pour les partitions formatées en ext2 / ext3 / ext4 / xfs, Linux réserve par défaut 5% d'espace disque pour les opérations de maintenance du système, qui seront accessibles seulement par l'utilisateur "root".
- Cela permet à l'administrateur système de toujours avoir accès à la machine, même si pour les applications, il n'y a plus de place.
- En effet, en faisant le calcul, le pourcentage d'utilisation indiqué par le check ( et aussi la commande "df" de Linux ) ne correspond pas au contenu des colonnes "Used" et "Total". Cette différence est due à ces 5% réservés par le système.
En réalité, le pourcentage est quand même un indicateur fiable pour mesurer l'occupation du disque ( même s'il reste encore de la place "dédié" à l'utilisateur root ) :
- D'une manière générale, les applications ne sont pas démarrées en tant que l'utilisateur "root" ( c'est au minimum très fortement déconseillé pour des raisons évidentes de sécurité ), et n'auront pas accès à cet espace disque réservé par le système.
- Un disque indiqué plein par le check signifie que les applications qui utilisent ce disque auront très probablement des problèmes de fonctionnement et qu'il faut intervenir.
Cet espace réservé par défaut peut être visualisé/modifié avec la commande tune2fs:
Les Erreurs
Erreurs spécifiques à ce check
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 :
- STORAGE_MOUNTS
- STORAGE_EXCLUDE_MOUNTS
RESOLUTION :
Les paramètres suivants doivent être mise à jour :
- STORAGE_MOUNTS
- STORAGE_EXCLUDE_MOUNTS
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
La connexion a échoué, car la paire utilisateur / clef public n'est pas reconnu par l'hôte supervisée.
Résolution : Possibles raisons : La clef privée configurée par la donnée SSH_KEY n'existe pas.
Le mot de passe pour déchiffrer la clef privé n'est pas correct.
Résolution : Vérifier la donnée SSH_KEY_PASSPHRASE. La résolution DNS a échoué.
Résolution : La résolution DNS a échoué.
Résolution :Erreurs de connexion ( communes à tous les checks )
UNKNOWN – Username/PublicKey combination invalid
UNKNOWN – Unable to extract public key from private key file : Unable to open private key file
UNKNOWN – Unable to extract public key from private key file : Wrong passphrase or invalid/unrecognized private key file format
UNKNOWN – Connection refused (os error 111)
Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôteUNKNOWN – Name or service not known
Vérifier l'adresse ou le nom utilisé pour se connecter à l'hôte









