Proje, hizmet, ortam
Bir proje kurun
CLI’ı kurun. Hesap erişiminizi okumak içinlogbrew status --json komutunu çalıştırın. Erişim geçerli değilse bir kişi
logbrew login komutunu çalıştırır. Proje alım anahtarı (ingest key) ile
giriş yapılamaz.
1
Bir proje oluşturun veya seçin
Önce projelerinizi listeleyin. Yalnızca proje yoksa yeni bir proje
oluşturun.CLI, alım anahtarını yalnızca sahibinin okuyabildiği yeni bir dosyaya
yazar. Anahtarı veya dosya yolunu hiçbir zaman yazdırmaz. Sonuç net
değilse aynı komutu yeniden çalıştırın. Proje adını veya anahtar
dosyasını değiştirmeyin. CLI bekleyen isteğinin kimliğini yeniden
kullanır. Hızlı başlangıç, proje kimliğini sonuçtan nasıl
okuyacağınızı gösterir.Mevcut bir proje için kurulum durumunu kaydedin:Mevcut bir projeye başka bir alım anahtarı oluşturmak için
logbrew projects keys create komutunu kullanın.
Alım anahtarını yenileyin rehberi komutu
gösterir.logbrew setup --create-project yalnızca yardımı gösterir. Proje
oluşturmaz.2
SDK'da hizmet adlarını ayarlayın
Deponuzdan ve dağıtımınızdan gelen adları kullanın:
api, worker,
web, ios veya checkout-api gibi. Hizmet adı bir etikettir, proje
seçici değildir. Projeyi alım anahtarı seçer. Bir hizmetin adını
değiştirmek saklanan olayları taşımaz. Bir olayı bulamazsanız başka bir
proje oluşturmadan önce uygulamanın kullandığı projeyi ve alım
anahtarını kontrol edin.3
Standart ortamlar kullanın
production, staging, preview ve local kullanın. Dağıtımınız
başka adlar kullanıyorsa onları tutarlı biçimde kullanın. Ortam adı
boşluk, / veya ters eğik çizgi içeremez.4
Bir test olayı gönderin ve okuyun
SDK’yı, SDK entegrasyonu rehberinde
anlatıldığı gibi proje alım anahtarıyla yapılandırın. Proje oluşturmak,
uygulamanıza SDK kurmaz. Anahtarı kaynak kod deposunun dışında tutun.
Hizmeti, ortamı ve sürümü uygulamada ayarlayın. Güvenli bir olay
gönderin, ardından okuyun:Her sinyalin kendi listesi vardır. Log listesinin boş olması, projede
sorun veya iz olmadığı anlamına gelmez.Panelde aynı projeyi ve test olayını kapsayan bir zaman aralığı seçin.
Hizmet, ortam ve sürüm filtrelerinin olayla eşleştiğinden emin olun.
Proje kurulumunu teşhis edin
Kurulum durumunu proje doctor komutuyla okuyun. Kurulum durumunu yerel dosyalardan veya boş bir log sorgusundan çıkarmayın.status, checks ve next içeren bir rapor döndürür. 0 çıkış kodu,
tüm kontrollerin başarılı olduğunu göstermez. checks içindeki her öğeyi
okuyun. Bkz.
Proje doctor raporunu okuyun.
Doğrudan API yanıtı
API istemcileriGET /api/projects/{project_id}/doctor uç noktasını hesap
kimlik doğrulamasıyla çağırır. Uç noktanın sorgu parametresi veya istek
gövdesi yoktur. Bu okuma için hiçbir zaman proje alım anahtarı kullanmayın.
200 yanıtı şu anahtarları içerir: project_id, state, setup_status,
setup_acknowledged, has_active_ingest_key, first_telemetry_seen_at,
last_seen_at, last_signal, next ve next_action. Zaman damgaları
RFC3339 biçimindedir veya null olur. last_signal ham bir sinyal değil,
gösterilmesi güvenli bir özettir.
Doctor önce alım anahtarını kontrol eder. Etkin alım anahtarı olmayan bir
proje, kurulum durumu ne olursa olsun
needs_ingest_key olur.
setup_status değeri created, setup_started, sdk_seen,
first_telemetry_seen veya active olur. setup_acknowledged yalnızca son
üç değerde true olur. created, needs_setup sonucunu verir.
setup_started ve sdk_seen, needs_telemetry sonucunu verir.
first_telemetry_seen ve active, ready sonucunu verir.
Okuma yine başarısız olursa sorun bildirin.
Kimlik bilgilerini, başlıkları, sinyal gövdelerini, müşteri verilerini, yerel
yolları veya kaynak kodu eklemeyin.
Bir projeyi arşivleyin veya silin
Bir projeyi etkin proje listesinden kaldırmak için arşivleyin:--yes gerektirir. Arşivlemeden sonra projenin alım anahtarları yeni
telemetri kabul etmez. API rotası DELETE /api/projects/{project_id}
şeklindedir. Gövdesiz bir 204 döndürür. Arşivlenmiş projeleri
GET /api/projects/archived ile listeleyin. Bir projeyi
POST /api/projects/{project_id}/restore ile geri yükleyin. Bu istek de
204 döndürür.
Bir projeyi yalnızca emin olduğunuzda kalıcı olarak silin:
--confirm seçeneğinden sonra aynı proje kimliğini tekrar yazın. Kabul edilen
bir istek projeyi hemen etkisiz hâle getirir ve kalıcı silmeyi zamanlar. Bundan
sonra projeyi geri yükleyemezsiniz.