Documentation développeur•stable•Mis à jour 2026-07-08
Logs & Traces
Rechercher les requêtes Gateway, tentatives d’ingestion, livraisons webhook et signaux développeur depuis une vue opérationnelle.
Logs & Traces est le developer investigation surface pour Kadryn trafic.
Utilisez it à answer:
- did Kadryn recevoir le request?
- did Gateway forward it?
- did ingestion directe accept ou reject it?
- did un webhook deliver réussily?
- quels provider, model, project et environment sont impliqués ?
- what trace ID ou request group ID connects ce événement à my app logs?
Ce qui apparaît ici
Depending sur votre workspace, Logs & Traces peut show:
- Gateway requests;
- ingestion directeion attempts;
- webhook deliveries;
- policy decisions;
- fallback usage;
- erreurs;
- synthetic tests;
- expensive requests;
- request groups;
- trace IDs.
Critères de recherche
Useful search champs include:
- Kadryn request ID;
- trace ID;
- request group ID;
- provider request ID;
- projet;
- feature;
- environnement;
- provider;
- model;
- statut;
- erreur code;
- webhook endpoint.
Filtres courants
Utilisez filters à narrow le investigation:
| Filter | Utilisez-le lorsque |
|---|---|
| Gateway | Vous déboguez le trafic provider runtime. |
| Ingestion directe | Vous déboguez un import d’usage. |
| Webhooks | Vous déboguez des livraisons ou des redeliveries. |
| Erreurs seulement | Vous devez voir les échecs en premier. |
| Coûteux seulement | Vous investiguez des appels à coût élevé. |
| Fallback used | You suspect provider fallback ou routage changes. |
| Synthétique seulement | Vous validez des tests plutôt que du trafic de production. |
Investigation Gateway
Lorsqu’une requête Gateway échoue :
- search par trace ID ou request group ID;
- inspecter statut et erreur code;
- vérifier provider route statut;
- vérifier model et provider;
- passer en revue la décision de policy en cas de blocage;
- préserver Kadryn request ID dans support notes.
Investigation ingestion directe
Lorsqu’un événement d’ingestion est manquant :
- search par idempotency clé, provider request ID ou trace ID;
- vérifier accepté vs rejeté attempts;
- inspecter validation erreurs;
- vérifier timestamp et environnement;
- vérifier whether le événement apparaît dans Costs après rollup.
Investigation webhook
Lorsqu’une livraison webhook échoue :
- search par endpoint ou delivery ID;
- inspecter réponse statut;
- vérifier retry état;
- vérifier signature handling;
- redeliver seulement après fixing le recevoirr.
Trafic synthétique
Synthetic trafic est useful pour validation.
Utilisez it à vérifier:
- API clé setup;
- Gateway readiness;
- provider route readiness;
- webhooks endpoint readiness;
- log visibilité;
- trace search.
Ne traitez pas le trafic synthétique comme une preuve de trafic production réel.
Bonnes pratiques de logs
Keep these IDs dans votre application logs:
- trace ID;
- request group ID;
- Kadryn request ID;
- provider request ID;
- idempotency clé hash ou prefix;
- projet;
- environnement.
Ne logguez pas de secrets ni de headers Authorization complets.