Gözlemlenebilirlik terimler sözlüğü ve LogBrew terimleri

LogBrew her ürün kavramı için tek bir terim kullanır. API alanları, CLI seçenekleri, enum değerleri, olay adları ve öznitelik anahtarları her dilde aynı kalır.

Gözlemlenebilirlik ve izleme

Terim	Anlamı
Gözlemlenebilirlik (observability)	Bir uygulamanın davranışını ürettiği kanıttan anlamak.
Telemetri	Bir uygulamanın bildirdiği loglar, izler ve metrikler gibi sinyaller.
İzleme	Ölçülen bir değeri bir eşikle karşılaştırmak gibi bilinen koşulları kontrol etmek.
`o11y`	Observability sözcüğünün kısa biçimi. Sayı, `o` ile `y` arasındaki 11 harfi sayar.

Sinyal seçimi ve uygulamalı örnekler için Telemetri sayfasını okuyun.

AI agentlar

Terim	Anlamı
MCP sunucusu	Model Context Protocol için barındırılan LogBrew sunucusu. AI agentlar onaylı projeleri okumak için bu sunucuyu kullanır.
MCP istemcisi	Bir AI agent’ı MCP sunucusuna bağlayan uygulama, örneğin Claude Code.
Onaylı proje	Bir MCP istemcisine erişim verirken seçtiğiniz proje. İstemci yalnızca onaylı projeleri okuyabilir.
Bağlantı	Bir MCP istemcisini onayladığınızda ona verdiğiniz erişim. 30 gün kullanılmadığında, 90 gün sonra veya siz iptal ettiğinizde sona erer. CLI buna grant der.

Bir istemciyi bağlamak için Bir AI agent’ı MCP ile bağlayın sayfasını okuyun.

Gözlemlenebilirlik sinyalleri

Sorun

Birden fazla oluşum içerebilen gruplanmış bir sorun. Oluşum, o sorunun yakalanmış tek bir örneğidir. first_seen_at ilk oluşumun zamanıdır. last_seen_at en son oluşumun zamanıdır.

Log

Zaman damgalı tek bir olay kaydı. Bir log önem düzeyi, hizmet, sürüm, ortam, iz bağlamı ve gizlilik sınırları içinde öznitelikler taşıyabilir.

İz ve span

İz, bir istek veya işlem boyunca yapılan işi izler. Span, o iz içindeki süresi ölçülmüş tek bir işlemdir. Bir izle ilişki, ortak bağlamın kanıtıdır; nedenin kanıtı değildir.

Metrik

Tanımlı bir birimi, türü, toplama yöntemi ve zaman aralığı olan çalışma zamanı ölçümü. Metrik noktaları log, iz veya sorun sayılarının yerine kullanılamaz.

Sürüm

Telemetriyle bildirilen, dağıtılmış bir uygulama veya hizmet sürümü. Sürüm, proje veya depoyla aynı nesne değildir.

Aksiyon

Kayıt olma, ödeme, içe aktarma veya başarısız bir iş gibi sınıflandırılmış bir ürün olayı. Analizler bir aksiyonu sayfa görüntüleme, ekran görüntüleme veya etkileşim olarak sınıflandırır. Aksiyon, LogBrew’ün çalıştırdığı otomatik bir komut değildir.

Sorun incelemesi

Her oluşum her alanı içermez.

