# LogBrew dokümantasyonu Uygulama veya framework seçin, Add Project içinde proje oluşturun ve CLI ile dashboard referanslarına geçmeden önce ilk sinyali doğrulayın. # Platform seçin Projeye uyan uygulama veya framework ile başla. Add Project içinde de aynı seçimi kullan. ## Node.js servisi Backend servisi log, request span, action, release ve metric gönderecekse Node.js paketini kullan. ```bash npm install @logbrew/sdk @logbrew/node ``` Next: Node ilk sinyal yolunu kullan ## Express servisi Node servisi requestleri Express middleware ile işliyorsa Express paketini kullan. ```bash npm install @logbrew/sdk @logbrew/express express ``` Next: Add Project’i aç ## Fastify servisi Node servisi route’ları Fastify pluginleriyle işliyorsa Fastify paketini kullan. ```bash npm install @logbrew/sdk @logbrew/fastify fastify ``` Next: Add Project’i aç ## JavaScript uygulaması Frontend sayfaları product action, log ve hafif client sinyalleri gönderecekse JavaScript browser paketini kullan. ```bash npm install @logbrew/sdk @logbrew/browser ``` Next: Add Project’i aç ## Next.js uygulaması Route, server rendering ve client action’ların tek setup yolunda birleştiği Next.js uygulamaları için kullan. ```bash npm install @logbrew/sdk @logbrew/next next react react-dom ``` Next: Add Project’i aç ## React uygulaması Kullanıcı action’ları ve UI state gönderen component tabanlı web uygulamaları için React paketini kullan. ```bash npm install @logbrew/sdk @logbrew/react react ``` Next: Add Project’i aç ## Angular uygulaması Framework routing ve app hataları aynı setup yolunda toplanacaksa Angular paketini kullan. ```bash npm install @logbrew/sdk @logbrew/angular @angular/core ``` Next: Add Project’i aç ## Vue uygulaması Net product action ve browser sinyalleri gereken Vue uygulamaları için Vue paketini kullan. ```bash npm install @logbrew/sdk @logbrew/vue vue ``` Next: Add Project’i aç ## Svelte uygulaması Doğrudan SDK kurulum yolu gereken Svelte uygulamaları için Svelte paketini kullan. ```bash npm install @logbrew/sdk @logbrew/svelte svelte ``` Next: Add Project’i aç ## NestJS servisi Node servisi Nest modülleri ve request handling etrafında kurulmuşsa NestJS paketini kullan. ```bash npm install @logbrew/sdk @logbrew/nestjs @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs ``` Next: Add Project’i aç ## Python servisi Python worker ve servisleri için core paketle başla. ```bash python3 -m pip install logbrew-sdk ``` Next: Add Project’i aç ## Django uygulaması Django projesinden request ve app sinyalleri göndermek için Django paketini kullan. ```bash python3 -m pip install logbrew-sdk logbrew-django ``` Next: Add Project’i aç ## FastAPI servisi Explicit request span ve action gönderen Python API’leri için FastAPI paketini kullan. ```bash python3 -m pip install logbrew-sdk logbrew-fastapi ``` Next: Add Project’i aç ## .NET servisi Server-side sinyalleri servis sahipleniyorsa .NET paketini kur. ```bash dotnet add package LogBrew ``` Next: Add Project’i aç ## ASP.NET Core uygulaması .NET istek işleme ve web uygulaması sinyalleri aynı kurulum yolunu kullanacaksa ASP.NET Core paketini kullan. ```bash dotnet add package LogBrew.AspNetCore ``` Next: Add Project’i aç ## Java servisi App-owned log, request span ve product action gereken Java servisleri için JVM paketini kullan. ```bash implementation("co.logbrew:logbrew-sdk:0.1.0") ``` Next: Add Project’i aç ## Go servisi Explicit log, span, metric ve trace context sahibi Go servisleri için Go paketini ekle. ```bash go get github.com/LogBrewCo/sdk/go/logbrew@v0.1.3 ``` Next: Add Project’i aç ## PHP uygulaması PHP servisleri ve app-owned request sinyalleri için Composer kullan. ```bash composer require logbrew/sdk ``` Next: Add Project’i aç ## Ruby servisi Explicit app ve request sinyalleri gereken Ruby servisleri için Ruby gem’ini kullan. ```bash gem install logbrew-sdk ``` Next: Add Project’i aç ## Rust servisi Kendi log, span, action ve metric sinyallerini oluşturan servisler için Rust crate’ini ekle. ```bash cargo add logbrew ``` Next: Add Project’i aç ## iOS uygulaması Explicit product signal gönderen iOS uygulamaları için Apple platform paketini kullan. ```bash .package(url: "https://github.com/LogBrewCo/sdk.git", from: "0.1.1") ``` Next: Add Project’i aç ## Android uygulaması Android runtime’dan app-owned sinyaller gönderen uygulamalar için Android paketini kullan. ```bash implementation("co.logbrew:logbrew-kotlin:0.1.0") ``` Next: Add Project’i aç ## React Native uygulaması JavaScript product action’larını paylaşan mobil uygulamalar için React Native paketini kullan. ```bash npm install @logbrew/sdk @logbrew/react-native react react-native ``` Next: Add Project’i aç ## Unity uygulaması Product action ve runtime sinyalleri gönderen oyunlar veya simülasyonlar için Unity paketini kullan. ```bash "co.logbrew.unity": "file:../Packages/co.logbrew.unity" ``` Next: Add Project’i aç ## C uygulaması Doğrudan sinyal kontrolü gereken native servisler veya embedded uygulamalar için C kaynaklarını kullan. ```bash cc -std=c99 -Wall -Wextra -Wpedantic -Iinclude src/logbrew.c src/logbrew_metric.c src/logbrew_recording_transport.c src/logbrew_timeline.c src/logbrew_trace.c your_app.c -o your_app ``` Next: Add Project’i aç ## C++ uygulaması Yayınlanmış CLI planını CMake 3.16+ ve C++17 projesinde çalıştır. LogBrew::LogBrew hedefine bağlan. LogBrew::HttpTransport ve libcurl'u yalnızca hosted delivery gerektiğinde etkinleştir. ```bash logbrew setup --json ``` Next: Add Project’i aç ## Kurulum yolu özeti Dokümandan doğrulanmış ürün aksiyonuna geçmek için bu sırayı izleyin ve setup akışından çıkmayın. - Kur. Paketi ekle: Kendi runtime ortamınıza uygun SDK paketiyle başlayın. - Oluştur. Proje oluştur: Tek kullanımlık proje kimliği için Add Project panelini açın. - Gönder. Bir ürün aksiyonu gönder: Uygulamaya bağlamadan önce gizli içermeyen bir ürün aksiyonu çalıştırın. - Doğrula. Logları kontrol et: Sinyalin durumunu loglarda veya CLI ile doğrulayın. # İlk başarılı SDK çalıştırması İlk oturumu net tutun: paketi kurun, projeyi oluşturun, gizli veri içermeyen bir ürün aksiyonu gönderin ve LogBrew içinde doğrulayın. ## İlk sinyal kurulumu için gerekenler Doğrudan SDK gönderimi setup yolunu kısa tutar. - Toplayıcı: Yerel agent yok. SDK paketini kurun ve doğrudan LogBrew API'ye gönderin. - Kimlik: Tek proje kimliği. Bunu yalnızca o projeyi oluştururken veya kurarken Add Project içinden kopyalayın. - Kanıt: Loglarda doğrula. Bir info sinyali gönderin, sonra daha geniş enstrümantasyondan önce ilk sinyali doğrulayın. ## AI asistan bağlamı Uygulamanızı veya kurulum komutunu düzenlemeden önce agenta herkese açık LogBrew haritasını verin. ```bash curl -L https://logbrew.co/llms.txt ``` ### AI kurulum promptu ```bash https://logbrew.co/llms.txt içeriğini oku, sonra https://logbrew.co/en/docs#docs-sdk-choice-title üzerindeki doğru SDK kartını seç. npm install @logbrew/sdk @logbrew/node komutunu yalnızca server-side Node.js servisi için kullan; Next.js, React, iOS, Android veya React Native için seçilen kartı ve Add Project promptunu kullan. Oturum açmış kullanıcıdan Add Project'i açmasını ve kimlik bilgilerini yalnızca eşleşen uygulama ortamına koymasını iste. Server-side Node.js için env değişkeni LOGBREW_SERVER_API_KEY olur. node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs komutunu yalnızca Node servislerinde çalıştır, ardından logbrew logs info --json ile doğrula. Sohbette veya commitlerde kimlik bilgisi isteme. ``` Next: Agent rehberini aç ## SDK'yı kur Log, span, aksiyon, sürüm ve metrik gönderen backend servisleri için Node paketlerini kullanın. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Projeyi oluştur Add Project'i açın, platformu seçin ve setup panelindeki tek seferlik ingest kimliğini kopyalayın. Next: Add Project'i aç ## Bir ürün aksiyonu gönder Production kodunu bağlamadan önce paketli örneği çalıştırın; ilk şekil bilinir ve token içermeyen kalır. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## LogBrew'de doğrula Daha fazla instrumentation eklemeden önce ilk info sinyalini loglarda okuyun. ```bash logbrew logs info --json ``` # İlk Node SDK sinyalini LogBrew'e gönder Canlı proje verisi istediğinde bu Node yolunu kullan. Dashboard projeyi oluşturur ve tek seferlik ingest kimliğini gösterir; public docs sadece paketleri ve güvenli doğrulama adımlarını verir. ## JavaScript SDK paketlerini ekle Backend servisinin log, request span, action, release ve metric göndermesi için core SDK ve Node yardımcısıyla başla. ```bash npm install @logbrew/sdk @logbrew/node ``` ## Projeyi Add Project ile oluştur Giriş yap, Add Project'i aç, platformu seç ve tek seferlik ingest kimliğini o setup panelinden kopyala. Panelden çıkınca website bunu tekrar göstermez. ## İlk SDK sinyali örneğini çalıştır Uygulamaya eklemeden önce release, environment, request span, product action, network milestone ve metric şeklini görmek için kurulu paket örneğini çalıştır. ```bash node node_modules/@logbrew/node/examples/first-useful-telemetry.mjs ``` ## LogBrew'de ilk sinyali oku SDK proje kimliğiyle bir info sinyali gönderdikten sonra, daha fazla instrumentation eklemeden önce CLI veya dashboard logs görünümünden geldiğini doğrula. ```bash logbrew logs info --json ``` # Başlangıç yolunu seçin ## LogBrew hazır mı kontrol edin Önce status çalıştırarak erişilebilirliği, oturum durumunu ve güvenli sonraki okumayı doğrulayın. ```bash logbrew status --json ``` ## Son hatalardan başlayın Son error loglarını okuyun, sonra sürüm veya proje bağlamı gerekiyorsa sorunlara ya da izlere geçin. ```bash logbrew logs error --json ``` ## Kararlı bir sorun görünümü paylaşın Aynı hata gruplarına bir ekip arkadaşı ihtiyaç duyduğunda açık sorunları listeleyin. ```bash logbrew issues open --json ``` # Komut haritası ## Status Her private okumadan önce yerel auth, API erişimi ve toparlanma adımlarını kontrol edin. ```bash logbrew status --json ``` ## Loglar Bir sürüm, proje veya trace bağlama ihtiyaç duyduğunda son hatalardan başlayın. ```bash logbrew logs error --json ``` ## Sorunlar Çöz, kapat, yok say veya yeniden aç kararı vermeden önce açık hata gruplarını listeleyin. ```bash logbrew issues open --json ``` ## Trace detayı Loglar veya sorunlar tek bir başarısız isteğe işaret ettiğinde bilinen trace id değerini okuyun. ```bash logbrew trace --json ``` ## Aksiyonlar Önemli bağlam bir ürün aksiyonuysa kullanıcı olaylarını ada göre filtreleyin. ```bash logbrew actions --name checkout_failed --json ``` ## Sürümler Dağıtım bağlamını log, sorun, trace span ve aksiyon sayılarıyla karşılaştırın. ```bash logbrew releases --json ``` ## Yerel kimlik doğrulamasını ve API erişimini kontrol edin İlk okuma, token bilgisini göstermeden CLI'ın LogBrew API'ye erişip erişemediğini size anlatmalıdır. - Bir script veya otomasyon kararlı alanlara ihtiyaç duyduğunda JSON modunu kullanın. - Geliştirici sonraki komuta ihtiyaç duyduğunda insan çıktısını kullanın. - Auth toparlanmasını login ve status komutlarına yönlendirin. ## Üretim sinyallerini kaynak bazında okuyun Loglar, sorunlar, aksiyonlar, izler, sürümler ve projeler hızlı taranacak kadar ayrı, bağlamı toparlayacak kadar bağlı kalmalıdır. - Loglar önem düzeyi, sürüm, ortam, proje, iz ve arama filtrelerini korur. - Sorunlar durum, iz bağlamı ve mutasyon sözlüğünü korur. - İzler span adlarını, sürüm bağlamını, ortam bağlamını ve proje kapsamını korur. ## Proje verisini açmadan faydalı bağlam gönderin Birinin kurulum yardımına veya güvenli devre ihtiyacı olduğunda public dokümantasyonu, Markdown'u ve kopyalanabilir komutları kullanın. - Sonraki adım kurulum veya komut keşfi olduğunda dokümantasyon linki paylaşın. - Düz metin ekran görüntüsünden daha kolaysa Markdown paylaşın. - Panel proje verisini oturum açma ve backend auth arkasında tutun. ## Paneli backend rotalarıyla eşleştirin Web çalışma alanı dashboard-only depolama veya ayrı kontrat icat etmek yerine belgelenmiş LogBrew API kontratlarını izlemelidir. - Loglar /api/logs üzerinden önem düzeyi, sürüm, ortam, proje, iz ve arama filtreleriyle okunur. - Sorunlar /api/telemetry/issues ve /api/telemetry/issues/{issue_id} üzerinden okunur ve güncellenir. - Aksiyonlar, sürümler ve iz detayı /api/telemetry/actions, /api/telemetry/releases ve /api/telemetry/traces/{trace_id} üzerinden okunur. - Projeler ve auth durumu /api/projects, /api/auth ve CLI status komutlarından gelir. ## Public agent links - Full docs site: https://docs.logbrew.co - Docs: https://logbrew.co/tr/docs - Docs Markdown: https://logbrew.co/tr/docs.md - Agent guide: https://logbrew.co/tr/agents - Home Markdown: https://logbrew.co/tr/page.md - llms.txt: https://logbrew.co/llms.txt - Sitemap: https://logbrew.co/sitemap.xml