Contexte

Le check Broker - DB - Open Connections vérifie le nombre de connexions en cours sur la base de données.


Lors de la mise à jour de Shinken une montée de version de MongoDB est effectuée. Le check "Broker - DB - Lock Time Percentage" devient obsolète et peut-être désactivé. La source "cfg-file-shinken" propose la désactivation du check, mais ne peut pas le supprimer automatiquement.

Paramétrage

Le check utilise la ligne de commande suivante :

$PLUGINSDIR$/check_shinkendb.py -D -H "$HOSTADDRESS$" -P "$_HOSTDB_PORT$" --connection-method "$_HOSTDB_CONNECTION_METHOD$" 
--ssh-user "$_HOSTDB_SSH_USER$" --ssh-keyfile "$_HOSTDB_SSH_KEY$" --ssh-tunnel-timeout "$_HOSTDB_SSH_TUNNEL_TIMEOUT$" 
-A connections -W "$_HOSTDB_CONNECTIONS_WARN$" -C "$_HOSTDB_CONNECTIONS_CRIT$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

CHECK_SHINKEN_TIMEOUT

l'Hôte

( Onglet Données )

seconde3 3

Temps maximum durant lequel les checks peuvent s'exécuter (  en secondes  ).

Données spécifiques pour ce check

NomModifiable sur UnitéDéfautValeur par défaut à l'installation de ShinkenDescription
DB_PORT

l'Hôte

( Onglet Général )

---27017 27017

Port de la base de données

Autres check(s) impacté(s) :

DB_CONNECTION_METHOD

l'Hôte

( Onglet Général )

---ssh ssh

Méthode de connexion au serveur MongoDB (  "direct" ou "ssh"   )

Autres check(s) impacté(s) :

DB_SSH_USER

l'Hôte

( Onglet Général )

---shinken shinken

Utilisateur distant avec lequel se connecter au serveur hébergeant MongoDB

Autres check(s) impacté(s) :

DB_SSH_KEY

l'Hôte

( Onglet Général )

---~/.ssh/id_rsa ~/.ssh/id_rsa

Clé SSH privée permettant la connexion au serveur hébergeant MongoDB

Autres check(s) impacté(s) :

DB_SSH_TUNNEL_TIMEOUT

l'Hôte

( Onglet Général )

seconde5 5

Temps d'attente maximum autorisé à la connexion au serveur hébergeant MongoDB

Autres check(s) impacté(s) :

DB_USER_NAME

l'Hôte

( Onglet Général )

---NONENONE

Nom de l'utilisateur à utiliser pour l'authentification avec mot de passe à la base MongoDB. 

'NONE' est traitée comme une absence de valeur.

Utile uniquement si l'activation par mot de passe a été activé (  voir la page MongoDB - activation de l'authentification par mot de passe )

Autres check(s) impacté(s) :


DB_USER_PASSWORD

l'Hôte

( Onglet Général )

---NONENONE

Mot de passe de l'utilisateur utilisé pour l'authentification avec mot de passe à la base MongoDB.

'NONE' est traitée comme une absence de valeur.

Utile uniquement si l'activation par mot de passe a été activé (  voir la page MongoDB - activation de l'authentification par mot de passe )

Autres check(s) impacté(s) :


DB_SSL_CA_FILE

l'Hôte

( Onglet Général )

---NONENONE

Chemin vers le fichier de l’autorité de certification ( CA ) utilisé pour vérifier le certificat SSL de MongoDB.

'NONE' est traitée comme une absence de valeur.

Autres check(s) impacté(s) :


DB_SSL_PEM_KEY_FILE

l'Hôte

( Onglet Général )

---NONENONE

Chemin vers le fichier contenant le certificat SSL du client.

'NONE' est traitée comme une absence de valeur.

Autres check(s) impacté(s) :


DB_SSL_PEM_KEY_PASSWORD

l'Hôte

( Onglet Général )

---NONENONE

Mot de passe du certificat SSL du client.

'NONE' est traitée comme une absence de valeur.

Autres check(s) impacté(s) :


DB_SSL_CRL_FILE

l'Hôte

( Onglet Général )

---NONENONE

Chemin vers le fichier CRL ( liste de révocation ) des certificats SSL à rejeter.

'NONE' est traitée comme une absence de valeur.

Autres check(s) impacté(s) :


DB_SSL_ALLOW_INVALID_HOSTNAMES

l'Hôte

( Onglet Général )

---falsefalse

Accepter le certificat SSL de MongoDB même si le nom d’hôte ne correspond pas à celui du serveur.

Autres check(s) impacté(s) :


DB_SSL_ALLOW_INVALID_CERTIFICATES

l'Hôte

( Onglet Général )

---falsefalse

Accepter le certificat SSL de MongoDB même s’il est invalide ( par exemple, expiré ).

Autres check(s) impacté(s) :


DB_CONNECTIONS_WARN

l'Hôte

( Onglet Général )

pourcentage7070

Seuil d'avertissement du nombre de connexions en cours sur la base de données.

DB_CONNECTIONS_CRIT

l'Hôte

( Onglet Général )

pourcentage8080

Seuil critique du nombre de connexions en cours sur la base de données.

Les 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.

Données globales

Propriétés de l'hôte

Résultat

Exemple

Interprétation

Statut

Il peut prendre deux 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 :
    • DB_CONNECTIONS_CRIT
    • DB_CONNECTIONS_WARN
    • DB_SSH_TUNNEL_TIMEOUT
    • CHECK_SHINKEN_TIMEOUT

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

Situation

Statut

En fonction du pourcentage de connexions utilisées  :

  • Si c'est supérieur à DB_CONNECTIONS_CRIT(  par défaut : 80% )
 CRITIQUE

En fonction du pourcentage de connexions utilisées  :

  • Si c'est supérieur à DB_CONNECTIONS_WARN(  par défaut : 70% )
 ATTENTION 

Si la sonde n'a pas eu de réponse du tunnel SSH avant le temps maximum

  • Si supérieur à DB_SSH_TUNNEL_TIMEOUT
    ( par défaut : 5 sec   )
INCONNU

Si la sonde n'a pas eu de réponse avant le temps maximum

  • Si supérieur à CHECK_SHINKEN_TIMEOUT
    ( par défaut : 3 sec   )
INCONNU

Résultat

Renvoi au format texte : 

  • le nombre de connexions ouvertes
  • les statistiques ( pourcentage )

Résultat Long

Pas de résultat long pour ce check.

Métriques

NomUnitéDescription
used_percent
%

Pourcentage de connexions en cours sur la base de données par rapport aux connexions totales disponibles.

current_connections
...Nombre de connexions en cours sur la base de données.
available_connections
...

Nombre de connexions totales disponibles sur la base de données.