# Consulter les logs d'un service

> Lisez les logs d'un service sur une période choisie, filtrez-les par niveau, sortie ou texte, suivez-les en temps réel et téléchargez-les.

L'onglet **Logs** d'un service affiche ce que ses conteneurs écrivent sur la sortie standard (stdout) et la sortie d'erreur (stderr), sur la période de votre choix dans les 7 derniers jours. Les filtres sont appliqués par le serveur, sur toute la période, et le même réglage sert au téléchargement.

## Avant de commencer

- Le service est déployé dans l'environnement.
- Vous voyez l'application dans la console : les logs ne sont servis que pour les applications de votre partenaire ou celles auxquelles vous êtes assigné. Le téléchargement ne donne aucun accès de plus que l'écran.
- Pour filtrer par niveau, votre service écrit ses logs en JSON, un objet par ligne, avec un champ `level` : voir [Écrire des logs filtrables par niveau](/v1.0/supervision/ecrire-des-logs-filtrables). Sans cela, les lignes sont affichées et téléchargées, mais sans niveau.

## Lire les logs

::::steps
### Ouvrir le service

Dans l'environnement, ouvrez l'onglet **Services**, puis cliquez sur le service.

### Ouvrir l'onglet Logs

Cliquez sur l'onglet **Logs**.

Les 100 lignes les plus récentes des **24 dernières heures** s'affichent, les plus récentes en premier. Sous la barre de réglages, la période réellement affichée est rappelée (« Du … au … ») avec le fuseau utilisé (« Heure locale : … »).

### Choisir la période

Dans **Période**, choisissez **Temps réel**, **Dernière heure**, **24 dernières heures**, **7 derniers jours** ou **Personnalisée**.

Pour **Personnalisée**, saisissez le **Début** et la **Fin** à la minute, en heure locale, puis cliquez sur **Afficher**. Le début ne peut pas remonter à plus de 7 jours, et la fin ne peut pas être dans le futur.

### Filtrer

- **Niveau minimum** : **Tous les niveaux**, **Debug et plus**, **Info et plus**, **Warn et plus** ou **Erreurs et plus**. « Warn et plus » garde `WARN`, `ERROR` et `FATAL` ; « Erreurs et plus » garde `ERROR` et `FATAL`.
- **Inclure les lignes sans niveau** : apparaît dès qu'un niveau minimum est choisi, cochée par défaut. Décochez-la pour ne garder que les lignes dont le niveau est reconnu.
- **Sortie** : **Toutes les sorties**, **Sortie standard (stdout)** ou **Sortie d'erreur (stderr)**.
- **Recherche** : un texte cherché dans les lignes, 200 octets au plus (un caractère accentué en compte 2). La recherche part dès que vous cessez de taper.

### Remonter dans la période

Cliquez sur **Charger plus** en bas de la liste : 100 lignes plus anciennes s'ajoutent, **dans la même période**. Les bornes sont figées au chargement et ne glissent pas d'un lot à l'autre. L'écran garde au plus 1 000 lignes ; au-delà, téléchargez.

### Actualiser

Cliquez sur **Actualiser** pour recharger la période. Une période glissante (**Dernière heure**, **24 dernières heures**, **7 derniers jours**) est alors recalculée jusqu'à maintenant.
::::

:::note
**Les lignes sans niveau sont incluses par défaut.** Quand vous filtrez par niveau, elles restent affichées tant que **Inclure les lignes sans niveau** est cochée. Sans cela, les logs d'un service qui n'écrit pas encore dans un format reconnu disparaîtraient, quel que soit le filtre.
:::

## Suivre en temps réel

1. Dans **Période**, choisissez **Temps réel**.
2. Les 24 dernières heures s'affichent, puis les nouvelles lignes arrivent en tête toutes les 5 secondes. La période est rappelée sous la forme « Depuis le …, en direct ».
3. Mettez le temps réel en pause pour lire : la pause arrête la récupération des nouvelles lignes, pas seulement le défilement (« Depuis le …, en pause »). Reprenez-le quand vous le souhaitez.

Si le message « Temps réel interrompu : nouvelle tentative dans quelques secondes. » s'affiche, la console réessaie seule.

## Télécharger les logs

::::steps
### Ouvrir la fenêtre de téléchargement

Dans la barre d'outils de l'onglet **Logs**, cliquez sur l'icône de téléchargement. La fenêtre **Télécharger les logs** s'ouvre.

### Choisir la période

Dans **Période** :

- **Période affichée** (par défaut) : exactement celle de la console ; en temps réel, jusqu'au moment du téléchargement ;
- **Dernière heure**, **24 dernières heures** ou **7 derniers jours** ;
- **Une journée** : choisissez une **Date**, de minuit à minuit en heure locale. Pour la plus ancienne date proposée, seule une partie de la journée est encore conservée : la fenêtre indique l'heure à laquelle le fichier commencera ;
- **Plage personnalisée** : **Début** et **Fin**, à la minute, en heure locale.

Les limites sont celles de la console : rien au-delà de 7 jours, rien dans le futur.

### Choisir le périmètre et les filtres

- **Périmètre** : **Ce service** (par défaut) ou **Tout l'environnement**, pour les logs de tous les services de l'environnement dans un seul fichier.
- **Appliquer les filtres de la console** : cochée par défaut, elle reprend le niveau minimum, la sortie et la recherche réglés au-dessus de la console. Décochez-la pour télécharger toutes les lignes de la période.

### Choisir le format

Dans **Format**, choisissez **Texte (.log)** (par défaut) ou **JSON, une ligne par log (.jsonl)**.

### Vérifier l'estimation

La fenêtre estime le nombre de lignes du fichier (« Environ … lignes. »). C'est une estimation : elle compte les doublons, retirés ensuite, et des lignes peuvent arriver entre-temps. Si la période compte plus de 1 000 000 lignes, la fenêtre l'annonce par « Le fichier sera coupé à 1000000 lignes » : réduisez la période, limitez le périmètre à **Ce service**, ou filtrez au-dessus de la console.

### Télécharger

Cliquez sur **Télécharger**. Le fichier est préparé par le serveur et arrive dans la barre de téléchargements de votre navigateur.
::::

Le fichier contient les lignes dans l'ordre chronologique, les plus anciennes en premier, sans doublons. Son nom et son contenu sont décrits dans la [référence de la supervision](/v1.0/supervision/reference#fichier-de-logs-téléchargé).

## Vérifier le résultat

- À l'écran, les lignes correspondent aux dernières actions faites sur l'application, à quelques secondes près. Une erreur écrite en JSON avec `"level":"error"` reste visible avec **Erreurs et plus**.
- Ouvrez le fichier téléchargé et lisez sa dernière ligne. S'il se termine par une ligne `# export tronqué …` ou `# export interrompu …` (ou par un objet `"_export"` en JSON), il est incomplet : voir [Un téléchargement de logs est incomplet ou refusé](/v1.0/supervision/depannage#un-téléchargement-de-logs-est-incomplet-ou-refusé). Sinon, il est complet.

## Voir aussi

- [Écrire des logs filtrables par niveau](/v1.0/supervision/ecrire-des-logs-filtrables)
- [Consulter les métriques d'un service](/v1.0/supervision/consulter-les-metriques)
- [Résoudre les problèmes de supervision](/v1.0/supervision/depannage)
