LogBrew CLI referansı: komutlar ve filtreler

Açık kaynak LogBrew CLI terminalden telemetri okur ve hesap verilerini yönetir. Kurulum, giriş ve sık yapılan işler için CLI rehberiyle başlayın.

CLI nasıl çalışır?

Terminalde okunabilir metin kullanın. Betiklerde ve kodlama asistanlarında --json kullanın. Hesap okumaları için hesap girişi gerekir. Girişi başlatmadan önce logbrew status --json komutunu çalıştırın. Tarayıcıdaki yetkilendirmeyi bir kişinin tamamlaması gerekir. Proje alım anahtarları (ingest key) telemetri gönderir. Hesap girişinin yerini tutamaz. Proje oluşturma, anahtar oluşturma, sorun durumu, öncelik ve sorumlu değişiklikleri, dağıtımlar ve destek güncellemeleri hesap verilerini değiştirir. Bunlardan birini çalıştırmadan önce aksiyonun ve hedefin doğru olduğundan emin olun. Tüm komutları görmek için logbrew --help çalıştırın. Bir komutun seçeneklerini görmek için ona --help ekleyin, örneğin logbrew read logs --help. JSON kuralları için logbrew help json çalıştırın.

Komut ailesi	Amaç
`login`, `whoami`, `me`, `logout`	Girişi başlatın, hesap kimliğini okuyun veya yerel oturumu kapatın.
`status`, `health`, `doctor`, `version`, `examples`	Erişimi, proje hazırlığını, CLI sürümünü veya ilk kullanım örneklerini okuyun.
`setup`	Yerel manifestleri okuyun ve bir SDK kurulum planı yazdırın. Dosyaları değiştirmez ve kurulum komutunu çalıştırmaz.
`projects`	Etkin proje kataloğunu okuyun.
`projects repositories`	Bağlı depoları okuyun veya bir depodaki bileşenleri bulun.
`projects create`, `projects keys create`	Bir proje oluşturun veya var olan bir proje için alım anahtarı oluşturun.
`projects setup`	Var olan bir proje için gözlemlenen kurulumu kaydedin.
`projects archive`, `projects delete`	Bir projeyi arşivleyin veya onaydan sonra kalıcı olarak silin.
`usage`, `account usage`	Kullanımı, sınırları, kota durumunu ve sıfırlanma tarihlerini okuyun.
`mcp grants`, `mcp revoke`	Hesabınıza bağlı MCP istemcilerini adlarıyla listeleyin veya bir bağlantıyı iptal edin.
`read`	Logları, sorunları, aksiyonları, sürümleri, metrikleri, izleri veya tek bir öğeyi okuyun.
`explain`	Bir sorun, log, aksiyon, iz, span, metrik veya sürüm için sınırlı kanıtı okuyun.
`investigate issue`	Sorun inceleme kanıtını okuyun veya aday bir dağıtımı doğrulayın.
`issues archive`, `issues resolve`, `issues reopen`	1 sorunun veya bir projedeki en fazla 100 sorunun durumunu ayarlayın.
`issues priority`	1 sorunun veya bir projedeki en fazla 100 sorunun önceliğini ayarlayın.
`issues assign`, `issues unassign`	1 sorunun veya bir projedeki en fazla 100 sorunun sorumlusunu (bir hesap ya da ekip) ayarlayın veya kaldırın.
`issues assignees`	Bir projede sorun atanabilecek hesapları ve ekipleri listeleyin.
`issues owners`	1 sorunun önerilen sahiplerini listeleyin.
`issues ownership`	Bir projenin sahiplik kurallarını ve CODEOWNERS dosyasını okuyun veya ayarlayın.
`issues activity`	1 sorunun değişiklik geçmişini okuyun.
`issues rule`, `logs rule`	1 sorunun veya 1 log imzasının önem düzeyi kuralını ayarlayın.
`inbox`	Başkalarının size veya ekiplerinize atadığı sorunları okuyun ya da okundu olarak işaretleyin.
`set issue`, `resolve`, `close`, `ignore`, `reopen`	1 sorunun durumunu ayarlayın. `close`, `resolved` anlamına gelir. `ignore` ve `ignored`, `archived` anlamına gelir.
`deploy`	Tamamlanmış tek bir dağıtımı kaydedin.
`debug-artifacts`	Apple veya Android native hata ayıklama dosyalarını yükleyin ya da tek bir görüntü (image) kimliğini arayın.
`analytics`	Genel bakışı, özellikleri, karşılaştırmaları, yolları, dönüşüm hunilerini, elde tutmayı veya yaşam döngüsünü okuyun.
`support`	Destek talepleri oluşturun, okuyun, yanıtlayın, kapatın veya yeniden açın.
`watch`	Canlı logları, sorunları veya aksiyonları akış olarak alın.

