Contexte

Le check Processes Memory Matching [ $KEY$ ] by SNMPv3  permet de vérifier la consommation de la mémoire d'un seul ou plusieurs processus. Il permet donc de garder un œil sur le ou les processus de votre choix.

Le check pour attendre un nombre de processus trouvés minimum ou maximum, et renvoyer une erreur si cette contrainte n'est pas respectée.

Le check utilise une donnée Duplicate Foreach qui permet de générer plusieurs fois le check pour chaque processus ou ensemble de processus à superviser.


Paramétrage

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

 $LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_processes_memory_matching
    -H "$HOSTADDRESS$"
    -p "$_HOSTLINUX-BY-SNMP__PORT$"
    -t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
    -n "$ARG1$"
    -m "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT$"
    -F "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__HIDE-ALL$"
    -S "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL$"
    -r "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__USE-REGEX-TO-MATCH-PROCESS$"
    -w "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN$"
    -c "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT$"
    --snmp_version "3"
    --user "$_HOSTLINUX-BY-SNMP__V3-LOGIN$"
    --level "noAuthNoPriv"

$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_processes_memory_matching
    -H "$HOSTADDRESS$"
    -p "$_HOSTLINUX-BY-SNMP__PORT$"
    -t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
    -n "$ARG1$"
    -m "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT$"
    -F "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__HIDE-ALL$"
    -S "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL$"
    -r "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__USE-REGEX-TO-MATCH-PROCESS$"
    -w "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN$"
    -c "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT$"
    --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"

$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_processes_memory_matching
    -H "$HOSTADDRESS$"
    -p "$_HOSTLINUX-BY-SNMP__PORT$"
    -t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
    -n "$ARG1$"
    -m "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT$"
    -F "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__HIDE-ALL$"
    -S "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL$"
    -r "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__USE-REGEX-TO-MATCH-PROCESS$"
    -w "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN$"
    -c "$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT$,$_SERVICELINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT$"
    --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

Données spécifiques pour ce check

NomModifiable surUnitéDéfautValeur par défaut à l'installation Description
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN

l'Hôte

( Onglet Données )

MB 100 100

Seuil de consommation mémoire au-dessus duquel un ATTENTION est déclenché

Lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut false:

  • Le seuil est comparé à la consommation mémoire individuelle de chaque processus correspondant aux filtres

Lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut true:

  • Le seuil est comparé à la somme de consommation mémoire de l'ensemble des processus correspondant aux filtres
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT

l'Hôte

( Onglet Données )

MB 200 200

Seuil de consommation mémoire au-dessus duquel un CRITIQUE est déclenché

Lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut false:

  • Le seuil est comparé à la consommation mémoire individuelle de chaque processus correspondant aux filtres

Lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut true:

  • Le seuil est comparé à la somme de consommation mémoire de l'ensemble des processus correspondant aux filtres
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN

l'Hôte

( Onglet Données )

-- 1 1 Seuil du nombre de processus trouvés au-dessous duquel un ATTENTION est déclenché
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT

l'Hôte

( Onglet Données )

-- 1 1 Seuil du nombre de processus trouvés au-dessous duquel un  CRITIQUE est déclenché
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN

l'Hôte

( Onglet Données )

-- -1 -1 Seuil du nombre de processus trouvés au-dessus duquel un ATTENTION est déclenché
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT

l'Hôte

( Onglet Données )

-- -1 -1 Seuil du nombre de processus trouvés au-dessus duquel un CRITIQUE est déclenché
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__HIDE-ALL

l'Hôte

( Onglet Données )

-- false false Active/désactive l'affichage des métriques de ce check
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL

l'Hôte

( Onglet Données )

--

false

false

Active/désactive le calcul de la somme de consommation mémoire des processus correspondants aux filtres.

  • Une fois activé, la somme calculé sera comparé aux variables de seuils ci dessous et affecterons le résultat du check :
    • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN
    • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__USE-REGEX-TO-MATCH-PROCESS

l'Hôte

( Onglet Données )

--

false

false Active ou désactive l'utilisation de regex pour l'usage de la variable LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__PROCESSES-TO-CHECK

Voici des exemple de regex si LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__USE-REGEX-TO-MATCH-PROCESS est à t rue :

  • (wsgi:graphite) => \([a-z]+:graphite\)?$$
  • /usr/sbin/httpd => /[^/]?+/httpd$$

Données DFE ( Duplicate Foreach )

DonnéeDescriptionExemple
LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__PROCESSES-TO-CHECK


Définit une paire KEY$(VALUE)$, la KEY correspond à la description du processus à vérifier et la VALUE au nom du processus.

SYSTEM$(/usr/lib/systemd/systemd)$, DATABASE$(mongod)$


Modifier les données accrochées à l'hôte affectera l'ensemble des checks dupliqués.
Afin de paramétrer individuellement chaque checks, il est possible de surcharger les données des checks.


Données utilisées provenant du check

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

Résultat

Exemple

Interprétation

Statut

  • Il peut prendre quatre valeurs    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 :

      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN
      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT
      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN
      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT
      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN
      • LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT

    • 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

  • Aucun processus n'a été trouvé

CRITIQUE

  • Les charges mémoires des processus trouvés dépassent la valeur de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN
ATTENTION 

  • Les charges mémoires des processus trouvés dépassent la valeur de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT

CRITIQUE

  • La somme des charges mémoires des processus trouvés dépassent la valeur de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-WARN , lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut true

 ATTENTION 

  • La somme des charges mémoires des processus trouvés dépassent la valeur de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MEMORY-CRIT , lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut true

CRITIQUE

  • Moins de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-WARN ont été trouvés

ATTENTION 

  • Moins de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MIN-PROCESS-COUNT-CRIT ont été trouvés

CRITIQUE

  • Plus de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-WARN ont été trouvés

  ATTENTION 

  • Plus de LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__MAX-PROCESS-COUNT-CRIT ont été trouvés

  CRITIQUE

Résultat

Le résultat contient un message indiquant le status, le nombre de processus trouvés, mais aussi s'il consomme plus ou moins que les seuils indiqués.

Résultat Long

Pas de résultat long pour ce check.

Métriques

Nom de la métriqueDescription

--_PROCESS_MEMORY_SUM_--

La somme de la consommation mémoire en MB de tous les processus correspondant aux filtres.

  • Cette métrique n'est générée uniquement lorsque LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__SUM-ALL vaut true

( nom_du_process )

Consommation mémoire en MB d'un processus correspondant aux filtres.
Le nom de cette métrique correspond au nom complet du processus trouvé.

Autant de métrique que de processus différents trouvés seront générés.

  • Dans l'exemple avec le mot clé "SHINKEN", 20 processus correspondent et donc 20 métriques seront remontées.

Il est possible de ne retourner aucune métrique en configurant l'option LINUX-BY-SNMP__PROCESSES-MEMORY-MATCHING__HIDE-ALL du check.

Erreurs et pré-requis