Skip to content

Référence de la supervision

Écrans, champs, statuts, valeurs de santé, périodes, rétention et limites de la supervision, des logs et des métriques.

ReferenceDeveloper

This page has not been translated yet and is shown in French.

La supervision se pilote depuis la console Wakastart. Il n'existe pas d'API publique d'hébergement pour les clients.

Écrans

ÉcranChemin dans la consoleDroit requis à l'écran
Supervision d'un environnementenvironnement › onglet Monitoring« Infra Client » ; « Configurer les alertes monitoring » pour agir
Santé des servicesenvironnement › onglet Services, colonne Santé« Infra Client »
Santé des basesenvironnement › onglet Databases, colonne Santé« Infra Client »
Logs d'un serviceenvironnement › Services › service › onglet Logs« Infra Client »
Métriques d'un serviceenvironnement › Services › service › onglet Metrics« Infra Client »

En production, les actions de l'onglet Monitoring demandent en plus « Accès infrastructure en production ».

Supervision d'un environnement

ÉlémentValeur
Nom du groupe de sondes<Application> - <environnement>
Titre de la page de statut<Application> - <environnement> Status
Adresse de la page de statuthttps://status.wakastart.app/<application>-<environnement>
Supervision par environnement1

Sonde

ChampValeursPar défaut
Route HTTP (optionnel)une route en ligne de l'environnement, ou URL manuelleURL manuelle
Nom de la sonde1 à 100 caractères—
URLcommence par https://, 2 000 caractères au plusURL de la route choisie
Intervalle de vérification30 secondes, 1 minute, 5 minutes, 15 minutes1 minute

Colonnes de la carte Sondes HTTP : Nom, URL, Intervalle, Statut, Activée, Actions. Une seule sonde active par route.

Statuts d'une sonde et de la page de statut

CodeLibellé
PENDINGEn attente
PROVISIONINGProvisionnement
PROVISIONEDActif
FAILEDÉchec
DESTROYINGSuppression
DESTROYEDSupprimé

Santé

CodeLibellé
HEALTHYSain
DEGRADEDDégradé
UNHEALTHYNon sain
UNKNOWNInconnu
NOT_APPLICABLEN/A

Recalcul complet toutes les 5 minutes ; Vérifier maintenant répond en 10 secondes au plus.

Logs

ÉlémentValeur
Canal collectéSortie standard (stdout) et sortie d'erreur (stderr) des conteneurs ; un fichier écrit dans le conteneur n'est pas collecté
Conservation7 jours ; aucune période ne commence plus tôt
Périodes de l'écranTemps réel, Dernière heure, 24 dernières heures (par défaut), 7 derniers jours, Personnalisée (à la minute, heure locale)
AffichageLes plus récentes en premier, par lots de 100 ; 1 000 lignes gardées à l'écran
Temps réelNouvelles lignes toutes les 5 secondes, pause possible
Niveau minimumTous les niveaux, Debug et plus, Info et plus, Warn et plus, Erreurs et plus
Inclure les lignes sans niveauCochée par défaut
SortieToutes les sorties, Sortie standard (stdout), Sortie d'erreur (stderr)
Recherche200 octets au plus (un caractère accentué en compte 2), 3 caractères % au plus
Taille d'une ligne1 Mo ; au-delà, découpée en morceaux sans niveau
AccèsApplications de votre partenaire et applications auxquelles vous êtes assigné, à l'écran comme au téléchargement

Les filtres sont appliqués par le serveur sur toute la période. À l'écran, une ligne FATAL s'affiche comme error, et une ligne sans niveau généralement comme info ; seul le fichier téléchargé donne le niveau exact retenu.

Niveaux de log reconnus

Le niveau est lu dans la première clé présente d'une ligne JSON, dans cet ordre :

OrdreCléÉcosystème
1levelpino, winston, NestJS en JSON, Go log/slog, zap, logrus, structlog
2severityGoogle Cloud Logging
3log.level (clé contenant un point)ECS logging
4log → level (objet imbriqué)Variante imbriquée d'ECS
5levelnamepython-json-logger
6@lSerilog compact (CLEF) ; sans @l mais avec @m ou @mt, le niveau vaut INFO

