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