אירוע.קבל

תיאור

integer/array event.get(object parameters)

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

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

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

פרמטרים

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

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

פרמטר	סוג	תיאור
eventids	string/array	החזר רק אירועים עם המזהים הנתונים.
groupids	string/array	החזר רק אירועים שנוצרו על ידי אובייקטים השייכים לקבוצות המארחות הנתונות.
hostids	string/array	החזר רק אירועים שנוצרו על ידי אובייקטים השייכים למארחים הנתונים.
objectids	string/array	החזר רק אירועים שנוצרו על ידי האובייקטים הנתונים.
source	integer	החזר רק אירועים עם הסוג הנתון. עיין בדף אובייקט אירוע לקבלת רשימה של סוגי אירועים נתמכים. ברירת מחדל: 0 - מפעיל אירועים.
object	integer	החזר רק אירועים שנוצרו על ידי אובייקטים מהסוג הנתון. עיין בדף אובייקט אירוע לקבלת רשימה של סוגי אובייקטים נתמכים. ברירת מחדל : 0 - טריגר.
acknowledged	boolean	אם הוגדר כ-'true' החזר רק אירועים מאושרים.
suppressed	boolean	`true` - החזר רק אירועים מודחקים; `false` - החזרת אירועים במצב רגיל.
severities	integer/array	החזר רק אירועים עם חומרת אירוע נתונה. חל רק אם האובייקט הוא טריגר.
evaltype	integer	כללים לחיפוש תגים. ערכים אפשריים: 0 - (ברירת מחדל) ו/או; 2 - או.
תגים	מערך אובייקטים	החזר רק אירועים עם תגיות נתונות. התאמה מדויקת לפי תג וחיפוש לא תלוי רישיות לפי ערך ואופרטור. פורמט: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`. מערך ריק מחזיר את כל האירועים. סוגי אופרטורים אפשריים: 0 - (ברירת מחדל) Like; 1 - שווה; 2 - לא כמו; 3 - לא שווה 4 - קיים; 5 - לא קיים.
eventid_from	string	החזר רק אירועים עם מזהים שווים או גדולים למזהה הנתון.
eventid_till	string	החזר רק אירועים עם מזהים שווים או נמוכים למזהה הנתון.
time_from	timestamp	החזר רק אירועים שנוצרו לאחר או בזמן הנתון.
time_till	timestamp	החזר רק אירועים שנוצרו לפני או בזמן הנתון.
problem_time_from	timestamp	מחזיר רק אירועים שהיו במצב הבעיה החל ב-'problem_time_from'. חל רק אם המקור הוא אירוע טריגר והאובייקט הוא טריגר. חובה אם צוין 'זמן_בעיה_עד'.
problem_time_till	timestamp	מחזיר רק אירועים שהיו במצב הבעיה עד `problem_time_till`. חל רק אם המקור הוא אירוע טריגר והאובייקט הוא טריגר. חובה אם צוין 'זמן_בעיה_מאת'.
value	integer/array	החזר רק אירועים עם הערכים הנתונים.
selectHosts	query	החזר מאפיין hosts עם מארחים המכילים את האובייקט שיצר את האירוע. נתמך רק עבור אירועים שנוצרו על ידי טריגרים, פריטים או כללי LLD.
selectRelatedObject	query	החזר מאפיין `relatedObject` עם האובייקט שיצר את האירוע. סוג האובייקט המוחזר תלוי בסוג האירוע.
select_alerts	query	החזר מאפיין alerts עם התראות שנוצרו על ידי האירוע. ההתראות ממוינות בסדר כרונולוגי הפוך.
select_acknowledges	query	החזר מאפיין `מאשר` עם עדכוני אירועים. עדכוני אירועים ממוינים בסדר כרונולוגי הפוך. אובייקט עדכון האירוע כולל את המאפיינים הבאים: `acknowledgeid` - `(string)` ID acknowledgment; `userid` - `(string)` מזהה המשתמש שעדכן את האירוע; `eventid` - `(string)` מזהה האירוע המעודכן; `clock` - `(timestamp)` זמן שבו האירוע עודכן; `הודעה` - `(string)` text of the message; `action` - `(integer)` פעולת עדכון שבוצעה ראה event.acknowledge; `old_severity` - `(integer)` חומרת האירוע לפני פעולת העדכון הזו; `new_severity` - `(integer)` חומרת האירוע לאחר פעולת העדכון הזו; `username` - `(string)` שם המשתמש של המשתמש שעדכן את האירוע; `שם` - `(מחרוזת)` שם המשתמש שעדכן את האירוע; `שם משפחה` - `(מחרוזת)` שם המשפחה של המשתמש שעדכן את האירוע . תומך ב'ספירה'.
selectTags	query	החזר מאפיין tags עם תגי אירועים.
selectSuppressionData	query	החזר מאפיין `suppression_data` עם רשימת התחזוקה: `maintenanceid` - `(string)` מזהה התחזוקה; `suppress_until` - `(integer)` זמן עד לאירוע מדוכא.
sortfield	string/array	מיין את התוצאה לפי המאפיינים הנתונים. ערכים אפשריים הם: `eventid`, `objectid` ו-`clock`.
countOutput	boolean	הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף פרשנות הפניה.
עריכה	בוליאנית
excludeSearch	בולאני
filter	object
limit	מספר שלם
פלט	שאילתה
preservekeys	בולאני
חיפוש	אובייקט
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	מחרוזת/מערך
startSearch	boolean

החזר ערכים

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

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

דוגמאות

מאחזר אירועי טריגר

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "event.get",
            "params": {
                "output": "להרחיב",
                "select_acknowledges": "להאריך",
                "selectTags": "להרחיב",
                "selectSuppressionData": "להרחיב",
                "objectids": "13926",
                "sortfield": ["שעון", "eventid"],
                "sortorder": "DESC"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "eventid": "9695",
                    "source": "0",
                    "object": "0",
                    "objectid": "13926",
                    "שעון": "1347970410",
                    "value": "1",
                    "acknowledged": "1",
                    "ns": "413316245",
                    "name": "MySQL מושבת",
                    "חומרה": "5",
                    "r_eventid": "0",
                    "c_eventid": "0",
                    "correlationid": "0",
                    "userid": "0",
                    "opdata": "",
                    "מאשר": [
                        {
                            "acknowledgeid": "1",
                            "userid": "1",
                            "eventid": "9695",
                            "שעון": "1350640590",
                            "message": "הבעיה נפתרה.\n\r----[אישור בכמות גדולה]----",
                            "action": "6",
                            "old_severity": "0",
                            "new_severity": "0",
                            "username": "מנהל",
                            "name": "Zabix",
                            "שם משפחה": "מנהל"
                        }
                    ],
                    "suppression_data": [
                        {
                            "maintenanceid": "15",
                            "suppress_until": "1472511600"
                        }
                    ],
                    "suppressed": "1",
                    "תגים": [
                        {
                            "tag": "שירות",
                            "value": "mysqld"
                        },
                        {
                            "tag": "שגיאה",
                            "ערך": ""
                        }
                    ]
                },
                {
                    "eventid": "9671",
                    "source": "0",
                    "object": "0",
                    "objectid": "13926",
                    "שעון": "1347970347",
                    "value": "0",
                    "acknowledged": "0",
                    "ns": "0",
                    "name": "לא זמין על ידי ping ICMP",
                    "חומרה": "4",
                    "r_eventid": "0",
                    "c_eventid": "0",
                    "correlationid": "0",
                    "userid": "0",
                    "opdata": "",
                    "מאשר": [],
                    "suppression_data": [],
                    "suppressed": "0",
                    "תגים": []
                }
            ],
            "מזהה": 1
       }

אחזור אירועים לפי פרק זמן

אחזר את כל האירועים שנוצרו בין ה-9 ל-10 באוקטובר, 2012, בסדר כרונולוגי הפוך.