# keenauth events tail ile olayları izleme

`keenauth events tail`, ortamınızın olay API'sini okur ve her müşteri olayını ortaya çıktığı anda yazdırır; örneğin `user.created`. Olaylar webhook teslimleriyle aynıdır: aynı zarf ve aynı `id`. Entegrasyonunuzun neyi alacağını izlemek veya bir işlemin beklediğiniz olayı üretip üretmediğini kontrol etmek için kullanın. Durdurmak için Ctrl-C tuşlarına basın; komut bunun ardından 0 çıkış koduyla sonlanır.

Komut `events:read` iznini gerektirir. Bir API anahtarı ve bir `keenauth login` oturumu ile çalışır.

## Kullanım

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

| Bayrak | Açıklama |
|---|---|
| `--types` | Yalnızca bu olay türleri; virgülle ayrılmış veya tekrarlanmış olarak verilir. |
| `--org` | Yalnızca bu kuruluşun olayları (`org_…`). |
| `--payload` | `thin` (varsayılan) veya `full`. `full` kaynağı da içerir ve `users:read` iznini de gerektirir. |
| `--after` | Nereden başlanacağı: `latest` (varsayılan) yalnızca şu andan sonra gerçekleşen olayları yazdırır; önceki bir çalıştırmada yazdırılan bir imleç ise oradan devam eder. |
| `--interval` | Yeni olay yokken iki kontrol arasındaki süre; `1s` ile `60s` arasında. Varsayılan: `5s`. |
| `--output`, `-o` | `table`, `json` veya `yaml`. Bayrak verilmezse CLI, terminalde tablo, aksi halde JSON yazdırır. |

Geçersiz bir filtre, imleç veya aralık, herhangi bir istek gönderilmeden komutu 2 çıkış koduyla durdurur.

## Çıktı

- `table`: her olay için zaman, tür, sıra numarası ve olay kimliğini içeren bir satır.
- `json`: her olay, sunucunun gönderdiği biçimde, satır başına bir JSON nesnesi olarak (satırla ayrılmış JSON). Standart çıktı bir terminal değilse varsayılan budur.
- `yaml`: her olay için, `---` ile başlayan bir YAML belgesi.

Olaylar ortamın olay sırasıyla (`seq`) yazdırılır. Komutu durdurduğunuzda, devam edilecek imleci standart hataya yazdırır:

```text
to continue from here: --after <cursor>
```

Aradan kaçırdığınız olayları yazdırmak için daha sonra `keenauth events tail --after <cursor>` komutunu çalıştırın. Olaylar 30 gün saklanır.

## Nasıl takip eder

Komut, imlecinden sonraki olayları ister, bunları yazdırır ve imleci yanıtın döndürdüğü olaya taşır. Yanıt bekleyen daha fazla olay olduğunu belirtirse hemen yeniden ister; aksi halde `--interval` kadar bekler ve yeniden ister.

## Çıkış kodları

| Kod | Anlamı |
|---|---|
| `0` | Ctrl-C ile durduruldu. |
| `1` | Sunucu hatası ya da ağ hatası; örneğin başka bir ortamın imleci. |
| `2` | Kullanım hatası: geçersiz filtre, imleç, aralık veya çıktı biçimi. Hiçbir istek gönderilmedi. |
| `3` | Kimlik bilgisi eksik ya da sunucu `401` veya `403` yanıtı verdi. |
| `4` | Plan bu özelliği içermiyor (`plan_feature_unavailable` ile `403`). |