Sidebar
fr:manual:api:reference:service:getsla
Table of Contents
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.