Proje doctor raporunu okuyun

logbrew projects --json çıktısındaki bir proje kimliğini kullanın:

logbrew doctor --project "<project_id>" --json

Komut proje durumunu ve son bir logu okur. Proje oluşturmaz, anahtarı değiştirmez ve kurulum kaydetmez. Rapor status, checks ve next alanlarını içerir. Her kontrol check, status ve next alanlarını içerir. Kontroller api, auth, project, ingest_key, setup, telemetry ve logs olur. 0 çıkış kodu, CLI’ın bir rapor yazdığı anlamına gelir. Projenin hazır olduğu anlamına gelmez. Raporun status değerini ve her kontrolü okuyun. not_checked durumundaki bir kontrol geçmemiştir.

Rapor `status` değeri	Anlamı ve sonraki adım
`auth_invalid`	Hesap erişimi eksik veya geçersiz. Bir kişi `logbrew login` çalıştırır.
`project_missing`	Bu hesap projeye erişemiyor. `logbrew projects --json` çıktısındaki bir kimliği kullanın.
`api_unreachable`	API isteği tamamlanmadı. Ağ bağlantısını inceleyin, ardından komutu yeniden çalıştırın.
`check_failed`	Bir istek başarısız oldu veya yanıtı geçersizdi. Komutu değiştirmeden yeniden çalıştırın. Yine başarısız olursa sorun bildirin.
`needs_ingest_key`	Projenin etkin bir alım anahtarı yok. Anahtarı yalnızca projeyi değiştirme izniniz varsa oluşturun.
`needs_setup`	SDK kurulumu gerekli. Hızlı başlangıç adımlarını izleyin.
`needs_telemetry`	Kurulum başladı, ama LogBrew’de proje için telemetri yok. Bir test olayı gönderin.
`ready`	Projenin etkin bir anahtarı ve telemetrisi var. Göreviniz için gereken sinyali okuyun.

Proje okuması başarılı olduğunda logs kontrolü visible, empty, unavailable, error veya invalid_response olur. Bu kontrol raporun status değerini değiştirmez. Boş bir log sonucu diğer sinyaller hakkında bilgi vermez. Başarısız bir okuma boş bir sonuç değildir. next değerini kurtarma yönlendirmesi olarak kullanın. Bu değer hesap veya proje durumunu değiştirme izni vermez.

Örnek: hesap erişimi eksik

Hesap kimlik bilgileri olmadan komut API isteği yapmaz. Bu raporu standart çıktıya yazar ve 0 koduyla çıkar:

{
  "checks": [
    { "check": "api", "next": "run the API reachability check first", "status": "not_checked" },
    { "check": "auth", "next": "run logbrew login", "status": "missing" },
    { "check": "project", "next": "resolve the prior check first", "status": "not_checked" },
    { "check": "ingest_key", "next": "resolve the prior check first", "status": "not_checked" },
    { "check": "setup", "next": "resolve the prior check first", "status": "not_checked" },
    { "check": "telemetry", "next": "resolve the prior check first", "status": "not_checked" },
    { "check": "logs", "next": "resolve the prior check first", "status": "not_checked" }
  ],
  "next": "run logbrew login",
  "status": "auth_invalid"
}

