Suivre les journaux avec keenauth logs tail

keenauth logs tail suit les journaux de l'environnement (connexions, sessions, jetons, MFA, protection contre les attaques) pendant que vous travaillez, à la manière de tail -f. Il affiche d'abord les enregistrements les plus récents, du plus ancien au plus récent, puis vérifie à intervalle fixe s'il existe de nouveaux enregistrements et les affiche dès qu'ils apparaissent. Appuyez sur Ctrl-C pour arrêter ; la commande se termine alors avec le code 0.

La commande lit les mêmes enregistrements que keenauth logs list et nécessite la même autorisation (logs:read). Elle fonctionne avec une clé d'API et avec une session keenauth login.

Utilisation

keenauth logs tail --type authentication. --user usr_01j9z3k4m5n6p7q8r9s0t1v2w3

Option	Description
`--type`	Préfixe du type de journal, par exemple `authentication.` ou `session.created`. Valeurs séparées par des virgules ou répétées, 20 au maximum ; un enregistrement correspondant à l'une d'elles est affiché.
`--user`	Uniquement les enregistrements de cet utilisateur (`usr_…`).
`--org`	Uniquement les enregistrements de cette organisation (`org_…`).
`--limit`	Nombre d'enregistrements récents affichés avant le suivi, de 1 à 100. Par défaut : 20.
`--interval`	Durée entre deux vérifications, de `1s` à `60s`. Par défaut : `5s`.
`--output`, `-o`	`table`, `json` ou `yaml`. Sans cette option, la CLI affiche un tableau dans un terminal et du JSON sinon.

Un filtre ou un intervalle invalide arrête la commande avec le code 2, avant l'envoi de toute requête.

Sortie

table : une ligne par enregistrement, avec l'heure (UTC), le type, le résultat, l'utilisateur, l'organisation et l'identifiant du journal ; une valeur absente est affichée -.
json : un objet JSON par ligne (JSON délimité par des retours à la ligne), identique à l'objet renvoyé par keenauth logs get. C'est la valeur par défaut lorsque la sortie standard n'est pas un terminal, ce qui permet de la rediriger, par exemple vers jq.
yaml : un document YAML par enregistrement, commençant chacun par ---.

keenauth logs tail --type authentication.failed -o json | jq -r '.ip_country'

L'adresse IP, l'agent utilisateur et l'indice d'identifiant n'apparaissent que si vos identifiants disposent des autorisations décrites dans l'API des journaux.

Fonctionnement du suivi

L'API des journaux renvoie les enregistrements les plus récents en premier et ne dispose d'aucun paramètre d'attente : la commande procède donc par interrogations répétées. Après la première page, chaque vérification demande les enregistrements postérieurs ou égaux à l'heure la plus récente déjà affichée et ignore ceux déjà affichés, de sorte qu'aucun enregistrement n'apparaît deux fois. Une vérification parcourt les pages de résultats jusqu'à obtenir tous les nouveaux enregistrements, dans la limite de 2 000 enregistrements par vérification. Les enregistrements plus anciens que la période de conservation de votre offre ne sont pas renvoyés.

Codes de sortie

Code	Signification
`0`	Arrêt avec Ctrl-C.
`1`	Une erreur serveur ou une défaillance réseau.
`2`	Erreur d'utilisation : un filtre, une limite, un intervalle ou un format de sortie invalide. Aucune requête n'a été envoyée.
`3`	Les identifiants sont absents, ou le serveur a répondu `401` ou `403`.
`4`	L'offre n'inclut pas cette fonctionnalité (`403` avec `plan_feature_unavailable`).