Terim	Anlamı
Önem düzeyi	Bir sinyalin aciliyeti: `info`, `warning`, `error` veya `critical`. Sorun durumundan ayrıdır.
Sorun durumu	Gruplanmış bir sorunun iş akışındaki durumu: `unresolved`, `resolved` veya `archived`. Tek bir isteğin sonucu değildir.
Arşivlenmiş sorun	Ekibin etkin önceliklendirmeden çıkardığı sorun. Eski yanıtlar bu durumu `ignored` olarak adlandırır.
Sorun önceliği	Gruplanmış bir sorunun önceliklendirme sırası: `high`, `medium` veya `low`. Bir kişi ayarlayana kadar önem düzeyini izler.
Öncelik kaynağı	Önceliğin nereden geldiği. `derived` önem düzeyini izler: `error` ve `critical` için `high`, `warning` için `medium`, `info` için `low` olur. `manual`, bir kişinin elle ayarladığı önceliktir.
Sorun sorumlusu	Gruplanmış bir sorunda sonraki adımın sahibi olan 1 hesap veya 1 ekip. Hesap projeyi okuyabilmeli, ekip de projenin organizasyonunda olmalıdır.
Ekip	Bir organizasyondaki üyelerden oluşan, adı olan bir grup. Sorunlar bir ekibe atanabilir, sahiplik kuralları da bir ekibi belirtebilir. Ekip, üyelerine proje erişimi vermez.
Sahiplik kuralı	Bir yığın çerçevesi yolunu, modülü, rotayı, hizmeti veya etiketi, eşleşen sorunların sahibi olan hesaplara ya da ekiplere bağlayan proje kuralı.
Önerilen sahip	LogBrew’ün bir sorun için önerdiği hesap veya ekip. Öneri bir sahiplik kuralından, CODEOWNERS dosyasındaki bir satırdan veya son etkinlikten gelir. Bu bir öneridir, atama değildir.
Gelen kutusu	Başkalarının size veya ekiplerinize atadığı sorunların listesi. LogBrew bunun için e-posta göndermez.
Yığın izi	Bir hata için yakalanan fonksiyon çağrısı kanıtı. Dağıtık izlemedeki (distributed tracing) izden farklıdır.
Yığın çerçevesi	Yığın izindeki tek bir kayıt. Bir fonksiyonu, modülü, dosyayı, satırı veya sütunu tanımlayabilir.
İstisna zinciri	Birlikte bildirilen bağlantılı istisnalar, örneğin bir hata ve nedeni. Eksik, gizlenmiş veya kısaltılmış kayıtlar kanıtı sınırlar.
Uygulama çerçevesi	Uygulama kodu olarak işaretlenmiş yığın çerçevesi. İncelenecek kodu gösterir. Hatayı kanıtlamaz.
Önceki adım (breadcrumb)	Bir sorun oluşumundan önce kaydedilen kısa bir olay. Önceki adımlar bir oturumun tam kaydı değildir.
Ele alınmış istisna	Uygulamanın ele alındı olarak bildirdiği istisna. İşlemin başarılı olduğunu kanıtlamaz.
Source map (kaynak eşlemesi)	Üretilen JavaScript konumlarını orijinal kaynak konumlarına eşleyen derleme dosyası.
Sembolleştirilmiş çerçeve	Üretilen konumu orijinal kaynak bilgisine çözümlenmiş çerçeve.
Temel oluşum	Yeniden üretme için referans olarak kullanılan yakalanmış oluşum.
Kaynak	Bir değerlendirmenin nereden geldiği. `backend_observed`, LogBrew’ün bunu gözlemlediği anlamına gelir. `application_reported`, uygulamanın bunu bildirdiği ve LogBrew’ün doğrulamadığı anlamına gelir.
Yeniden üretme hazırlığı	Temel oluşumun, yeniden üretmeyi denemek için gereken kanıta sahip olup olmadığı. Başarılı bir yeniden üretme testi değildir.

Okuma sırası ve yanıt alanları için Bir sorunu inceleyin rehberini kullanın.

Kimlik ve ilişki

Eksik bir değer, ilgili etkinliğin gerçekleşmediğini kanıtlamaz.

Terim	Anlamı
İz bağlamı	İşi sinyaller arasında bağlayan iz ve span tanımlayıcıları.
Kök span	Bir izi başlatan ve üst span’i olmayan span. Dönen en eski span kök olmayabilir.
Alt span	Aynı izde üst span’i olan span.
İlişki	LogBrew’ün döndürdüğü kesin bir bağ, örneğin ortak bir iz kimliği. Nedeni kanıtlamaz.
Tanımlı kullanıcı	Uygulamanın verdiği, kararlı bir kimliği ve `user` türü olan özne.
Anonim özne	Uygulamanın verdiği, `anonymous` türünde özne. Sayımlar bunu tanımlı kullanıcılardan ayrı tutar.
Bilinmeyen kimlik türü	Bilinen bir türü olmayan özne. Tanımlı kullanıcı olarak sayılmaz.
Eksik özne	Öznesi olmayan olay. Türü bilinmeyen bir özneden farklıdır.

Kimlik türü, uygulamanın öznesini nasıl sınıflandırdığını gösterir. Verinin anonim olduğunu kanıtlamaz. Kararlı bir kimlik yine de etkinlikleri birbirine bağlayabilir.

Kapsam ve veri kalitesi

