service.getsla

Description

object service.getsla(object parameters)

Cette méthode permet de calculer les informations de disponibilité des services.

Paramètres

(object) Paramètres contenant les identifiants des services et les intervalles de temps pour calculer le SLA.

Paramètre Type Description
serviceids string/array ID des services desquels renvoyer les informations de disponibilité.
intervals array Intervalles de temps pour le retour des informations de disponibilité de la couche de service.

Chaque intervalle de temps doit avoir les paramètres suivants :
- from - (timestamp) heure de début d'intervalle;
- to - (timestamp) heure de fin d'intervalle.

Valeurs retournées

(object) Renvoie les informations de disponibilité suivantes pour chaque service sous l'ID de service correspondant.

Propriété Type Description
status integer Statut courant du service.

Se référer à la propriété de statut du service pour une liste des valeurs possibles.
problems array Les déclencheurs qui sont actuellement à l'état problématique et qui sont liés au service ou à l'un de ses descendants.
sla array Données de SLA sur chaque période.

Chaque objet SLA a les propriétés suivantes :
- from - (timestamp) heure de début d'intervalle;
- to - (timestamp) heure de fin d'intervalle;;
- sla - (float) SLA pour l'intervalle de temps donné;
- okTime - (integer) temps pendant lequel le service était dans l'état OK, en secondes;
- problemTime - (integer) temps pendant lequel le service était en état problématique, en secondes;
- downtimeTime - (integer) temps pendant lequel le service était en arrêt programmé, en secondes.

Exemples

Récupération des informations de disponibilité pour un service

Récupérer des informations de disponibilité d'un service pendant une semaine.

Requête :

{
    "jsonrpc": "2.0",
    "method": "service.getsla",
    "params": {
        "serviceids": "2",
        "intervals": [
            {
                "from": 1352452201,
                "to": 1353057001
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Réponse :

{
    "jsonrpc": "2.0",
    "result": {
        "2": {
            "status": "3",
            "problems": {
                "13904": {
                    "triggerid": "13904",
                    "expression": "{13359}=0",
                    "description": "Service unavailable",
                    "url": "",
                    "status": "0",
                    "value": "1",
                    "priority": "3",
                    "lastchange": "1352967420",
                    "comments": "",
                    "error": "",
                    "templateid": "0",
                    "type": "0",
                    "value_flags": "0",
                    "flags": "0"
                }
            },
            "sla": [
                {
                    "from": 1352452201,
                    "to": 1353057001,
                    "sla": 97.046296296296,
                    "okTime": 586936,
                    "problemTime": 17864,
                    "downtimeTime": 0
                }
            ]
        }
    },
    "id": 1
}

Voir également

Source

CService::getSla() dans frontends/php/include/classes/api/services/CService.php.