Aller au contenu

Résoudre les problèmes de supervision

Les symptômes fréquents avec les sondes, la page de statut, la santé, les logs et les métriques, leur cause et leur solution.

DépannageDéveloppeur
Voir en Markdown

Cette page part de ce que vous voyez dans l'onglet Monitoring, sur la page de statut ou sur la page d'un service.

Symptômes

Le bouton Activer le monitoring n'apparaît pas

Cause : votre profil ne porte pas le droit « Configurer les alertes monitoring », ou, en production, « Accès infrastructure en production ».

Solution : demandez à un administrateur de votre organisation de vous attribuer le profil Infra.

Une sonde n'apparaît pas sur la page de statut

Cause : la page de statut publie les sondes actives au moment de sa dernière mise à jour. Une sonde ajoutée ensuite n'y figure pas tant que la page n'est pas mise à jour.

Solution :

  1. Attendez que la sonde affiche Actif dans la colonne Statut.
  2. Dans la carte Page de statut publique, cliquez sur Appliquer les changements.

Pour vérifier : cliquez sur Ouvrir : la sonde figure sur la page.

La création d'une sonde échoue

Cause : le message « Impossible de créer la sonde. » apparaît quand l'URL ne commence pas par https://, ou quand la route choisie porte déjà une sonde active. Une sonde en Échec après sa création est détaillée dans la carte Erreurs de provisionnement.

Solution : corrigez l'URL, ou modifiez la sonde existante de la route plutôt que d'en créer une seconde.

Un service est Non sain

Cause : un de ses conteneurs est en erreur. Le message de la pastille le précise : CrashLoopBackOff (le programme s'arrête au démarrage), ImagePullBackOff ou ErrImagePull (image introuvable), OOMKilled (mémoire épuisée).

Solution :

  1. Ouvrez l'onglet Logs du service, choisissez Erreurs et plus dans Niveau minimum, et lisez les dernières lignes avant l'arrêt.
  2. Pour OOMKilled, vérifiez l'onglet Metrics, métrique Mémoire, puis augmentez la limite du service.
  3. Pour une image introuvable, vérifiez le build déployé : voir Builds et déploiements.
  4. Cliquez sur Vérifier maintenant après correction.

Un service reste Dégradé

Cause : une partie seulement de ses conteneurs est prête, par exemple un réplica qui ne passe pas ses vérifications de démarrage, ou un déploiement qui ne se termine pas.

Solution : survolez la pastille (par exemple 1/2 pods ready), puis lisez les logs du service. Si un déploiement est en cours, attendez sa fin et cliquez sur Vérifier maintenant.

Les logs ne se chargent pas

Cause : le message « Access denied: missing customer context in token » indique que votre compte n'est rattaché à aucun client. Un message de limite de débit apparaît si de nombreuses requêtes de logs et de métriques sont faites en même temps sur le même environnement.

Solution : pour le rattachement, contactez un administrateur de votre organisation. Pour la limite de débit, patientez quelques secondes, arrêtez le suivi en direct sur les autres onglets, puis cliquez sur Réessayer.

Je ne trouve pas un log de la semaine dernière

Cause : les logs sont conservés 7 jours. Au-delà, ils ne sont plus disponibles, ni à l'écran ni au téléchargement : la console refuse un début plus ancien (« Les logs sont conservés 7 jours : le début ne peut pas être plus ancien. »).

Solution : téléchargez les logs d'un incident dès qu'il survient, avec la période Une journée ou Plage personnalisée qui le couvre, et conservez le fichier.

Mes logs n'ont pas de niveau

Cause : votre service écrit du texte libre (console.log, print), une pile d'appels sur plusieurs lignes, ou du JSON dont le niveau n'est pas dans une clé ou une valeur reconnue. Ces lignes sont conservées, mais sans niveau : avec un Niveau minimum et Inclure les lignes sans niveau décochée, elles disparaissent. Dans un fichier texte, elles portent [-].

Solution : configurez la sortie JSON de votre bibliothèque de logs, en suivant Écrire des logs filtrables par niveau. En attendant, laissez Inclure les lignes sans niveau cochée.

Un téléchargement de logs est incomplet ou refusé

Cause : selon ce que vous voyez.

Ce que vous voyezCause
Le téléchargement échoue dans la barre de téléchargements du navigateurUn téléchargement est déjà en cours pour cet environnement ou pour vous, trop de téléchargements sont en cours sur la plateforme, trop de lignes sont demandées au même instant, ou votre session a expiré
Le fichier se termine par # export tronqué : limite de 1000000 lignes atteinte…La période compte plus de 1 000 000 lignes : la fin de la période manque
Le fichier se termine par # export interrompu : durée maximale de 12m0s atteinte…La préparation a dépassé 12 minutes
Le fichier se termine par # export interrompu : erreur serveurUne erreur est survenue pendant la préparation

Solution : attendez la fin du téléchargement en cours, reconnectez-vous si votre session a expiré, puis relancez. Pour un fichier coupé, réduisez la période, limitez le Périmètre à Ce service, ou gardez Appliquer les filtres de la console cochée avec un niveau, une sortie ou une recherche. En JSON, la dernière ligne est un objet "_export" : voir la référence.

Les métriques affichent Aucune donnée

Cause : le service vient d'être déployé, ou il n'a aucun conteneur en marche sur la période choisie.

Solution : vérifiez que le service est Sain, attendez quelques minutes, puis choisissez la période 1 heure.

Toujours bloqué ?

Contactez le support Wakastart avec le nom de l'application, l'environnement, le service ou la sonde concernés, l'heure de l'observation et le message exact affiché.