בעיה.קבל

תיאור

integer/array problem.get(אובייקט פרמטרים)

השיטה מאפשרת לשחזר בעיות לפי הנתון פרמטרים.

שיטה זו מיועדת לאחזור בעיות שלא נפתרו. אפשר גם, אם צוין, כדי לאחזר בעיות שנפתרו לאחרונה. ה תקופה שקובעת בת כמה הוא "לאחרונה" מוגדרת ב ניהול → כללי. בעיות שנפתרו לפני אותה תקופה אינן נשמרות ב- טבלת בעיות. כדי לאחזר בעיות שנפתרו בהמשך בעבר, השתמש בשיטת event.get.

::: שימו לב חשוב שיטה זו עשויה להחזיר בעיות של נמחק ישות אם בעיות אלה לא הוסרו על ידי עוזרת הבית עדיין. :::

שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.

פרמטרים

(object) פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

פרמטר	סוג	תיאור
eventids	string/array	החזר רק בעיות עם המזהים הנתונים.
groupids	string/array	החזר רק בעיות שנוצרו על ידי אובייקטים השייכים לקבוצות המארחות הנתונות.
hostids	string/array	החזר רק בעיות שנוצרו על ידי אובייקטים השייכים למארחים הנתונים.
objectids	string/array	החזר רק בעיות שנוצרו על ידי האובייקטים הנתונים.
source	integer	החזר רק בעיות עם הסוג הנתון. עיין בדף דף אובייקט אירוע בעיה לקבלת רשימה של סוגי אירועים נתמכים. ברירת מחדל: 0 - בעיה שנוצרה על ידי טריגר.
object	integer	החזר רק בעיות שנוצרו על ידי אובייקטים מהסוג הנתון. עיין בדף דף אובייקט אירוע בעיה לקבלת רשימה של סוגי אובייקטים נתמכים. ברירת מחדל: 0 - טריגר.
acknowledged	boolean	`true` - החזרת בעיות מאושרות בלבד; `false` - unknowledged בלבד.
suppressed	boolean	`true` - החזר רק בעיות מודחקות; `false` - החזרת בעיות במצב רגיל.
severities	integer/array	החזר רק בעיות עם חומרת אירוע נתונה. חל רק אם האובייקט הוא טריגר.
evaltype	integer	כללים לחיפוש תגים. ערכים אפשריים: 0 - (ברירת מחדל) ו/או; 2 - או.
תגים	מערך אובייקטים	החזר רק בעיות עם תגיות נתונות. התאמה מדויקת לפי תג וחיפוש לא תלוי רישיות לפי ערך ואופרטור. פורמט: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`. מערך ריק מחזיר את כל הבעיות. סוגי אופרטורים אפשריים: 0 - (ברירת מחדל) Like; 1 - שווה; 2 - לא כמו; 3 - לא שווה 4 - קיים; 5 - לא קיים.
recent	boolean	`true` - החזרת PROBLEM ובעיות שנפתרו לאחרונה (תלוי בטריגרים של Display OK למשך N שניות) ברירת מחדל: `false` - בעיות בלתי פתורות בלבד
eventid_from	string	החזר רק בעיות עם מזהים שווים או גדולים למזהה הנתון.
eventid_till	string	החזר רק בעיות עם מזהים שווים או נמוכים למזהה הנתון.
time_from	timestamp	החזר רק בעיות שנוצרו לאחר או בזמן הנתון.
time_till	timestamp	החזר רק בעיות שנוצרו לפני או בזמן הנתון.
selectAcknowledges	query	החזר מאפיין `מאשר` עם עדכוני הבעיה. עדכוני בעיה ממוינים בסדר כרונולוגי הפוך. אובייקט עדכון הבעיה כולל את המאפיינים הבאים: `acknowledgeid` - `(string)` update's ID; `userid` - `(string)` מזהה המשתמש שעדכן את האירוע; `eventid` - `(string)` מזהה האירוע המעודכן; `clock` - `(timestamp)` זמן שבו האירוע עודכן; `הודעה` - `(string)` טקסט של ההודעה; `action` - `(integer)`סוג פעולת עדכון (ראה event.acknowledge) ; `old_severity` - חומרת האירוע `(integer)` לפני פעולת עדכון זו; `new_severity` - `(integer)` חומרת האירוע לאחר פעולת עדכון זו; תומך ב-`count`.
selectTags	query	החזר מאפיין tags עם תגי הבעיה. פורמט פלט: `[{"tag": "<תג>", "value": "<value>"}, ...]`.
selectSuppressionData	query	החזר מאפיין `suppression_data` עם רשימת התחזוקה: `maintenanceid` - `(string)` מזהה התחזוקה; `suppress_until` - `(integer)` זמן עד לבעיה מדוכא.
sortfield	string/array	מיין את התוצאה לפי המאפיינים הנתונים. ערכים אפשריים הם: `eventid`.
countOutput	boolean	הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף פרשנות הפניה.
עריכה	בוליאנית
excludeSearch	בולאני
filter	object
limit	מספר שלם
פלט	שאילתה
preservekeys	בולאני
חיפוש	אובייקט
searchByAny	boolean
searchWildcardsEnabled	בוליאני
sortorder	מחרוזת/מערך
startSearch	boolean

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

מערך של חפצים;
ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

דוגמאות

אחזור אירועי בעיה של טריגר

אחזר אירועים אחרונים מהטריגר "15112".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "problem.get",
            "params": {
                "output": "להרחיב",
                "selectAcknowledges": "להאריך",
                "selectTags": "להרחיב",
                "selectSuppressionData": "להרחיב",
                "objectids": "15112",
                "recent": "נכון",
                "sortfield": ["eventid"],
                "sortorder": "DESC"
            },
            "auth": "67f45d3eb1173338e1b1647c4bdc1916",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "eventid": "1245463",
                    "source": "0",
                    "object": "0",
                    "objectid": "15112",
                    "שעון": "1472457242",
                    "ns": "209442442",
                    "r_eventid": "1245468",
                    "r_clock": "1472457285",
                    "r_ns": "125644870",
                    "correlationid": "0",
                    "userid": "1",
                    "name": "אי אפשר להגיע לסוכן Zabbix ב-localhost במשך 5 דקות",
                    "acknowledged": "1",
                    "חומרה": "3",
                    "opdata": "",
                    "מאשר": [
                        {
                            "acknowledgeid": "14443",
                            "userid": "1",
                            "eventid": "1245463",
                            "שעון": "1472457281",
                            "message": "הבעיה נפתרה",
                            "action": "6",
                            "old_severity": "0",
                            "new_severity": "0"
                        }
                    ],
                    "suppression_data": [
                        {
                            "maintenanceid": "15",
                            "suppress_until": "1472511600"
                        }
                    ],
                    "suppressed": "1",
                    "תגים": [
                        {
                            "tag": "תג בדיקה",
                            "value": "ערך בדיקה"
                        }
                    ]
                }
            ],
            "מזהה": 1
       }

ראה גם

מקור

CEvent::get()‎ בתוך ui/include/classes/api/services/CProblem.php.

Documentation