> ## Documentation Index > Fetch the complete documentation index at: https://docs.logbrew.co/llms.txt > Use this file to discover all available pages before exploring further. # LogBrew CLI referansı: komutlar ve filtreler > LogBrew komutlarını, filtreleri, cursor ile sayfalamayı, canlı izlemeyi, JSON çıktısını ve hataları bulun. [Açık kaynak LogBrew CLI](https://github.com/LogBrewCo/cli) terminalden telemetri okur ve hesap verilerini yönetir. Kurulum, giriş ve sık yapılan işler için [CLI rehberiyle](/tr/guides/cli) 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: ```bash theme={null} logbrew doctor --project "" --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](/tr/guides/report-a-problem). | | `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ıç](/tr/quickstart) 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: ```json theme={null} { "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](/tr/concepts/projects#diagnose-project-setup) farklıdır. `state`, `setup_status` veya `next_action` API alanlarını içermez. ## Filtreler | Filtre | Komutlar | | - | - | | `--project ` | logs, issues, actions, releases, metrics, traces, trace | | `--release ` | logs, issues, actions, releases, metrics, traces, trace | | `--environment ` | logs, issues, actions, releases, metrics, traces, trace | | `--service ` | logs, issues, actions, releases, metrics, traces | | `--since 24h` | logs, issues, actions, releases, metrics, traces, analytics | | `--until ` | logs, issues, actions, releases, metrics, traces, analytics | | `--limit 100` | logs, issues, actions, releases, metrics, traces | | `--severity error` | logs, watch | | `--search checkout` | logs | | `--trace ` | 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:`) | | `--status error` | traces (`error`, `ok`) | | `--min-duration-ms ` | traces | | `--name ` | actions, metrics | | `--user ` | 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: ```bash theme={null} 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: ```bash theme={null} logbrew read logs --project "" \ --service checkout-api --since 24h \ --severity error --search "checkout failed" --json ``` Kısa çizgiyle başlayan arama metni için metnin önüne `--` koyun: ```bash theme={null} 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: ```bash theme={null} logbrew read issue "" --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: ```bash theme={null} logbrew explain issue "" --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](/tr/guides/investigate-an-issue) rehberine bakın. ## Sorun durumunu ve önceliğini değiştirin 1 sorunu değiştirmek için 1 sorun kimliği kullanın: ```bash theme={null} logbrew issues archive "" --json logbrew issues priority high "" --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: ```bash theme={null} logbrew issues resolve "" "" \ --project "" --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ı](/tr/reference/telemetry-response-shapes#issue-response) 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: ```bash theme={null} logbrew issues assignees --project "" --json ``` 1 sorunu bir hesaba, `me` ile kendinize veya bir ekibe atayın: ```bash theme={null} logbrew issues assign "" "" --json logbrew issues assign me "" --json logbrew issues assign "team:" "" --json ``` Sorumluyu kaldırın: ```bash theme={null} logbrew issues unassign "" --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: ```bash theme={null} logbrew read issues --project "" --assignee my_teams \ --status unresolved --json ``` Metin çıktısı sorumlunun adını, ekipler için de `team #` 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 ```bash theme={null} logbrew issues owners "" --json logbrew issues ownership --project "" --json logbrew issues ownership set --project "" \ --rules ownership.txt --codeowners .github/CODEOWNERS --json logbrew issues activity "" --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](/tr/guides/issue-workflow#find-who-owns-an-issue) bölümüne bakın. ## Önem düzeyi kurallarını ayarlayın ```bash theme={null} logbrew issues rule "" warning --json logbrew logs rule "" 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: ```bash theme={null} logbrew read logs --project "" --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: ```bash theme={null} logbrew read logs --project "" --since 24h \ --pagination cursor --limit 100 \ --cursor-time "" \ --cursor-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: ```json theme={null} { "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: ```json theme={null} { "ok": false, "error": "unknown_resource", "message": "unknown resource: traces", "next": "use logbrew traces for recent traces, or logbrew trace for one trace" } ``` `logbrew read logs --limit 0 --json` `2` koduyla çıkar ve şunu yazar: ```json theme={null} { "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ı](/tr/reference/api-errors), doğrudan API istekleri için [Telemetri API'si](/tr/reference/telemetry-api) sayfasına bakın. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.