Terim	Anlamı
Proje	Sahip olunan temel ürün sınırı. Bir proje birden fazla hizmet veya depo bileşeni içerebilir.
Hizmet	Bir proje içinde veri bildiren çalışma zamanı veya bileşen.
Ortam	Production veya staging gibi kesin bir bildirim bağlamı.
Alındı	Veri alımı sözleşmesince kabul edildi. Süresiz saklama vaat etmez.
Dizinlendi	Belirtilen dizinde veya sorguda kullanılabilir. Alındı ile eş anlamlı değildir.
Saklanıyor	Değerlendirilen veri aralığında mevcut.
Örneklendi	Telemetrinin bir kısmı toplamadan önce veya toplama sırasında seçildi.
Kapsama oranı	Payı ve paydası açıkça belirtilen ölçülmüş bir oran.
Kısaltıldı	Yanıt bir sınıra ulaştı. Dışarıda kalan veri her zaman yok demek değildir.
Yaklaşık	Tam sayılmak yerine belgelenmiş yöntemle tahmin edildi.
Zaman aralığı	Bir sorgunun değerlendirdiği kesin dönem.

Ölçümler ve zaman

Terim	Anlamı
Veri noktası	Bildirilen bir zamandaki tek bir değer. Veri noktalarını karşılaştırmadan önce metrik adını ve birimini okuyun.
Zaman serisi	Aynı ölçümün zamana göre sıralanmış değerleri. Bir boşluk, değerin sıfır olduğu anlamına gelmez.
Süre	Bir işlemin geçen süresi. İşlemin gerçekleştiği zamandan farklıdır.
Toplama	Ölçümler üzerinde tanımlı bir hesaplama, örneğin toplam veya ortalama.
Zaman dilimi	Bir grafikteki veya gruplanmış sonuçtaki tek bir aralık. Başlangıcı ve bitişi aralığı belirler.
Kısmi dönem	Henüz tamamlanmamış dönem. Etkinliği sıfır olan tamamlanmış bir dönem değildir.

Toplam istek süresini bulmak için çakışan alt span’lerin sürelerini toplamayın. Bir olay sayısını tanımlı kullanıcı sayısıyla karşılaştırmayın.

Kanıt durumları

Bu durumlar birbirinin yerine kullanılamaz:

Yakalandı: kanıt mevcut.
Eksik: kanıt yakalanmadı.
Gizlendi: kanıt bilerek gizlendi.
Kısaltıldı: kanıt bir yanıt veya yakalama sınırını aştı.
Kullanılamıyor: okuma kanıtı sağlayamadı.

Likely cause (olası neden) ve likely fix area (olası düzeltme alanı), kanıtlanmış bir kök nedeni değil, sınırlı tanılama kanıtını anlatır. Reported impact (bildirilen etki), bir sözleşme açıkça LogBrew ölçümü olduğunu belirtmedikçe bildiren uygulamadan gelir.

Ürün analizleri

Terim	Anlamı
Olay	Kesin ve kararlı bir adı olan, sınıflandırılmış ürün etkinliği.
Özellik	Bir olayı tanımlamak veya filtrelemek için kullanılan bağlam anahtarı.
Oturum	Bir kişi değil, bir ziyaret veya uygulama oturumu.
Kohort	Kesin ölçütlerle tanımlanan sınırlı grup.
Dönüşüm hunisi	İlerlemeyi veya dönüşümü ölçmek için kullanılan sıralı adımlar.
Elde tutma	Açık bir dönem ve paydayla ölçülen geri dönme davranışı.
Yollar	Seçilen bir olaydan önceki veya sonraki oturum yolculukları.
Yaşam döngüsü	Tanımlı özneleri her dönemde gözlemlenen geçmişte yeni, geri dönen, yeniden etkinleşen veya etkin olmayan olarak gruplar.
Gözlemlenen geçmişte yeni	Sınırlı geçmiş aralığında daha önce seçilen olayı olmadan etkin olan. İlk kez gelen müşteri anlamına gelmez.

Kısmi dönemler, eksik kimlik, eksik özellik yakalama, örnekleme ve kısaltma sonucu sınırlar. LogBrew bu sınırları sıfıra veya kesinliğe çevirmek yerine gösterir. Sayım kuralları için Ürün analizleri sayfasını okuyun. Sınıflandırılmış etkinlik ve tipli kimlik göndermek için Ürün olaylarını yakalama sayfasını kullanın.

​Gözlemlenebilirlik ve izleme

​AI agentlar

​Gözlemlenebilirlik sinyalleri

​Sorun incelemesi

​Kimlik ve ilişki

​Kapsam ve veri kalitesi

​Ölçümler ve zaman

​Kanıt durumları

​Ürün analizleri