Bu rapor proje API teşhisinden farklıdır. state, setup_status veya next_action API alanlarını içermez.

Filtreler

Filtre	Komutlar
`--project <project_id>`	logs, issues, actions, releases, metrics, traces, trace
`--release <release>`	logs, issues, actions, releases, metrics, traces, trace
`--environment <environment>`	logs, issues, actions, releases, metrics, traces, trace
`--service <service_name>`	logs, issues, actions, releases, metrics, traces
`--since 24h`	logs, issues, actions, releases, metrics, traces, analytics
`--until <RFC3339>`	logs, issues, actions, releases, metrics, traces, analytics
`--limit 100`	logs, issues, actions, releases, metrics, traces
`--severity error`	logs, watch
`--search checkout`	logs
`--trace <trace_id>`	logs
`--status unresolved`	issues (`unresolved`, `resolved`, `archived`)
`--priority high`	issues (`high`, `medium`, `low`)
`--assignee me`	issues (`me`, `none`, `my_teams`, bir kullanıcı kimliği veya `team:<team_id>`)
`--status error`	traces (`error`, `ok`)
`--min-duration-ms <milliseconds>`	traces
`--name <name>`	actions, metrics
`--user <distinct_id>`	actions

--since, 24h veya 7d gibi bir süre ya da bir RFC 3339 zaman damgası kabul eder. --until bir RFC 3339 zaman damgası kabul eder. Bu, aralığa dâhil olmayan bir bitiş zamanıdır ve --since değerinden sonra olmalıdır. Kimlikle okunan tek bir sorun --until kabul etmez. Log önem düzeyi info, warning, error veya critical olur. Sorun durumu, sorunun önem düzeyi değil, iş akışındaki durumudur. --status ignored, --status archived için eski bir addır. --status open, unresolved; --status closed ise resolved anlamına gelir. --assignee none, sorumlusu olmayan sorunları; --assignee my_teams ise ekiplerinizin sorunlarını seçer. Başka bir --assignee değeri invalid_assignee ile başarısız olur. CLI şu takma adları da kabul eder: --project-id, --env, --service-name, --trace-id, --distinct-id ve --severity için --level. Yeni betiklerde tablodaki adları kullanın. Bu komut 1 günlük hataları okur:

logbrew read logs --severity error \
  --since 2026-10-01T00:00:00Z --until 2026-10-02T00:00:00Z --json

Proje kimliği projeyi seçer. Hizmet adı o projedeki bir bileşeni seçer. Boşluk içeren değerleri tırnak içine alın:

logbrew read logs --project "<project_id>" \
  --service checkout-api --since 24h \
  --severity error --search "checkout failed" --json

Kısa çizgiyle başlayan arama metni için metnin önüne -- koyun:

logbrew logs --json -- --timeout

Bir sorun oluşumu seçin

Bir sorun eşleşen oluşumları gruplar. Sorunun durumu, oluşum sayısı, ilk görülme ve son görülme zamanları için sorunu okuyun:

logbrew read issue "<issue_id>" --json

Tek bir oluşumdan kanıt almak için explain issue veya investigate issue kullanın. --occurrence olmadan LogBrew önerilen oluşumu seçer. Bu her zaman en son olay değildir. En son olayı okumak için:

logbrew explain issue "<issue_id>" --occurrence latest --json

--occurrence; recommended, first veya LogBrew’ün döndürdüğü bir oluşum kimliğini de kabul eder. Bu komutlar proje, sürüm, ortam ve zaman filtrelerini reddeder. Kanıtları karşılaştırmadan önce seçilen oluşumun zaman damgasını okuyun. Kanıt alanları için Bir sorunu inceleyin rehberine bakın.

Sorun durumunu ve önceliğini değiştirin

1 sorunu değiştirmek için 1 sorun kimliği kullanın:

logbrew issues archive "<issue_id>" --json
logbrew issues priority high "<issue_id>" --json

