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

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.

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