Hledání

Hledání prohledává zachycený provoz HTTP v aktuálním projektu včetně záznamů mimo právě načtené řádky historie HTTP.

Otevření Hledání

Klikněte na Hledání v levé navigaci. Zadejte strukturovaná kritéria a/nebo výraz HTTPQL a klikněte na Hledat nebo stiskněte Enter. Psaní mění kritéria bez spuštění nového vyhledávání. Další výsledky prohlížejte pomocí stránkování.

Syntaxe HTTPQL

HTTPQL je strukturovaný dotazovací jazyk pro provoz HTTP. Vyhledává shody v polích požadavků a odpovědí pomocí typových operátorů.

Pole

Pole	Vyhledává v
req.host	Název hostitele požadavku.
req.path	Cesta požadavku.
req.method	Metoda HTTP (GET, POST apod.).
req.body	Obsah těla požadavku.
resp.code	Stavový kód odpovědi (celé číslo).
resp.len	Délka těla odpovědi v bajtech (celé číslo).
resp.body	Obsah těla odpovědi.
resp.header["Name"].value	Hodnota pojmenované hlavičky odpovědi.
req.header["Name"].value	Hodnota pojmenované hlavičky požadavku.
req.has_finding	Pravda, pokud má požadavek připojen alespoň jeden nález.
req.tag	Řetězec štítku přiřazeného požadavku.

Operátory

Operátor	Použití pro	Význam
eq	řetězec, celé číslo	Přesná shoda.
ne	řetězec, celé číslo	Nerovná se.
cont	řetězec	Obsahuje podřetězec.
ncont	řetězec	Neobsahuje podřetězec.
regex	řetězec	Odpovídá regulárnímu výrazu.
gt	celé číslo	Větší než.
gte	celé číslo	Větší nebo rovno.
lt	celé číslo	Menší než.
lte	celé číslo	Menší nebo rovno.
exists	hlavičky	Hlavička je přítomna.

Kombinování výrazů

Podmínky kombinujte pomocí AND a OR. Závorky určují prioritu. Pro vyloučení shod použijte záporné operátory, například ne nebo ncont.

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

Příklady dotazů

Najděte požadavky POST, které vrátily chybu z řady 500:

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

Najděte požadavky s hlavičkou Authorization:

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

Najděte velké odpovědi od konkrétního hostitele:

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

Najděte požadavky označené pro následnou kontrolu:

req.tag.eq:followup

Najděte všechny požadavky s připojeným nálezem:

req.has_finding.eq:true

Najděte požadavky, jejichž tělo odpovědi obsahuje známý chybový řetězec:

resp.body.cont:"stack trace"

Uložená vyhledávání

Pomocí Připnout vedle vstupu HTTPQL uchovejte často používaný dotaz pro rychlé opětovné použití. Vyberte připnutý dotaz, aby se použil; když jej již nepotřebujete, odeberte jeho štítek. Historie dotazů také pomáhá znovu používat nedávné výrazy.

Karty vyhledávání umožňují porovnávat nezávislé dotazy během aktuální návštěvy. Nejde o trvale uložená vyhledávání. Pro pojmenované strukturované předvolby, které lze exportovat a importovat, použijte stránku Filtry.

Prohlížení výsledků

Kliknutím na libovolný řádek tabulky výsledků otevřete požadavek a odpověď v panelu podrobností. Jde o stejné zobrazení jako v historii HTTP: můžete přepínat mezi surovým a formátovaným zobrazením, kopírovat hlavičky nebo tělo a přidávat nálezy přímo z panelu.

Pomoc AI

Když je nastaven poskytovatel AI, klikněte na AI vedle vstupu dotazu a běžným jazykem popište, co chcete najít. Ogma vygeneruje výraz HTTPQL. Před spuštěním dotaz zkontrolujte.

• „Požadavky POST vracející chyby serveru“ > req.method.eq:POST AND resp.code.gte:500
• „Odpovědi větší než 50 KB ze subdomény API“ > req.host.cont:api AND resp.len.gt:51200
• „Požadavky s připojenými nálezy“ > req.has_finding.eq:true

Související stránky

• HTTPQL a StreamQL
• Historie HTTP
• Filtry