Diagnostics
Utiliser les diagnostics développeur pour comprendre readiness setup, problèmes actifs, checks réussis et corrections recommandées.
Diagnostics résume si votre setup développeur Kadryn est prêt pour la production.
Utilisez-le lorsque Gateway, ingestion directe, provider clés, webhooks, visibilité des coûts ou observability sont pas behaving as expected.
Ce que Diagnostics vérifie
Diagnostics peut évaluer signals across:
- authentication;
- provider clés;
- Gateway;
- ingestion directeion;
- webhooks;
- coûts;
- gouvernance;
- observability.
It highlights critical, warning, info et passed checks.
États de readiness
| State | Meaning |
|---|---|
ready | No blocking setup issue est detected. |
needs_attention | Some warnings doit be reviewed. |
critical | At least one issue blocks ou breaks un production path. |
waiting_for_signal | Kadryn needs trafic, delivery ou ingestion données avant it peut judge readiness. |
Sévérités des problèmes
| Severity | Meaning |
|---|---|
critical | Corriger avant de s’appuyer sur ce chemin en production. |
warning | Passez en revue soon; production peut be degraded ou incomplet. |
info | Useful guidance ou context. |
passed | A vérifier succeeded. |
Cartes de problème
Each issue explique:
- category;
- severity;
- title;
- impact;
- preuves;
- fix;
- last seen time;
- primary action;
- related docs.
Utilisez le primary action à jump à le exact Kadryn page que peut fix le issue.
Metrics
Diagnostics also summarizes operational signals such as:
- événements d’usage live sur les dernières 24 heures;
- Gateway requests dans le last 24 hours;
- Gateway non-success compte;
- fallback usage;
- ingestion directeion attempts;
- rejeté ou invalide ingestion attempts;
- active webhook endpoints;
- failing ou retrying webhook deliveries.
Workflow recommandé
- Ouvrez Developers → Diagnostics.
- Passez en revue le readiness état.
- Corrigez d’abord les problèmes critiques.
- Utilisez le primary action sur le top issue.
- Re-run un non-sensible test.
- Vérifiez results dans Logs & Traces.
- Passez en revue passed checks.
Quand Diagnostics est verrouillé
Si Diagnostics est verrouillé par le forfait ou l’accès, utilisez directement les pages développeur disponibles :
- API Keys;
- Gateway;
- ingestion directe;
- Webhooks;
- Logs & Traces.
Upgrade ou ask un admin si diagnostics sont requis pour production operations.
Common issues
No live usage
Envoyez un Gateway ou ingestion directe test request, then vérifier Logs & Traces.
Gateway un erreurs
Ouvrez la readiness des routes Gateway et les clés provider. Vérifiez si les requêtes sont bloquées par une policy ou par des erreurs de clé provider.
ingestion directe rejeté événements
Ouvrez Logs & Traces et inspecter validation erreurs. Vérifiez timestamp, provider, model, coût et métadonnées champs.
Webhook endpoint failing
Vérifiez réponse statut, signature verification, endpoint latence et retry état.
Cost signals manquant
Vérifiez si les événements d’usage ont une couverture de pricing et des métadonnées valides.