---
url: https://docs.ogmabox.com/cs/app/search.md
description: Prohledávejte provoz a nálezy projektů Ogma pomocí HTTPQL a filtrů obsahu.
---

# Hledání {#search}

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í {#opening-search}

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-syntax}

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 {#fields}

| 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 {#operators}

| 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ů {#combining-expressions}

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`.

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

## Příklady dotazů {#example-queries}

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

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

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

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

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

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

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

```text
req.tag.eq:followup
```

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

```text
req.has_finding.eq:true
```

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

```text
resp.body.cont:"stack trace"
```

## Uložená vyhledávání {#saved-searches}

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](./filters.md).

## Prohlížení výsledků {#inspecting-results}

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 {#ai-assist}

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 {#related-pages}

* [HTTPQL a StreamQL](../reference/httpql.md)
* [Historie HTTP](./http-history.md)
* [Filtry](./filters.md)