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és

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ésDéfautValeur par défaut à l'installation de ShinkenDescription
DB_PORT

Modèle d'hôte

( Onglet Données )

---27017 27017

Port de la base de données.

Autres check(s) impacté(s) :

DB_CONNECTION_METHOD

Modèle d'hôte

( Onglet Données )

---ssh ssh

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

Autres check(s) impacté(s) :

DB_SSH_USER

Modèle d'hôte

( Onglet Données )

---shinken shinken

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

Autres check(s) impacté(s) :

DB_SSH_KEY

Modèle d'hôte

( Onglet Données )

---~/.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

Modèle d'hôte

( Onglet Données )

seconde5 5

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

Autres check(s) impacté(s) :

DB_USER_NAME

Modèle d'hôte

( Onglet Données )


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.

Autres check(s) impacté(s) :


DB_USER_PASSWORD

Modèle d'hôte

( Onglet Données )


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.

Autres check(s) impacté(s) :


DB_SSL_CA_FILE

Modèle d'hôte

( Onglet Données )


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

Modèle d'hôte

( Onglet Données )


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

Modèle d'hôte

( Onglet Données )


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

Modèle d'hôte

( Onglet Données )


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

Modèle d'hôte

( Onglet Données )


NoneNone

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

Modèle d'hôte

( Onglet Données )


NoneNone

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

Autres check(s) impacté(s) :


DB_CONNECTIONS_WARN

Modèle d'hôte

( Onglet Données )

pourcentage7070

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

DB_CONNECTIONS_CRIT

Modèle d'hôte

( Onglet Données )

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 spécifiques pour ce check.

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.