חיפוש

החיפוש מבצע שאילתות בתעבורת HTTP שנלכדה בפרויקט הנוכחי, כולל רשומות מעבר לשורות הטעונות כרגע בהיסטוריית HTTP.

פתיחת החיפוש

לחצו על חיפוש בניווט משמאל. הזינו קריטריונים מובנים ו/או ביטוי HTTPQL, ואז לחצו על חיפוש או הקישו Enter. הקלדה משנה את הקריטריונים בלי להריץ חיפוש חדש. השתמשו בדפדוף בין עמודים לבדיקת תוצאות נוספות.

תחביר HTTPQL

HTTPQL היא שפת שאילתות מובנית לתעבורת HTTP. היא משווה שדות בקשה ותגובה באמצעות אופרטורים בעלי סוג מוגדר.

שדות

שדה	התאמה
req.host	שם מארח הבקשה.
req.path	נתיב הבקשה.
req.method	שיטת HTTP, כגון GET או POST.
req.body	תוכן גוף הבקשה.
resp.code	קוד מצב התגובה, מספר שלם.
resp.len	אורך גוף התגובה בבתים, מספר שלם.
resp.body	תוכן גוף התגובה.
resp.header["Name"].value	ערך כותרת התגובה ששמה צוין.
req.header["Name"].value	ערך כותרת הבקשה ששמה צוין.
req.has_finding	אמת כאשר לבקשה מצורף לפחות ממצא אחד.
req.tag	מחרוזת התג שהוחל על הבקשה.

אופרטורים

אופרטור	חל על	משמעות
eq	מחרוזת, מספר שלם	התאמה מדויקת.
ne	מחרוזת, מספר שלם	לא שווה.
cont	מחרוזת	מכיל תת-מחרוזת.
ncont	מחרוזת	אינו מכיל תת-מחרוזת.
regex	מחרוזת	מתאים לביטוי רגולרי.
gt	מספר שלם	גדול מ-.
gte	מספר שלם	גדול או שווה.
lt	מספר שלם	קטן מ-.
lte	מספר שלם	קטן או שווה.
exists	כותרות	הכותרת קיימת.

שילוב ביטויים

השתמשו ב-AND וב-OR לשילוב תנאים. סוגריים קובעים את סדר הקדימויות. השתמשו באופרטורים שליליים כגון ne או ncont כדי להחריג התאמות.

(req.method.eq:POST OR req.method.eq:PUT) AND resp.code.gte:500

שאילתות לדוגמה

מציאת בקשות POST שהחזירו שגיאה בטווח 500:

req.method.eq:POST AND resp.code.gte:500

מציאת בקשות עם כותרת Authorization:

req.header["Authorization"].value.exists

מציאת תגובות גדולות ממארח מסוים:

req.host.eq:api.example.com AND resp.len.gt:100000

מציאת בקשות מתויגות למעקב:

req.tag.eq:followup

מציאת כל הבקשות שמצורף להן ממצא:

req.has_finding.eq:true

מציאת בקשות שגוף התגובה שלהן מכיל מחרוזת שגיאה מוכרת:

resp.body.cont:"stack trace"

חיפושים שמורים

השתמשו ב-הצמדה לצד קלט HTTPQL כדי לשמור שאילתה נפוצה לשימוש חוזר מהיר. בחרו שאילתה מוצמדת כדי להחילה; הסירו את התווית שלה כשהיא אינה נחוצה. היסטוריית השאילתות מסייעת גם בשימוש חוזר בביטויים אחרונים.

לשוניות החיפוש מאפשרות להשוות שאילתות עצמאיות במהלך הביקור הנוכחי. הן אינן חיפושים שמורים קבועים. לתצורות מובנות בעלות שם שניתן לייצא ולייבא, השתמשו בעמוד המסננים.

בדיקת תוצאות

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

סיוע AI

כאשר מוגדר ספק AI, לחצו על בינה מלאכותית ליד קלט השאילתה כדי לתאר בשפה טבעית את מה שאתם רוצים למצוא. Ogma מייצר את ביטוי HTTPQL. בדקו את השאילתה לפני הרצתה.

• "בקשות POST שמחזירות שגיאות שרת" > req.method.eq:POST AND resp.code.gte:500
• "תגובות גדולות מ-50 KB מתת-הדומיין של API" > req.host.cont:api AND resp.len.gt:51200
• "בקשות שמצורפים להן ממצאים" > req.has_finding.eq:true

עמודים קשורים

• HTTPQL ו-StreamQL
• היסטוריית HTTP
• מסננים