Seguire i log con keenauth logs tail

keenauth logs tail segue i log dell'ambiente (accessi, sessioni, token, MFA, protezione dagli attacchi) mentre lavori, come tail -f. Stampa per primi i record più recenti, dal più vecchio al più recente, poi controlla a intervalli fissi la presenza di nuovi record e li stampa non appena compaiono. Premi Ctrl-C per fermarlo; il comando termina quindi con codice 0.

Il comando legge gli stessi record di keenauth logs list e richiede la stessa autorizzazione (logs:read). Funziona con una chiave API e con una sessione keenauth login.

Utilizzo

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

Un filtro o un intervallo non validi interrompono il comando con codice 2 prima che venga inviata qualsiasi richiesta.

Output

• table: una riga per record con l'orario (UTC), il tipo, l'esito, l'utente, l'organizzazione e l'ID del log; un valore mancante viene mostrato come -.
• json: un oggetto JSON per riga (JSON delimitato da newline), lo stesso oggetto restituito da keenauth logs get. È il valore predefinito quando stdout non è un terminale, così puoi inviarlo in pipe, per esempio a jq.
• yaml: un documento YAML per record, ciascuno che inizia con ---.

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

L'indirizzo IP, l'agente utente e il suggerimento sull'identificatore compaiono solo se la tua credenziale ha le autorizzazioni descritte in l'API dei log.

Come segue i log

L'API dei log restituisce per primi i record più recenti e non ha un parametro di attesa, quindi il comando esegue un polling. Dopo la prima pagina, ogni controllo richiede i record a partire dal momento più recente stampato e salta quelli già stampati, così nessun record viene mostrato due volte. Un controllo segue le pagine di risultati finché non ha tutti i nuovi record, fino a 2.000 record per controllo. I record più vecchi della finestra di conservazione del tuo piano non vengono restituiti.

Codici di uscita