Aller au contenu

Requêtes en base

Healthcheck

1) Connexion à la BDD

Connexion en ligne de commande :

# mongo canopsis -u cpsmongo -p MOT_DE_PASSE --host XXXX
MongoDB shell version v3.4.13
MongoDB server version: 3.4.13
rs0:PRIMARY> 

Ou sinon, avec Robo3T (anciennement RoboMongo). Dans Robo3T, les requêtes doivent être validées avec Ctrl + Entrée afin d'être exécutées.

Attention : MongoDB, et plus particulièrement Robo3T, sont sensibles à la véritable casse du hostname des nœuds MongoDB.

2) Identifier un évènement suivant le nom de son composant, sa ressource et son statut.

Rappels

Pour comprendre le fonctionnement interne de Canopsis, il est important de comprendre le modèle de données associé.
Pour rappel, les entités sont stockées dans la collection default_entities tandis que les alarmes sont stockées dans periodical_alarm.

Prenons l'exemple de l'entité suivante :

  • component : NOM_MACHINE
  • resource : Traffic - eth0
  • connector : centreon
  • connector_name : NOM_CONN

Pour rechercher cette entité en base de données, vous pouvez exécuter la requête suivante :

db.default_entities.find({"_id": "Traffic - eth0/NOM_MACHINE"}).pretty()
{
        "_id" : "Traffic - eth0/NOM_MACHINE",
        "name" : "Traffic - eth0",
        "impact" : [
                "NOM_MACHINE"
        ],
        "depends" : [
                "centreon/NOM_CONN"
        ],
        "enable_history" : [
                NumberLong(1527085105)
        ],
        "measurements" : null,
        "enabled" : true,
        "infos" : {
                "hostgroups" : {
                        "name" : "hostgroups",
                        "description" : "",
                        "value" : "XXXX"
                },
                "component_alias" : {
                        "name" : "component_alias",
                        "description" : "",
                        "value" : "XXXX"
                }
        },
        "type" : "resource"
}

Recherche

Si vous souhaitez rechercher les alarmes associées à cette entité, il faut requêter la collection periodical_alarm.

db.periodical_alarm.find({"v.component" : "NOM_MACHINE", "v.resource" : "Traffic - eth0"}).pretty()
{
        "_id" : "XXXX",
        "t" : NumberLong(1524667917),
        "d" : "Traffic - eth0/NOM_MACHINE",
        "v" : {
                "state" : {
                        "_t" : "stateinc",
                        "t" : NumberLong(1524667892),
                        "a" : "NOM_CONN",
                        "m" : "ERROR: Interface Status Request : No response from remote host \"IP_MACHINE\"",
                        "val" : NumberLong(1)
                },
                "status" : {
                        "_t" : "statusinc",
                        "t" : NumberLong(1524667892),
                        "a" : "NOM_CONN",
                        "m" : "ERROR: Interface Status Request : No response from remote host \"IP_MACHINE\"",
                        "val" : NumberLong(1)
                },
                "steps" : [
                        {
                                "_t" : "stateinc",
                                "t" : NumberLong(1524667892),
                                "a" : "NOM_CONN",
                                "m" : "ERROR: Interface Status Request : No response from remote host \"IP_MACHINE\"",
                                "val" : NumberLong(1)
                        },
                        {
                                "_t" : "statusinc",
                                "t" : NumberLong(1524667892),
                                "a" : "NOM_CONN",
                                "m" : "ERROR: Interface Status Request : No response from remote host \"IP_MACHINE\"",
                                "val" : NumberLong(1)
                        }
                ],
                "component" : "NOM_MACHINE",
                "connector" : "centreon",
                "connector_name" : "NOM_CONN",
                "creation_date" : NumberLong(1524667917),
                "display_name" : "XXXX",
                "extra" : {

                },
                "initial_output" : "",
                "last_update_date" : NumberLong(1524667917),
                "last_event_date" : NumberLong(1524667917),
                "resource" : "Traffic - eth0",
                "tags" : [ ]
        }
}

Pour « mesurer » la criticité courante de l'alarme, il faut vous référer à l'attribut v.state

"state" : {
    "_t" : "stateinc",
        "t" : NumberLong(1524667892),
        "a" : "centreon.NOM_CONN",
        "m" : "ERROR: Interface Status Request : No response from remote host \"IP_MACHINE\"",
        "val" : NumberLong(1)
}
  • _t : type d'évolution de la criticité (stateinc, statedec) : en croissance ou en décroissance
  • t : timestamp associé
  • a : auteur
  • m : message de l'alarme
  • val (0, 1, 2, 3) : criticité de l'alarme : Info, Mineure, Majeure, Critique.

Notez que l'attribut step conserve l'historique des changements sur l'alarme.

En parallèle, il existe également un attribut status sous forme de step qui permet de savoir si une alarme est en cours, en bagot, annulée, etc.
Voici sa description :

"status" : {
    "_t" : "statusinc",
    "t" : NumberLong(1529046262),
    "a" : "AUTEUR",
    "m" : "MESSAGE",
    "val" : NumberLong(1)
},
  • _t : type de statut (statusinc, statusdec) : en croissance ou en décroissance
  • t : timestamp associé
  • a : auteur
  • m : message de l'alarme
  • val (0, 1, 2, 3, 4) : statut de l'alarme : Off, En cours, Furtif, Bagot, Annulé.

Suppression

Supprimer l'élément de la base MongoDB :

db.periodical_alarm.remove({"v.component" : "NOM_MACHINE", "v.resource" : "Traffic - eth0"})

Supprimer une alarme qui a été annulée :

db.periodical_alarm.remove({"v.component" : "XXXX", "v.resource" : "Ping", "v.resolved" : null, "v.status.val" : 4})

État des composants de Canopsis

Rendez-vous ici.


Dernière mise à jour: 2021-09-02