Les valeurs texte sont comparées sans tenir compte de la casse :

ValeurNiveau retenu
trace, silly, ou un nombre de 10 à 19TRACE
debug, verbose, http, ou un nombre de 20 à 29DEBUG
info, information, log, notice, ou un nombre de 30 à 39INFO
warn, warning, ou un nombre de 40 à 49WARN
error, err, exception, ou un nombre de 50 à 59ERROR
fatal, critical, crit, alert, emerg, emergency, panic, dpanic, ou un nombre de 60 à 69FATAL
Toute autre valeur, un objet, un booléen, un nombre hors de 10 à 69, ou aucune de ces clésSans niveau
  • Les nombres sont ceux de pino et bunyan ; un niveau personnalisé 35 est lu comme INFO.
  • trace, debug, info, warn ou error suivi d'un décalage (INFO+2, DEBUG-4, niveaux intermédiaires de log/slog) est ramené à ce libellé. Tout autre libellé suivi d'un décalage (FATAL+1, warning+1) donne une ligne sans niveau.
  • verbose est rangé avec DEBUG, quelle que soit la bibliothèque.
  • Texte NestJS par défaut : le mot LOG, ERROR, WARN, DEBUG, VERBOSE ou FATAL qui précède le premier [Contexte] ; LOG est lu INFO, VERBOSE est lu DEBUG.

Téléchargement

RéglageValeurs
PériodePériode affichée (par défaut), Dernière heure, 24 dernières heures, 7 derniers jours, Une journée (de minuit à minuit, heure locale), Plage personnalisée
PérimètreCe service (par défaut), Tout l'environnement
Appliquer les filtres de la consoleCochée par défaut : niveau minimum, sortie et recherche
FormatTexte (.log) (par défaut), JSON, une ligne par log (.jsonl)
Lignes par fichier1 000 000 au plus ; au-delà, les lignes les plus anciennes jusqu'au plafond
Durée maximale de préparation12 minutes ; au-delà, le fichier est coupé
Téléchargements simultanésUn par environnement et un par personne ; un plafond global s'applique à la plateforme

Fichier de logs téléchargé

  • Lignes dans l'ordre chronologique, les plus anciennes en premier ; une ligne identique à une autre (même horodatage, pod, conteneur, sortie, niveau et contenu) n'est écrite qu'une fois.
  • Nom : logs-<app>-<env>-<service>-<début>_<fin>.log (ou .jsonl), avec all à la place du service pour tout l'environnement, et des bornes en UTC (20261023T000000Z).
  • Texte (.log) : [horodatage UTC] [NIVEAU] [pod:…] [service] ligne d'origine. Un retour à la ligne contenu dans un log est écrit \n. Une ligne sans niveau porte [-].
  • JSON (.jsonl) : un objet par ligne avec timestamp, body (la ligne d'origine), severityText, severityNumber (0 sans niveau), stream, pod, container, deployment, namespace et, s'il est connu, node.

Un fichier incomplet se termine par une ligne de fin ; sans elle, il est complet :

CasTexte (.log)JSON (.jsonl)
Plafond de lignes atteint# export tronqué : limite de 1000000 lignes atteinte, dernière ligne à <horodatage>{"_export":{"truncated":true,"limit":1000000,"lastTimestamp":"…"}}
Erreur du serveur en cours de route# export interrompu : erreur serveur{"_export":{"error":"interrupted"}}
Durée maximale atteinte# export interrompu : durée maximale de 12m0s atteinte, dernière ligne à <horodatage> (- si aucune ligne n'a été écrite){"_export":{"error":"maxDuration","maxDuration":"12m0s","lastTimestamp":"…"}} (sans lastTimestamp si aucune ligne)

Métriques

MétriqueLibellé
cpuCPU
memoryMémoire
filesystemDisque
network_rxRéseau (entrant)
network_txRéseau (sortant)
PériodePas
1 heure1 minute
6 heures5 minutes
24 heures15 minutes
7 jours1 heure

Rafraîchissement du Résumé : 15 secondes. Fenêtre de consultation maximale : 7 jours.