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 quatre 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 quatre chiffres
| Chiffre | Méthode de calcul |
|---|---|
| Requêtes | Chaque appel d'API de la période, pour l'environnement actuel |
| Erreurs | Les appels qui ont renvoyé 400 ou un code supérieur |
| Latence moyenne | La moyenne de duration_ms sur la période |
| Latence p95 | Le 95e percentile, qui correspond le mieux à ce que ressentent les utilisateurs |
Chaque chiffre 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.
Consultez le p95, pas la moyenne
Une moyenne masque les valeurs extrêmes. Si la moyenne est de 180 ms et le p95 de 4 200 ms, un appel sur vingt prend plus de quatre secondes. Ce sont ces appels que vos clients abandonnent.
Les cartes d'anomalie
Huit règles s'exécutent sur votre compte. Elles sont classées par gravité. 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 |
| 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.
Données mises en cache et durée
La page charge ses panneaux après l'interface principale. Chaque panneau est mis en cache par équipe et par environnement. Une modification n'apparaît donc pas immédiatement.
| Panneau | Durée de mise en cache |
|---|---|
| Les quatre chiffres | 60 secondes |
| Cartes d'anomalie | 60 secondes |
| Synthèse de santé | 10 minutes |
| Tendances, répartition des codes de statut, tendances des webhooks | 5 minutes |
| Liste des endpoints | 2 minutes |
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.