Sommaire

Contexte

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


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

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

l'Hôte

( Onglet Données )

---

27017 27017

Configuration du port de communication avec la base de données.

DB_CONNECTION_METHOD

l'Hôte

( Onglet Données )

---ssh ssh

Méthode de connexion au serveur MongoDB

Valeur possible :

  • direct
  • ssh
DB_SSH_USER

l'Hôte

( Onglet Données )

---

shinken shinken

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

DB_SSH_KEY

l'Hôte

( Onglet Données )

---

~/.ssh/id_rsa ~/.ssh/id_rsa Clé SSH privée permettant la connexion au serveur hébergeant MongoDB.
DB_SSH_TUNNEL_TIMEOUT

l'Hôte

( Onglet Données )

seconde

5 5 Temps avant le déclenchement d'un timeout lors de la connexion ssh avec la base de données.
DB_USER_NAME

l'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.

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

DB_USER_PASSWORD

l'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.

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

DB_USE_SSL

l'Hôte

( Onglet Données )

---

falsefalse

Active le chiffrement SSL/TLS des échanges avec la base.

DB_SSL_CA_FILE

l'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.

DB_SSL_PEM_KEY_FILE

l'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.

DB_SSL_PEM_KEY_PASSWORD

l'Hôte

( Onglet Données )

---

NONENONE

Mot de passe du certificat SSL du client.

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

DB_SSL_CRL_FILE

l'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.

DB_SSL_ALLOW_INVALID_HOSTNAMES 

l'Hôte

( Onglet Données )

---

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

l'Hôte

( Onglet Données )

---

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



Si la machine possède les bases de données du Broker et du Synchronizer, alors cela dépendra de l'ordre des modèles dans le champ "Modèles d'hôte hérités".


Données spécifiques pour ce check



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

l'Hôte

( Onglet Données )

---8080

Seuil critique de connexions utilisées par rapport au nombre maximal de connexions autorisées par la base de données ( en pourcentage ).

DB_CONNECTIONS_WARN

l'Hôte

( Onglet Données )

---7070

Seuil d'avertissement de connexions utilisées par rapport au nombre maximal de connexions autorisées par la base de données ( en pourcentage ).

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

Données globales



Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

---/var/lib/shinken/libexec/var/lib/shinken/libexec

Chemin absolu du dossier contenant la sonde non modifiable ).

SHINKENVERSION

Non modifiable

---------

Numéro de version du shinken utilisé pour la comparaison avec le shinken surveillé.

Propriétés de l'hôte

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
HOSTADDRESS

l'Hôte

( Onglet Général )

---

Nom de l'hôteNom de l'hôte

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