Skip to main content
Les commandes logs apportent les journaux de votre application dans le terminal : suivez-les à mesure qu’ils arrivent, recherchez sur une plage de temps, et gérez les métriques dérivées des journaux et les déclencheurs basés sur les journaux qui en sont construits.

Options communes

Chaque commande logs identifie une application, et utilise votre organisation par défaut sauf si vous lui indiquez autrement :

Suivre les journaux

Diffusez les lignes de journal à mesure qu’elles arrivent (la CLI interroge toutes les secondes) :
Shell

Rechercher dans les journaux

Recherchez les lignes de journal passées et imprimez les correspondances. Par exemple, trouvez les lignes de niveau erreur récentes :
Shell
Par défaut, search retourne jusqu’à 100 des correspondances les plus récentes. En plus des options et filtres communs, elle ajoute : Pour extraire toutes les lignes d’une fenêtre au format JSON, pour un script ou un agent :
Shell

Filtres

tail et search partagent ces filtres : Listez les vues disponibles pour une application avec appsignal-cli logs views, puis passez-en une à --view par nom ou ID. --query et --source-ids remplacent les valeurs sauvegardées de la vue, et --severities restreint davantage la requête de la vue. Par exemple, appliquez une vue mais restreignez-la aux lignes critiques :
Shell

Syntaxe de requête

L’option --query utilise la syntaxe de requête de journal d’AppSignal. Modèles courants :
  • severity=error : correspondance exacte de champ
  • message:timeout : le message contient « timeout »
  • group=notifiers : correspondance exacte de groupe
  • hostname:web-1 : le nom d’hôte contient « web-1 »
  • Les termes séparés par des espaces se combinent avec AND ; utilisez OR pour des alternatives
Les crochets ont une signification spéciale dans le parseur, alors entourez-les de guillemets pour correspondre littéralement : message:"[Email]".

Métadonnées structurées

tail et search incluent les métadonnées structurées de chaque ligne de journal, comme un ID de requête ou un ID utilisateur :
  • La sortie lisible par un humain ajoute les champs à la fin de la ligne sous la forme [key=value ...].
  • La sortie JSON les place dans un objet json sur chaque ligne, et chaque valeur conserve son type JSON. Les métadonnées qu’un logger envoie en texte brut apparaissent sous une clé raw.
Utilisez la sortie JSON lorsqu’un script ou un agent doit lire les métadonnées. Vous pouvez aussi filtrer sur des champs de métadonnées dans --query, y compris des champs imbriqués écrits avec des points. Voir les attributs imbriqués dans la référence de syntaxe de requête.
Shell

Vues et sources sauvegardées

Listez les vues de journal sauvegardées (préréglages de filtres) et les sources de journal d’une application :
Shell
Passez le nom ou l’ID d’une vue à --view, et l’ID d’une source à --source-ids.

Métriques dérivées des journaux

logs metrics transforme les lignes de journal correspondantes en métriques, avec list, create, update et delete :
Shell
create et update partagent ces options (create nécessite --name, --query et au moins une --metric) : update peut prendre les options supplémentaires suivantes. Les options --clear-* vident les champs au lieu de les mettre à jour. delete ne prend que --id.
Une métrique dérivée des journaux ne commence à collecter des données qu’une fois qu’elle est restreinte à une source de journal, alors passez --source-id (trouvez les IDs avec appsignal-cli logs sources). La CLI ne peut pas définir le filtre de sévérité d’une métrique ; si votre métrique en a besoin d’un, définissez le champ Severity dans l’interface utilisateur de l’application AppSignal après l’avoir créée.

Déclencheurs basés sur les journaux

logs triggers alerte sur les lignes de journal correspondantes, avec list, create, update et delete :
Shell
create et update partagent ces options (create nécessite --name et --query) : update peut prendre les options supplémentaires suivantes. Les options --clear-* vident les champs au lieu de les mettre à jour. delete ne prend que --id.
Ce sont des déclencheurs basés sur les journaux, construits à partir des lignes de journal. Pour les déclencheurs de Anomaly detection sur les métriques, voir Déclencheurs.

Prochaines étapes

Vous avez trouvé quelque chose dans les journaux ? Ouvrez les incidents associés, ou configurez des déclencheurs de Anomaly detection.