# 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

```sh
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:

```text
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`). |