Documentation
Table of Contents
sla.getsli
Leírás
objektum sla.getsli(objektumparaméterek)
Ez a módszer lehetővé teszi a Service Level Indicator (SLI) adatok kiszámítását.
Ez a módszer bármilyen típusú felhasználó számára elérhető. Engedélyek A metódus meghívása a felhasználói szerepkör beállításaiban visszavonható. Lásd: User roles további információért.
Paraméterek
"(object)" Az SLA azonosítót, a jelentési időszakokat és opcionálisan a szolgáltatások azonosítói - az SLI kiszámításához.
Paraméter | Típus | Leírás |
|-------------------------|------------------------ ------------------------------|-------------------- -------------------------------------------------- -----------------| | slaid
(kötelező) | húr | Azoknak a szolgáltatásoknak az azonosítói, amelyek elérhetőségi információit visszaküldik. | | időszak_tól | egész | Az SLI jelentésének kezdő dátuma (beleértve).
Lehetséges értékek: időbélyeg. | | időszak_ig | egész | Az SLI jelentésének befejezési dátuma (kizárólag).
Lehetséges értékek: időbélyeg. | | időszakok | tömb | A jelentéshez javasolt időszakok száma.
Lehetséges értékek: 1-100 | | szervizazonosítók | karakterlánc/tömb | Az SLI visszaküldéséhez szükséges szolgáltatások azonosítói. |
A periódusok felosztása
Az alábbiakban bemutatjuk a visszaadott period slices elrendezését a paraméterek kombinációi alapján.
Paraméterek | | | Leírás |
|------------------|-----------------|-------------- |-------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -----------------------| | időszak_tól | időszak_ig | időszak | | | - | - | - | Az utolsó 20 időszak (beleértve a jelenlegit is), de nem múlt el az SLA hatálybalépésének dátuma alapján elérhető első időszak. | | - | - | meghatározott | A periods paraméter által megadott utolsó időszakok. | | - | meghatározott | - | A meghatározott dátum előtti utolsó 20 időszak, de nem múlt el az SLA hatálybalépésének dátuma alapján az első elérhető időszak. | | - | meghatározott | meghatározott | A periods paraméter által megadott utolsó időszakok a megadott dátum előtt. | | meghatározott | - | - | Az első 20 periódus (beleértve az aktuálisat is), de nem múlt el a jelenleginél. | | meghatározott | - | meghatározott | A periods paraméter által megadott első időszakok a megadott dátummal kezdődnek. | | meghatározott | meghatározott | - | A megadott dátumtartományon belüli időszakok, de legfeljebb 100, és nem múltak el az SLA hatálybalépésének dátuma alapján az első elérhető időszakon. | | meghatározott | meghatározott | meghatározott | A megadott dátumtartományon belüli időszakok, de legfeljebb a megadott számú időszak, és nem múltak el az SLA hatálybalépésének dátuma alapján az első elérhető időszakon. |
Visszatérési értékek
(objektum) A számítás eredményét adja vissza.
Ingatlan | Típus | Leírás |
|------------|------------------------------------- ---------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- ---------------------| | időszakok | tömb | A jelentési időszakok listája.
Minden jelentési időszak objektumként jelenik meg, amely a következőkből áll:
- period_from - A jelentési időszak kezdő dátuma (időbélyeg).
- period_to - Befejezés a jelentési időszak dátuma (időbélyeg).
Az időszakok a "period_from" mező szerint vannak rendezve növekvő sorrendben. | | szervizazonosítók | tömb | Szolgáltatásazonosítók listája a jelentési időszakokban.
A lista rendezési sorrendje nincs meghatározva. Még akkor is, ha a serviceids paramétert a sla.getsli metódusnak adták át. | | sli | tömb | SLI-adatok (kétdimenziós tömbként) minden jelentett időszakhoz és szolgáltatáshoz.
A "periods" tulajdonság indexe a "sli" első dimenziójaként property.
A serviceids tulajdonság indexe a sli tulajdonság második dimenziójaként használatos. |
SLI adatok
Az egyes jelentési időszakokra és szolgáltatásokra visszaküldött SLI adatok a következőkből állnak:
Ingatlan | Típus | Leírás |
|---------------------|---------------------------- --------------------------|------------------------ -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -----------------| | üzemidő | egész | A szolgáltatásnak az ütemezett üzemidő alatt OK állapotban eltöltött ideje, csökkentve a kizárt leállásokkal. | | állásidő | egész | Az ütemezett üzemidő alatt nem OK állapotban eltöltött idő, levonva a kizárt állásidőket. | | sli | úszó | SLI (a teljes üzemidő százaléka), az üzemidő és az állásidő alapján. | | hiba_költségvetés | egész | Hibaköltségvetés (másodpercben), az SLI és az SLO alapján. | | kizárva_leállások | tömb | Kizárt leállások tömbje ebben a jelentési időszakban.
Minden objektum a következő paramétereket tartalmazza:
- name - A kizárt állásidő neve.
- period_from - Kezdő dátum és időpont (beleértve) a kizárt állásidőből.
- period_to - A kizárt állásidő befejezési dátuma és időpontja (kivéve).
A kizárt állásidők a mezőtől kezdődő periódus szerint vannak rendezve növekvő sorrendben. |
Példák
Calculating SLI
Retrieve SLI on services with IDs "50, 60 and 70" linked to an SLA with ID of "5" for 3 periods starting from Nov 01, 2021.
Request:
{
"jsonrpc": "2.0",
"method": "sla.getsli",
"params": {
"slaid": "5",
"serviceids": [
50,
60,
70
],
"periods": 3,
"period_from": "1635724800"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"periods": [
{
"period_from": 1635724800,
"period_to": 1638316800
},
{
"period_from": 1638316800,
"period_to": 1640995200
},
{
"period_from": 1640995200,
"period_to": 1643673600
}
],
"serviceids": [
50,
60,
70
],
"sli": [
[
{
"uptime": 1186212,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
},
{
"uptime": 1186212,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
},
{
"uptime": 1186212,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
}
],
[
{
"uptime": 1147548,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
},
{
"uptime": 1147548,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
},
{
"uptime": 1147548,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "Excluded Downtime - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
}
],
[
{
"uptime": 1674000,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": []
},
{
"uptime": 1674000,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": []
},
{
"uptime": 1674000,
"downtime": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": []
}
]
]
},
"id": 1
}Forrás
CSla::getSli() az ui/include/classes/api/services/CSla.php-ban