archive durumu archived, resolve durumu resolved, reopen ise durumu unresolved yapar. Öncelik high, medium veya low olur. Ayarladığınız öncelik sabit kalır. Aksi hâlde öncelik sorunun önem düzeyini izler. 1’den fazla sorunu değiştirmek için --project ekleyin. Tüm sorunlar o projede olmalıdır. Tek bir komut en fazla 100 sorunu değiştirir:

logbrew issues resolve "<issue_id_1>" "<issue_id_2>" \
  --project "<project_id>" --json

Sonuç her sorun için 1 girdi içerir. Her girdi updated, unchanged veya not_found olur. unchanged bir sorun istenen değere zaten sahipti. Bir ağ hatasından sonra aynı komutu yeniden çalıştırabilirsiniz. Bu komutlar onay istemez. Önce sorun kimliklerini kontrol edin. Sorun okumaları ve değişiklikleri ignored yerine archived gösterir. Ayrıca her sorunun priority, priority_source ve assignee değerlerini gösterir. Sorun yanıtı bölümüne bakın.

Sorun atayın

Bir sorunun 0 veya 1 sorumlusu olur: bir hesap ya da bir ekip. Bir projede atayabileceğiniz hesapları ve ekipleri listeleyin:

logbrew issues assignees --project "<project_id>" --json

1 sorunu bir hesaba, me ile kendinize veya bir ekibe atayın:

logbrew issues assign "<user_id>" "<issue_id>" --json
logbrew issues assign me "<issue_id>" --json
logbrew issues assign "team:<team_id>" "<issue_id>" --json

Sorumluyu kaldırın:

logbrew issues unassign "<issue_id>" --json

Durum ve öncelikte olduğu gibi, o projenin en fazla 100 sorununu değiştirmek için --project ekleyin. Hesap projeyi okuyabilmeli, ekip de projenin organizasyonunda olmalıdır. Size veya ekiplerinize atanan sorunları bulmak için:

logbrew read issues --project "<project_id>" --assignee my_teams \
  --status unresolved --json

Metin çıktısı sorumlunun adını, ekipler için de team #<slug> gösterir. Hesabın adı yoksa e-posta adresini, o da yoksa kullanıcı kimliğini gösterir. Sorumlusu olmayan bir sorun unassigned gösterir.

Sahipler, geçmiş ve gelen kutusu

logbrew issues owners "<issue_id>" --json
logbrew issues ownership --project "<project_id>" --json
logbrew issues ownership set --project "<project_id>" \
  --rules ownership.txt --codeowners .github/CODEOWNERS --json
logbrew issues activity "<issue_id>" --limit 50 --json
logbrew inbox --json
logbrew inbox read --json

issues owners, önerilen sahipleri ve kontrol ettiği kanıtı listeler. issues ownership set, her biri en fazla 128 KiB olan yerel dosyaları gönderir. Boş bir dosya, o dosyanın metnini temizler. issues activity ve inbox, 1 ile 200 arasında --limit ve next_cursor içinden gelen --cursor-time ile --cursor-id değerlerini alır. Sorunun sahibini bulun bölümüne bakın.

Önem düzeyi kurallarını ayarlayın

logbrew issues rule "<issue_id>" warning --json
logbrew logs rule "<log_id>" info --ignore --json

Önem düzeyi info, warning, error, critical veya source olur. source, yakalanan önem düzeyini yeniden gösterir. --ignore, eşleşen logları varsayılan log listesinde gizler. --ignore olmadan kural onları gösterir.

Sonraki sayfayı okuyun

Loglar, sorunlar, aksiyonlar, metrikler ve izler cursor ile sayfalamayı kabul eder. Sürümler kabul etmez. İlk sayfa için --pagination cursor kullanın:

logbrew read logs --project "<project_id>" --since 24h \
  --pagination cursor --limit 100 --json

Yanıt logs ve next_cursor alanlarını içerir. Null olmayan bir next_cursor, time ve id içerir. Bunları --cursor-time ve --cursor-id ile gönderin:

