Zabbix Documentation 4.0

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

User Tools

Site Tools


fr:manual:api:reference:service:getsla

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
fr:manual:api:reference:service:getsla [2017/02/17 13:30]
iivs renamed IT service to Service
fr:manual:api:reference:service:getsla [2019/02/05 10:34]
sensie
Line 1: Line 1:
 +===== 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 [[fr:​manual:​api:​reference:​service:​object#​service|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 :
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​service.getsla",​
 +    "​params":​ {
 +        "​serviceids":​ "​2",​
 +        "​intervals":​ [
 +            {
 +                "​from":​ 1352452201,
 +                "​to":​ 1353057001
 +            }
 +        ]
 +    },
 +    "​auth":​ "​038e1d7b1735c6a5436ee9eae095879e",​
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +Réponse :
 +<code java>
 +{
 +    "​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
 +}
 +</​code>​
 +
 +==== Voir également ====
 +
 +  * [[fr:​manual:​api:​reference:​trigger:​object#​declencheur|Déclencheur]]
 +
 +==== Source ====
 +
 +CService::​getSla() dans //​frontends/​php/​include/​classes/​api/​services/​CService.php//​.