Aller au contenu

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.

GuideDéveloppeur
Accès requis
Droit « Infra Client » (profils Développeur et Infra)
Durée
5 min
Voir en Markdown

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. Sans cela, les lignes sont affichées et téléchargées, mais sans niveau.

Lire les logs

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

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.

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é. Sinon, il est complet.

Voir aussi