# 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.

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](#le-bouton-activer-le-monitoring-napparaît-pas)
- [Une sonde n'apparaît pas sur la page de statut](#une-sonde-napparaît-pas-sur-la-page-de-statut)
- [La création d'une sonde échoue](#la-création-dune-sonde-échoue)
- [Un service est Non sain](#un-service-est-non-sain)
- [Un service reste Dégradé](#un-service-reste-dégradé)
- [Les logs ne se chargent pas](#les-logs-ne-se-chargent-pas)
- [Je ne trouve pas un log de la semaine dernière](#je-ne-trouve-pas-un-log-de-la-semaine-dernière)
- [Mes logs n'ont pas de niveau](#mes-logs-nont-pas-de-niveau)
- [Un téléchargement de logs est incomplet ou refusé](#un-téléchargement-de-logs-est-incomplet-ou-refusé)
- [Les métriques affichent Aucune donnée](#les-métriques-affichent-aucune-donnée)

## 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](/v1.0/builds-et-deploiements).
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](/v1.0/supervision/ecrire-des-logs-filtrables). 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 voyez | Cause |
|---|---|
| Le téléchargement échoue dans la barre de téléchargements du navigateur | Un 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 serveur` | Une 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](/v1.0/supervision/reference#fichier-de-logs-téléchargé).

## 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é.
