Seguire gli eventi con keenauth events tail

keenauth events tail legge l'API degli eventi del tuo ambiente e stampa ogni evento del cliente non appena compare, per esempio user.created. Gli eventi sono gli stessi delle consegne dei webhook: stessa envelope e stesso id. Usalo per osservare ciò che riceverà la tua integrazione, oppure per verificare che un'azione abbia prodotto l'evento atteso. Premi Ctrl-C per fermarlo; il comando esce poi con codice 0.

Il comando richiede il permesso events:read. Funziona con una chiave API e con una sessione di keenauth login.

Utilizzo

keenauth events tail --types user.created,user.updated

Flag	Descrizione
`--types`	Solo questi tipi di evento, separati da virgole o ripetuti.
`--org`	Solo gli eventi di questa organizzazione (`org_…`).
`--payload`	`thin` (predefinito) o `full`. `full` include la risorsa e richiede anche il permesso `users:read`.
`--after`	Da dove iniziare: `latest` (predefinito) stampa solo gli eventi che avvengono da ora in poi; un cursore stampato da un'esecuzione precedente continua da quel punto.
`--interval`	Tempo tra due controlli quando non ci sono nuovi eventi, da `1s` a `60s`. Predefinito: `5s`.
`--output`, `-o`	`table`, `json` o `yaml`. Senza il flag la CLI stampa una tabella su un terminale e JSON altrimenti.

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

Output

table: una riga per evento con l'orario, il tipo, il numero di sequenza e l'ID dell'evento.
json: ogni evento esattamente come l'ha inviato il server, un oggetto JSON per riga (JSON delimitato da newline). Questo è il valore predefinito quando stdout non è un terminale.
yaml: un documento YAML per evento, ciascuno che inizia con ---.

Gli eventi vengono stampati nell'ordine degli eventi dell'ambiente (seq). Quando fermi il comando, stampa su stderr il cursore da cui continuare:

to continue from here: --after <cursor>

Esegui più tardi keenauth events tail --after <cursor> per stampare gli eventi che hai perso nel frattempo. Gli eventi vengono conservati per 30 giorni.

Come segue gli eventi

Il comando chiede gli eventi successivi al proprio cursore, li stampa e sposta il cursore su quello restituito dalla risposta. Quando la risposta indica che ci sono altri eventi in attesa, chiede di nuovo subito; altrimenti attende --interval e chiede di nuovo.

Codici di uscita

Codice	Significato
`0`	Fermato con Ctrl-C.
`1`	Un errore del server o un errore di rete, per esempio un cursore di un altro ambiente.
`2`	Errore di utilizzo: un filtro, un cursore, un intervallo o un formato di output non validi. Non è stata inviata alcuna richiesta.
`3`	La credenziale manca, oppure il server ha risposto `401` o `403`.
`4`	Il piano non include la funzionalità (`403` con `plan_feature_unavailable`).