
# keenauth logs tail ile günlükleri izleme

`keenauth logs tail`, çalışırken ortam günlüklerini (oturum açmalar, oturumlar, belirteçler, MFA, saldırı koruması) `tail -f` gibi izler. Önce en son kayıtları yazdırır; en eskiden en yeniye doğru sıralar. Ardından belirli aralıklarla yeni kayıtları kontrol eder ve göründükçe yazdırır. Durdurmak için Ctrl-C tuşlarına basın; komut bu durumda 0 çıkış koduyla sonlanır.

Komut, `keenauth logs list` ile aynı kayıtları okur ve aynı izni (`logs:read`) gerektirir. Bir API anahtarı ve bir `keenauth login` oturumu ile çalışır.

## Kullanım

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

| Bayrak | Açıklama |
|---|---|
| `--type` | Günlük türü öneki, örneğin `authentication.` veya `session.created`. Virgülle ayrılabilir ya da tekrarlanabilir; en fazla 20 tane. Bunlardan herhangi biriyle eşleşen bir kayıt gösterilir. |
| `--user` | Yalnızca bu kullanıcıya ait kayıtlar (`usr_…`). |
| `--org` | Yalnızca bu kuruluşa ait kayıtlar (`org_…`). |
| `--limit` | İzlemeden önce yazdırılan en son kayıt sayısı, 1 ile 100 arası. Varsayılan: 20. |
| `--interval` | İki kontrol arasındaki süre, `1s` ile `60s` arası. Varsayılan: `5s`. |
| `--output`, `-o` | `table`, `json` veya `yaml`. Bayrak verilmezse CLI, terminalde tablo, aksi halde JSON yazdırır. |

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

## Çıktı

- `table`: Her kayıt için bir satır; saat (UTC), tür, sonuç, kullanıcı, kuruluş ve günlük kimliği. Eksik bir değer `-` olarak gösterilir.
- `json`: Her satırda bir JSON nesnesi (satırlarla ayrılmış JSON). `keenauth logs get` komutunun döndürdüğü nesnenin aynısıdır. Standart çıktı bir terminal değilse varsayılan budur; böylece çıktıyı örneğin `jq`'ya yönlendirebilirsiniz.
- `yaml`: Her kayıt için, `---` ile başlayan bir YAML belgesi.

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

IP adresi, kullanıcı aracısı ve tanımlayıcı ipucu, yalnızca kimlik bilgileriniz [günlükler API'si](/docs/api/management/logs/list) bölümünde açıklanan izinlere sahipse görünür.

## Nasıl izler

Günlükler API'si en yeni kayıtları önce döndürür ve bekleme parametresi yoktur; bu nedenle komut periyodik sorgulama (polling) yapar. İlk sayfadan sonra her kontrol, yazdırdığı en yeni zamanda veya bundan sonraki kayıtları ister ve daha önce yazdırdığı kayıtları atlar; böylece hiçbir kayıt iki kez gösterilmez. Her kontrol, tüm yeni kayıtları alana kadar sonuç sayfalarını takip eder; kontrol başına en fazla 2.000 kayıt. Planınızın saklama süresinin dışındaki kayıtlar döndürülmez.

## Çıkış kodları

| Kod | Anlamı |
|---|---|
| `0` | Ctrl-C ile durduruldu. |
| `1` | Sunucu hatası veya ağ hatası. |
| `2` | Kullanım hatası: geçersiz filtre, sınır, aralık veya çıktı biçimi. İstek 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`). |