logbrew read logs --project "<project_id>" --since 24h \
  --pagination cursor --limit 100 \
  --cursor-time "<returned_time>" \
  --cursor-id "<returned_id>" --json

Her sayfada aynı filtreleri ve sınırı koruyun. next_cursor değeri null olduğunda durun. Başka sayfa olup olmadığına satır sayısıyla değil, cursor ile karar verin. Son sayfa boş olabilir:

{
  "logs": [],
  "next_cursor": null
}

Sorunlar, aksiyonlar ve metrikler aynı yapıyı kullanır. Yalnızca logs yerine issues, actions veya metrics bulunur.

Canlı izleme

logbrew watch --json; canlı logları, sorunları ve aksiyonları akış olarak alır. Tek bir türü almak için logs, issues veya actions ekleyin. tail, follow ve stream, watch için takma adlardır. Watch izleri veya span’leri desteklemez. Watch için --json gerekir. Bu seçenek olmadan komut watch streams JSON for agents yazar ve 1 koduyla çıkar. Watch sorun olayları arşivlenmiş bir sorunu öncelik olmadan ignored olarak gösterir. Güncel durumunu ve önceliğini almak için sorunu okuyun. Watch yalnızca --severity error,critical gibi --severity kabul eder. logbrew watch actions, --severity kabul etmez. CLI bu filtreyi olayları aldıktan sonra uygular. Sunucunun gönderdiği veriyi azaltmaz. Watch’ta proje, sürüm, ortam veya zaman filtresi yoktur. Bu filtreler için bir read komutu kullanın. Geçici bir bağlantı kopmasından sonra CLI bekler ve yeniden bağlanır.

Sonuçları ve hataları okuyun

--json seçeneğini komuttan önce veya sonra yazın. Çıktıyı kullanmadan önce çıkış kodunu okuyun. İnsanlar için yazılmış çıktıyı ayrıştırmayın. Bu çıktı sürümler arasında değişebilir.

Çıkış kodu	Anlamı
`0`	Başarılı. JSON standart çıktıdadır.
`1`	Komut çalışırken başarısız oldu, örneğin bir API veya ağ hatası.
`2`	CLI komutu çalıştırmadan önce reddetti.

Başarılı çıktı API yanıtının yapısını korur. Bir dizi veya bir nesne olabilir. Cursor ile sayfalama olmadan bir log okuması dizi döndürür. Boş bir dizi hiçbir logun eşleşmediği anlamına gelir. Bu bir hata değildir. Hatalar standart hataya gider. İstisna debug-artifacts --json komutudur. Bu komut hataları standart çıktıya yazar. JSON hatası ok, error, message ve next alanlarını içerir. Sabit hata kodu olarak error değerini kullanın. Önerdiği komutu çalıştırmadan önce next değerini inceleyin. Örneğin logbrew watch traces --json 2 koduyla çıkar ve şunu yazar:

{
  "ok": false,
  "error": "unknown_resource",
  "message": "unknown resource: traces",
  "next": "use logbrew traces for recent traces, or logbrew trace <trace_id> for one trace"
}

logbrew read logs --limit 0 --json 2 koduyla çıkar ve şunu yazar:

{
  "ok": false,
  "error": "invalid_limit",
  "message": "invalid limit: 0",
  "next": "use --limit with a positive whole number"
}

Değeri düzeltin ve komutu yeniden çalıştırın. Reddedilen bir komut boş bir sonuç değildir. HTTP hataları için API hataları, doğrudan API istekleri için Telemetri API’si sayfasına bakın.

​CLI nasıl çalışır?

​Proje doctor raporunu okuyun

​Örnek: hesap erişimi eksik

​Filtreler

​Bir sorun oluşumu seçin

​Sorun durumunu ve önceliğini değiştirin

​Sorun atayın

​Sahipler, geçmiş ve gelen kutusu

​Önem düzeyi kurallarını ayarlayın

​Sonraki sayfayı okuyun

​Canlı izleme

​Sonuçları ve hataları okuyun