> ## 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.

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

> LogBrew sinyal türlerine, proje kapsamına, kimliğe, kanıt durumlarına ve ürün analizleri terimlerine bakın.

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](/tr/concepts/telemetry)
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](/tr/guides/mcp)
sayfasını okuyun.

## Gözlemlenebilirlik sinyalleri

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="İ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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## 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](/tr/guides/investigate-an-issue) 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](/tr/concepts/product-analytics) sayfasını
okuyun. Sınıflandırılmış etkinlik ve tipli kimlik göndermek için
[Ürün olaylarını yakalama](/tr/guides/product-events) sayfasını kullanın.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.