Recherche

La vue Recherche interroge le trafic HTTP capturé dans le projet courant, y compris les enregistrements au-delà des lignes actuellement chargées dans Historique HTTP.

Ouvrir la recherche

Cliquez sur Recherche dans la navigation de gauche. Saisissez des critères structurés et/ou une expression HTTPQL, puis cliquez sur Recherche ou appuyez sur Entrée. La saisie modifie les critères sans lancer une nouvelle recherche. Utilisez la pagination pour examiner les résultats supplémentaires.

Syntaxe HTTPQL

HTTPQL est un langage de requête structuré pour le trafic HTTP. Il recherche des correspondances dans les champs des requêtes et des réponses à l'aide d'opérateurs typés.

Champs

Champ	Élément recherché
req.host	Nom d'hôte de la requête.
req.path	Chemin de la requête.
req.method	Méthode HTTP (GET, POST, etc.).
req.body	Contenu du corps de la requête.
resp.code	Code d'état de la réponse (entier).
resp.len	Longueur du corps de la réponse en octets (entier).
resp.body	Contenu du corps de la réponse.
resp.header["Name"].value	Valeur de l'en-tête de réponse nommé.
req.header["Name"].value	Valeur de l'en-tête de requête nommé.
req.has_finding	Vrai lorsque la requête est associée à au moins un constat.
req.tag	Chaîne de l'étiquette appliquée à la requête.

Opérateurs

Opérateur	S'applique à	Signification
eq	chaîne, entier	Correspondance exacte.
ne	chaîne, entier	Différent de.
cont	chaîne	Contient une sous-chaîne.
ncont	chaîne	Ne contient pas une sous-chaîne.
regex	chaîne	Correspond à une expression régulière.
gt	entier	Supérieur à.
gte	entier	Supérieur ou égal à.
lt	entier	Inférieur à.
lte	entier	Inférieur ou égal à.
exists	en-têtes	L'en-tête est présent.

Combiner des expressions

Utilisez AND et OR pour combiner des conditions. Les parenthèses contrôlent la priorité. Utilisez des opérateurs négatifs tels que ne ou ncont pour exclure des correspondances.

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

Exemples de requêtes

Trouver les requêtes POST ayant renvoyé une erreur avec un code de la série 500 :

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

Trouver les requêtes avec un en-tête Authorization :

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

Trouver les réponses volumineuses provenant d'un hôte précis :

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

Trouver les requêtes étiquetées pour un examen complémentaire :

req.tag.eq:followup

Trouver toutes les requêtes associées à un constat :

req.has_finding.eq:true

Trouver les requêtes dont le corps de la réponse contient une chaîne d'erreur connue :

resp.body.cont:"stack trace"

Recherches enregistrées

Utilisez Épingler à côté du champ HTTPQL pour conserver une requête fréquente et la réutiliser rapidement. Sélectionnez une requête épinglée pour l'appliquer ; retirez sa pastille lorsque vous n'en avez plus besoin. L'historique des requêtes aide aussi à réutiliser des expressions récentes.

Les onglets de recherche permettent de comparer des requêtes indépendantes pendant la visite en cours. Il ne s'agit pas de recherches enregistrées persistantes. Pour des préréglages structurés et nommés pouvant être exportés et importés, utilisez la page Filtres.

Inspecter les résultats

Cliquez sur une ligne du tableau des résultats pour ouvrir la requête et la réponse dans le panneau d'inspection. L'inspecteur est la même vue que dans Historique HTTP : vous pouvez basculer entre les vues brute et mise en forme, copier les en-têtes ou le corps et ajouter des constats directement depuis ce panneau.

Assistance par IA

Lorsqu'un fournisseur d'IA est configuré, cliquez sur IA à côté du champ de requête pour décrire en langage naturel ce que vous cherchez. Ogma génère l'expression HTTPQL. Examinez la requête avant de l'exécuter.

• « Requêtes POST renvoyant des erreurs serveur » > req.method.eq:POST AND resp.code.gte:500
• « Réponses de plus de 50 Ko provenant du sous-domaine API » > req.host.cont:api AND resp.len.gt:51200
• « Requêtes associées à des constats » > req.has_finding.eq:true

Pages connexes

• HTTPQL et StreamQL
• Historique HTTP
• Filtres