Vue d'ensemble
Ce que la plateforme a remarqué sur votre intégration avant vous.
La page Overview est le premier écran de Konsole. Elle affiche cinq chiffres pour la période sélectionnée, puis une liste de cartes d'anomalie. Chaque carte correspond à une règle déclenchée par votre propre trafic.
Les cinq chiffres
| Chiffre | Méthode de calcul |
|---|---|
| Requests | Chaque appel d'API de la période, pour l'environnement actuel |
| Errors | Les appels qui ont renvoyé 400 ou un code supérieur |
| Error Rate | La part des erreurs dans les requêtes |
| P95 Latency | Le 95e percentile de duration_ms, qui correspond le mieux à ce que ressentent les utilisateurs |
| Failed Webhooks | Les livraisons marquées failed sur la période, rapportées à l'ensemble des livraisons |
Requests est accompagné d'un écart par rapport à la période précédente de même durée. Une vue sur sept jours se compare donc aux sept jours précédents. Error Rate et P95 Latency restent vides sous 20 requêtes sur la période : sur quelques appels, un seul échec ressemblerait à une panne.
Consultez le p95
Le p95 montre les valeurs extrêmes qu'une moyenne masquerait. S'il affiche 4 200 ms, un appel sur vingt prend plus de quatre secondes. Ce sont ces appels que vos clients abandonnent.
Les cartes d'anomalie
Neuf règles s'exécutent sur votre compte. Les cartes sont classées par gravité et la page affiche les trois premières ; le nombre à côté du titre de la section compte toutes les cartes déclenchées. Chaque carte mène à la vue qui présente les lignes concernées.
| Carte | Condition de déclenchement |
|---|---|
| p95 élevé sur un endpoint | p95 supérieur à 2 s au cours des dernières 24 heures, sur au moins 2 appels. Gravité élevée au-dessus de 5 s |
| Taux d'erreur élevé sur un endpoint | Au moins un quart des appels vers ce chemin ont renvoyé une erreur, sur au moins 2 appels |
| Échecs de livraison de webhooks | Au moins 3 échecs vers un endpoint au cours de la dernière heure |
| Erreurs d'authentification | Réponses 401 au cours des dernières 24 heures. Gravité élevée à partir de 20 |
| Endpoint de webhook inactif | Un endpoint créé depuis plus de 14 jours qui n'a rien reçu depuis 14 jours |
| API key inutilisée | Une clé créée depuis plus de 30 jours, jamais utilisée ou inutilisée depuis 60 jours |
| Secret de signature vieux de plus de 6 mois | Le secret de l'endpoint n'a pas été renouvelé depuis 180 jours |
| Endpoint de webhook sans HTTPS | Un endpoint live dont l'URL commence par http:// : ses livraisons circulent en clair. Live uniquement |
| Dégradation de la latence | La moyenne d'hier dépasse nettement la valeur de référence sur 7 jours |
Les deux premières règles se déclenchent volontairement dès deux requêtes. Une nouvelle intégration qui effectue quatre appels, dont trois échouent, est précisément le cas où une règle basée sur un pourcentage ne doit pas rester silencieuse.
Certaines cartes concernent l'hygiène, pas les incidents
Une clé inutilisée et un secret vieux de six mois ne constituent pas des pannes. Ils vous rappellent que le meilleur moment pour réduire votre exposition est avant toute fuite.
Le diagnostic en un clic
Les cartes liées aux webhooks, à l'authentification et à la latence possèdent un bouton Diagnose. Il lance un ensemble de vérifications côté serveur et fournit un verdict. Vous n'avez pas à parcourir les logs vous-même.
Pour un endpoint de webhook, cet ensemble comporte sept vérifications, dans cet ordre.
- 1
L'endpoint existe
Il n'a pas été supprimé depuis la création de la carte.
- 2
L'endpoint est activé
Un endpoint désactivé ne reçoit rien. C'est l'explication la plus fréquente des endpoints silencieux.
- 3
L'URL est valide
Une URL impossible à analyser a été mal copiée.
- 4
HTTPS est obligatoire en mode live
Les livraisons en mode live sont envoyées uniquement en HTTPS.
- 5
Le secret de signature est configuré
Sans lui, rien ne peut être signé ni envoyé.
- 6
L'endpoint est accessible
Wajub envoie immédiatement une requête
HEADsortante vers votre URL. - 7
Taux d'échec récent
Le nombre de tentatives récentes qui ont échoué vous aide à distinguer un incident passager d'une panne.
Le verdict compte les échecs et les simples avertissements. Un échec désigne un problème à corriger avant une nouvelle tentative. Un avertissement indique un point à examiner.
Diagnose est limité à 30 exécutions par minute
Chaque exécution peut envoyer une requête HTTP sortante vers votre serveur. Cette route est donc limitée. Vous ne le remarquerez jamais dans un usage normal.
Pour une carte d'authentification, l'ensemble compte les réponses 401 des dernières 24 heures. Pour une carte de latence, il vérifie la taille de l'échantillon, puis liste les endpoints les plus lents des dernières 24 heures.
Fraîcheur des chiffres
Les chiffres et les cartes d'anomalie se mettent à jour environ toutes les minutes. D'autres panneaux, comme les tendances et la synthèse de santé, peuvent prendre jusqu'à 10 minutes. Une modification n'apparaît donc pas immédiatement.
Si vous venez de corriger un endpoint et que la carte est toujours affichée, attendez une minute avant de conclure que la correction n'a pas fonctionné.
Pages associées
- Logs APILes lignes à l'origine des cartes de latence et d'erreur.
- WebhooksL'endpoint que le diagnostic vient de sonder.
- SurveillanceTransformez ces signaux en alertes que vous n'avez pas à rechercher.
- Plafonds et quotasLes plafonds à l'origine des erreurs de limite de requêtes que vous observez peut-être.