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

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

## Écrans

| Écran | Chemin dans la console | Droit requis à l'écran |
|---|---|---|
| Supervision d'un environnement | *environnement* › onglet **Monitoring** | « Infra Client » ; « Configurer les alertes monitoring » pour agir |
| Santé des services | *environnement* › onglet **Services**, colonne **Santé** | « Infra Client » |
| Santé des bases | *environnement* › onglet **Databases**, colonne **Santé** | « Infra Client » |
| Logs d'un service | *environnement* › **Services** › *service* › onglet **Logs** | « Infra Client » |
| Métriques d'un service | *environnement* › **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ément | Valeur |
|---|---|
| Nom du groupe de sondes | `<Application> - <environnement>` |
| Titre de la page de statut | `<Application> - <environnement> Status` |
| Adresse de la page de statut | `https://status.wakastart.app/<application>-<environnement>` |
| Supervision par environnement | 1 |

## Sonde

| Champ | Valeurs | Par défaut |
|---|---|---|
| **Route HTTP (optionnel)** | une route en ligne de l'environnement, ou **URL manuelle** | **URL manuelle** |
| **Nom de la sonde** | 1 à 100 caractères | — |
| **URL** | commence par `https://`, 2 000 caractères au plus | URL de la route choisie |
| **Intervalle de vérification** | **30 secondes**, **1 minute**, **5 minutes**, **15 minutes** | **1 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

| Code | Libellé |
|---|---|
| `PENDING` | **En attente** |
| `PROVISIONING` | **Provisionnement** |
| `PROVISIONED` | **Actif** |
| `FAILED` | **Échec** |
| `DESTROYING` | **Suppression** |
| `DESTROYED` | **Supprimé** |

## Santé

| Code | Libellé |
|---|---|
| `HEALTHY` | **Sain** |
| `DEGRADED` | **Dégradé** |
| `UNHEALTHY` | **Non sain** |
| `UNKNOWN` | **Inconnu** |
| `NOT_APPLICABLE` | **N/A** |

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

## Logs

| Élément | Valeur |
|---|---|
| Canal collecté | Sortie standard (stdout) et sortie d'erreur (stderr) des conteneurs ; un fichier écrit dans le conteneur n'est pas collecté |
| Conservation | 7 jours ; aucune période ne commence plus tôt |
| Périodes de l'écran | **Temps réel**, **Dernière heure**, **24 dernières heures** (par défaut), **7 derniers jours**, **Personnalisée** (à la minute, heure locale) |
| Affichage | Les plus récentes en premier, par lots de 100 ; 1 000 lignes gardées à l'écran |
| Temps réel | Nouvelles lignes toutes les 5 secondes, pause possible |
| **Niveau minimum** | **Tous les niveaux**, **Debug et plus**, **Info et plus**, **Warn et plus**, **Erreurs et plus** |
| **Inclure les lignes sans niveau** | Cochée par défaut |
| **Sortie** | **Toutes les sorties**, **Sortie standard (stdout)**, **Sortie d'erreur (stderr)** |
| **Recherche** | 200 octets au plus (un caractère accentué en compte 2), 3 caractères `%` au plus |
| Taille d'une ligne | 1 Mo ; au-delà, découpée en morceaux sans niveau |
| Accès | Applications 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 :

| Ordre | Clé | Écosystème |
|---|---|---|
| 1 | `level` | pino, winston, NestJS en JSON, Go `log/slog`, zap, logrus, structlog |
| 2 | `severity` | Google Cloud Logging |
| 3 | `log.level` (clé contenant un point) | ECS logging |
| 4 | `log` → `level` (objet imbriqué) | Variante imbriquée d'ECS |
| 5 | `levelname` | python-json-logger |
| 6 | `@l` | Serilog 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 :

| Valeur | Niveau retenu |
|---|---|
| `trace`, `silly`, ou un nombre de 10 à 19 | `TRACE` |
| `debug`, `verbose`, `http`, ou un nombre de 20 à 29 | `DEBUG` |
| `info`, `information`, `log`, `notice`, ou un nombre de 30 à 39 | `INFO` |
| `warn`, `warning`, ou un nombre de 40 à 49 | `WARN` |
| `error`, `err`, `exception`, ou un nombre de 50 à 59 | `ERROR` |
| `fatal`, `critical`, `crit`, `alert`, `emerg`, `emergency`, `panic`, `dpanic`, ou un nombre de 60 à 69 | `FATAL` |
| Toute autre valeur, un objet, un booléen, un nombre hors de 10 à 69, ou aucune de ces clés | Sans 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églage | Valeurs |
|---|---|
| **Période** | **Pé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ètre** | **Ce service** (par défaut), **Tout l'environnement** |
| **Appliquer les filtres de la console** | Cochée par défaut : niveau minimum, sortie et recherche |
| **Format** | **Texte (.log)** (par défaut), **JSON, une ligne par log (.jsonl)** |
| Lignes par fichier | 1 000 000 au plus ; au-delà, les lignes les plus anciennes jusqu'au plafond |
| Durée maximale de préparation | 12 minutes ; au-delà, le fichier est coupé |
| Téléchargements simultanés | Un 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 :

| Cas | Texte (.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étrique | Libellé |
|---|---|
| `cpu` | **CPU** |
| `memory` | **Mémoire** |
| `filesystem` | **Disque** |
| `network_rx` | **Réseau (entrant)** |
| `network_tx` | **Réseau (sortant)** |

| Période | Pas |
|---|---|
| **1 heure** | 1 minute |
| **6 heures** | 5 minutes |
| **24 heures** | 15 minutes |
| **7 jours** | 1 heure |

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