Météo des services¶

L'API météo des services permet de consulter l'état des observateurs. Elle est utilisée par le widget météo des services.

Récupération d'une liste d'observateurs¶

URL : /api/v2/weather/watchers/<filtre>

<filtre> est un filtre MongoDB, utilisé sur la collection default_entities. Il permet en particulier de filtrer sur le nom de l'observateur (name) et ses informations enrichies (infos.*.value).

Méthode : GET

Paramètres :

limit : le nombre d'observateurs à renvoyer.
start : le nombre d'observateurs à passer.
orderby : le nom du champ à utiliser pour le tri. Les champs utilisables sont les mêmes que pour le filtre.
direction : l'ordre dans lequel les observateurs doivent être triés (ASC ou DESC)

Authentification requise : Oui

Permissions requises : Aucune

Exemple de requête curl pour utilisateur root avec mot de passe root pour récupérer tous les observateurs :

curl -X GET -u root:root 'http://<Canopsis_URL>/api/v2/weather/watchers/\{\}'

Exemple de requête curl pour utilisateur root avec mot de passe root pour récupérer les observateurs dont l'information customer vaut Capensis.

curl -X GET -u root:root 'http://<Canopsis_URL>/api/v2/weather/watchers/\{"infos.customer.value":"Capensis"\}'

Réponse en cas de réussite¶

Code : 200 OK

Exemple du corps de la réponse :

[
    {
        "entity_id": "watcher_id",
        "infos": {
            "customer": {
                "description": "Nom du client",
                "value": "Capensis"
            },
            // ...
        },
        "display_name": "Nom observateur",
        "mfilter": "...",
        "watcher_pbehavior": [],  // Liste des comportements périodiques actifs sur l'observateur
        "automatic_action_timer": null,

        // Derniers steps state, status, snooze et ack de l'alarme de l'observateur
        "state": {...},   // contient {"val": 0} s'il n'y a pas d'alarme
        "status": {...},  // non défini s'il n'y a pas d'alarme
        "snooze": {...},  // non défini s'il n'y a pas d'alarme
        "ack": {...},     // non défini s'il n'y a pas d'alarme

        // Champs de l'alarme (ces champs ne sont pas définis s'il n'y a pas d'alarme)
        "connector": "...",
        "connector_name": "...",
        "component": "...",
        "resource": "...",
        "last_update_date": ...,

        "isActionRequired": false,     // true si l'observateur est impacté par une alarme non-acquittée
        "isAllEntitiesPaused": false,  // true si toutes les dépendances ont un comportement périodique actif
        "isWatcherPaused": false,      // true si l'observateur a un comportement périodique actif
        "tileColor": "ok",             // le nom de la couleur de la tuile : pause, ok, minor, major ou critical
        "tileIcon": "ok"               // le nom de l'icône de la tuile : pause, maintenance, unmonitored, ok, minor, major ou critical
        "tileSecondaryIcon": null,     // le nom de l'icône secondaire de la tuile : pause, maintenance ou unmonitored
    },
    // ...
]

Récupération des dépendances d'un observateur¶

URL : /api/v2/weather/watchers/<watcher_id>