Documentation
Table of Contents
sla.getsli
תיאור
object sla.getsli(object parameters)
שיטה זו מאפשרת לחשב את נתוני ה-Service Level Indicator (SLI).
שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.
פרמטרים
(object) פרמטרים המכילים את מזהה SLA, תקופות דיווח ובאופן אופציונלי, המזהים של השירותים - לחישוב ה-SLI עבורם.
פרמטר | סוג | תיאור |
|------------------------|---------------------- ------------------------------|------------------------ -------------------------------------------------- ----------------| | הרוג
(חובה) | מחרוזת | מזהי שירותים להחזרת מידע זמינות עבורם. | | תקופה_מ | מספר שלם | תאריך התחלה (כולל) לדיווח על ה-SLI.
ערכים אפשריים: חותמת זמן. | | תקופה_to | מספר שלם | תאריך סיום (בלעדי) לדיווח על ה-SLI.
ערכים אפשריים: חותמת זמן. | | תקופות | מערך | מספר תקופות מועדף לדיווח.
ערכים אפשריים: 1-100 | | serviceids | מחרוזת/מערך | מזהים של שירותים להחזרת ה-SLI עבורם. |
חלוקת תקופות
להלן מדגים את הסידור של פרוסות תקופה המוחזרות על סמך שילובים של פרמטרים.
פרמטרים | | | תיאור |
|----------------|----------------|------------- |-------------------------------------------------------- -------------------------------------------------- -------------------------------------------------- ----------------------| | תקופה_מ | נקודה_to | תקופות | | | - | - | - | 20 התקופות האחרונות (כולל הנוכחית) אך לא מעבר לתקופה הזמינה הראשונה בהתבסס על תאריך התוקף של ה-SLA. | | - | - | צוין | התקופות האחרונות המצוינות על ידי הפרמטר תקופות. | | - | צוין | - | 20 התקופות האחרונות לפני התאריך שצוין, אך לא מעבר לתקופה הזמינה הראשונה בהתבסס על תאריך התוקף של ה-SLA. | | - | צוין | צוין | התקופות האחרונות שצוינו על ידי הפרמטר תקופות לפני התאריך שצוין. | | צוין | - | - | 20 התקופות הראשונות (כולל הנוכחית) אך לא מעבר לזו הנוכחית. | | צוין | - | צוין | התקופות הראשונות המצוינות בפרמטר תקופות המתחילות בהתאריך שצוין. | | צוין | צוין | - | תקופות בטווח התאריכים שצוין, אך לא יותר מ-100 ולא מעבר לתקופה הזמינה הראשונה בהתבסס על תאריך התוקף של ה-SLA. | | צוין | צוין | צוין | תקופות בטווח התאריכים שצוין, אך לא יותר ממספר התקופות שצוין ולא מעבר לתקופה הזמינה הראשונה בהתבסס על תאריך התוקף של ה-SLA. |
החזר ערכים
(אובייקט) מחזירה את תוצאות החישוב.
נכס | סוג | תיאור |
|------------|---------------------------------------- ------------------|-------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- --------------------| | תקופות | מערך | רשימת התקופות המדווחות.
כל תקופה מדווחת מיוצגת כאובייקט המורכב מ:
- period_from - תאריך ההתחלה של התקופה המדווחת (חותמת זמן).
- period_to - סיום תאריך התקופה המדווחת (חותמת זמן).
תקופות ממוינות לפי שדה 'period_from' בעלייה. | | serviceids | מערך | רשימת מזהי שירותים בתקופות המדווחות.
סדר המיון של הרשימה אינו מוגדר. גם אם פרמטר serviceids הועבר לשיטת sla.getsli. | | sli | מערך | נתוני SLI (כמערך דו-ממדי) עבור כל תקופה ושירות מדווחים.
האינדקס של מאפיין 'תקופות' משמש כמאפיין הראשון של ה-'sli' מאפיין.
האינדקס של המאפיין serviceids משמש כממד שני של המאפיין sli. |
נתוני SLI
נתוני ה-SLI המוחזרים עבור כל תקופה ושירות מדווחים מורכבים מ:
נכס | סוג | תיאור |
|---------------------|-------------------------------- --------------------------|----------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- ----------------| | זמן פעילות | מספר שלם | כמות הזמן שהשירות בילה במצב OK במהלך זמן פעילות קבוע, פחות זמני ההשבתה שלא נכללו. | | זמן השבתה | מספר שלם | כמות הזמן שהשירות בילה במצב לא תקין במהלך זמן פעילות קבוע, פחות זמני ההשבתה שלא נכללו. | | sli | לצוף | SLI (אחוז מזמן הפעילות הכולל), מבוסס על זמן פעולה והשבתה. | | שגיאה_תקציב | מספר שלם | תקציב שגיאה (בשניות), מבוסס על ה-SLI וה-SLO. | | לא נכלל_זמני השבתה | מערך | מערך של השבתות שלא נכללו בתקופת דיווח זו.
כל אובייקט יכיל את הפרמטרים הבאים:
- name - שם זמן ההשבתה שלא נכלל.
- period_from - תאריך ושעה התחלה (כולל) של זמן ההשבתה שלא נכלל.
- period_to - תאריך ושעה סיום (בלעדי) של זמן ההשבתה שלא נכלל.
זמני השבתה שלא נכללו ממוינים לפי period_from שדה עולה. |
דוגמאות
חישוב SLI
אחזר SLI בשירותים עם מזהים "50, 60 ו-70" המקושרים ל-SLA עם מזהה "5" למשך 3 תקופות החל מה-1 בנובמבר, 2021.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "sla.getsli",
"params": {
"slaid": "5",
"serviceids": [
50,
60,
70
],
"תקופות": 3,
"period_from": "1635724800"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": {
"תקופות": [
{
"period_from": 1635724800,
"period_to": 1638316800
},
{
"period_from": 1638316800,
"period_to": 1640995200
},
{
"period_from": 1640995200,
"period_to": 1643673600
}
],
"serviceids": [
50,
60,
70
],
"סלי": [
[
{
"זמן פעילות": 1186212,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
},
{
"זמן פעילות": 1186212,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
},
{
"זמן פעילות": 1186212,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1637836212,
"period_to": 1638316800
}
]
}
],
[
{
"זמן uptime": 1147548,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
},
{
"זמן uptime": 1147548,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
},
{
"זמן uptime": 1147548,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"excluded_downtimes": [
{
"name": "זמן השבתה לא נכלל - 1",
"period_from": 1638439200,
"period_to": 1639109652
}
]
}
],
[
{
"זמן פעילות": 1674000,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"זמני_השבתות": []
},
{
"זמן פעילות": 1674000,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"זמני_השבתות": []
},
{
"זמן פעילות": 1674000,
"זמן השבתה": 0,
"sli": 100,
"error_budget": 0,
"זמני_השבתות": []
}
]
]
},
"מזהה": 1
}מקור
CSla::getSli() בתוך ui/include/classes/api/services/CSla.php