Skip to main content

> tpl_arc_013

Gözlemlenebilirlik Mimarisi ve Telemetri Stratejisi

Birleşik dağıtık izlemeyi (W3C Trace Context, OpenTelemetry), metrik kardinalite kontrollerini, yapılandırılmış JSON günlük şemalarını, örnekleme oranı stratejilerini ve mikroservisler genelinde alarm gürültüsünü azaltmayı tanımlayan kapsamlı kurumsal gözlemlenebilirlik mimarisi ve telemetri standardı.

TEMPLATE // INSPECT: TPL-ARC-013MODIFIED: 2026-09-19
KATEGORİMimari ve Teknik Tasarım
SÜRÜMv1.0.0
RİSK SEVİYESİMEDIUM
ARTEFAKT SINIFIXLS
FORMATLARPDF, MD, MERMAID, SVG, XLSX
YAPAY ZEKÂ VE YÖNETİCİ ÖZETİ (AI SUMMARY)

OpenTelemetry dağıtık izleme, metrik kardinalite sınırları, yapılandırılmış JSON günlükleme ve baş/kuyruk örnekleme stratejilerini yapılandıran birleşik gözlemlenebilirlik standardı.

Önemli Teknik Doküman Şablonu ve Hukuki Uyarı

TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.

Çözülen Üretim Problemi

Mühendislik ekipleri dağıtık izleme olmaksızın pahalı izleme araçlarına yapılandırılmamış serbest metin loglar basar; bu da fırlayan bulut izleme faturalarına ve kritik kesintilerde kör noktalara yol açar.

Ne Zaman Kullanılmalı?

  • Çok dilli mikroservisler, Kubernetes kümeleri ve sunucusuz fonksiyonlar genelinde kurumsal gözlemlenebilirlik standartları kurarken
  • Dağıtık izler, metrikler ve günlükler için tedarikçiden bağımsız OpenTelemetry (OTel) araçlandırması uygularken
  • Metrik kardinalite patlamalarını kontrol altına alıp yüksek hacimli telemetri besleme maliyetlerini optimize ederken

Ne Zaman Kullanılmamalı?

  • Temel proje görev takibi ve sprint kalan iş (burndown) grafiklerinde (TPL-DEL-002 kullanın)
  • Müşteri anket NPS geri bildirim analitiğinde (TPL-PDS-003 kullanın)

5 Şablon Bölümü ve Yapısal İskelet

1. 1. Üç Sütun ve Birleşik Telemetri Felsefesistandard, enterprise

OpenTelemetry aracılığıyla Metriklerin (sayaçlar), Günlüklerin (yapılandırılmış JSON) ve İzlerin (dağıtık span'lar) entegrasyonu.

Yönerge:Tedarikçi bağımlılığını önlemek ve veriyi esnek yönlendirebilmek için tüm servislerde OpenTelemetry SDK'larını zorunlu kılın.
2. 2. Dağıtık İzleme ve W3C Trace Context Standardıstandard, enterprise

İz kimliği yayılımı (propagation), ebeveyn-çocuk span hiyerarşisi, veritabanı sorgu yakalama ve HTTP/Kafka üzerinden bağlam aktarımı.

Yönerge:W3C traceparent başlıklarını tüm iç HTTP çağrılarında ve asenkron Kafka mesaj başlıklarında eksiksiz olarak yayın.
3. 3. Metrik Kardinalite Yönetimi ve Maliyet Kontrolüstandard, enterprise

Etiket/boyut bütçelemesi, yüksek kardinalite hataları (metriklerde user_id, email, UUID kullanımı), Prometheus kuralları ve hız sınırlandırma.

Yönerge:Müşteri kimliği gibi yüksek kardinaliteli verileri metrik etiketlerine koymayı kesinlikle yasaklayın; bu verileri yapılandırılmış loglara aktarın.
4. 4. Yapılandırılmış JSON Günlükleme ve PII Maskelemestandard, enterprise

Standart şema alanları (timestamp, level, service, trace_id, span_id, message), log düzeyleri ve otomatik regex PII karartma.

Yönerge:Kredi kartı, şifre ve API anahtarlarını, loglar VPC dışına çıkmadan önce OpenTelemetry Collector işlemcilerinde otomatik olarak maskeleyin.
5. 5. Örnekleme Stratejileri ve Eyleme Dönük Alarmlarstandard, enterprise

Baş tabanlı olasılıksal örnekleme vs kuyruk tabanlı anomali örnekleme (hataların ve p99 izlerin %100'ü), SLO hata bütçesi tüketim alarmları.

Yönerge:Tüm HTTP 5xx hatalarını ve yüksek gecikmeli izleri %100 saklarken, sağlıklı 200 OK izlerinin %95'ini ayıklayan kuyruk tabanlı örnekleme uygulayın.

Doldurma ve Uygulama Yönergeleri

1. Boş şablonu inceleyin. 2. Örnek senaryoyu kurum ölçeğine uyarlayın. 3. Kontrol listesiyle doğrulayın.

Bağımsız İnceleme ve Onay Kontrol Listesi

  • Tüm zorunlu bölümler dolduruldu
  • Gizli anahtar veya parola içermiyor
  • Yönetici sponsor onayı alındı
İŞLENMİŞ SENARYO ÖRNEĞİ

Gözlemlenebilirlik Mimarisi ve Telemetri Stratejisi - Örnek Vaka Analizi

Örnek Organizasyon: Sovereign Fintek Birleşik Gözlemlenebilirlik Mimarisi ve Telemetri Boru Hattı

Sovereign Fintek Birleşik Gözlemlenebilirlik Mimarisi ve Telemetri Boru Hattı için eksiksiz operasyonel uygulamayı gösteren gerçek dünya vaka analizi.

Öne Çıkan Bulgular ve Çıktılar:
  • Kuyruk tabanlı örnekleme ve metrik kardinalite bütçelemesiyle yıllık Datadog maliyetleri %52 (380.000 $) azaltıldı
  • 80 Kubernetes mikroservisi ve Kafka olay işleyicisi genelinde %100 uçtan uca dağıtık iz yayılımı sağlandı
  • OpenTelemetry Collector katmanında otomatik PII temizleme kurularak log depolarına müşteri kartı sızıntısı tamamen sıfırlandı

Sıkça Sorulan Sorular

Metrik kardinalitesi nedir ve kardinalite patlaması neden astronomik bulut faturalarına yol açar?

Metrik kardinalitesi, bir metriğin tüm etiket değerlerinin çarpımıyla oluşan toplam benzersiz zaman serisi sayısıdır. "status" (3 değer) ve "service" (10 değer) etiketleri 30 seri üretir. Ancak bir mühendis yanlışlıkla "user_id" (1.000.000 değer) eklerse, kardinalite 30 milyon seriye patlar; bu da bellekleri tüketir ve on binlerce dolar ek maliyet çıkarır.

Dağıtık izlemede baş tabanlı (head-based) ile kuyruk tabanlı (tail-based) örnekleme arasındaki fark nedir?

Baş tabanlı örnekleme, bir izin saklanıp saklanmayacağına istek başlarken rastgele karar verir (%5 örnekleme gibi). Bu da kalan %95'te gerçekleşen kritik üretim hatalarının kaçırılmasına yol açar. Kuyruk tabanlı örnekleme ise isteğin tüm adımlarını OpenTelemetry Collector'da tamponlar; istek bittiğinde inceleyerek hata veya yüksek gecikme içeren izlerin %100'ünü saklar.

Ekipler neden tekil sistem eşikleri yerine SLO hata bütçesi tüketim hızına göre alarm kurmalıdır?

Eşik tabanlı alarmlar (CPU > %80 veya hata > 10) aşırı alarm yorgunluğu üretir çünkü geçici dalgalanmalar kullanıcıyı etkilemeden düzelir. SLO hata bütçesi tüketim hızına göre alarm kurmak ise yalnızca müşteriye yansıyan güvenilirlik aylık bütçeyi saatler içinde tüketecek hızda bozulduğunda bildirim gönderir; böylece her alarm eyleme dönüştürülebilir olur.

Teknik Doküman Şablon Paketi

Giriş Gerekli
Ücretsiz ve güvenli indirmeler için tek seferlik giriş veya kayıt gereklidir.
Eksiksiz Teknik Doküman Paketi (.zip)
12 Dosya

Tüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.

Münferit Belgeler (.zip)
TPL-ARC-013-Technical-Debt-Register-and-Remediation-Roadmap-Blank-EN.xlsxXLSX
all9.9 KB
TPL-ARC-013-Technical-Debt-Register-and-Remediation-Roadmap-Example-EN.xlsxXLSX
all10.0 KB
TPL-ARC-013-Teknik-Bor-K-t-ve-yile-tirme-Yol-Haritas-Bos-TR.xlsxXLSX
all10.0 KB
TPL-ARC-013-Teknik-Bor-K-t-ve-yile-tirme-Yol-Haritas-Ornek-TR.xlsxXLSX
all10.0 KB
TPL-ARC-013-Observability-Architecture-and-Telemetry-Strategy-Blank-EN.pdfPDF
all102.7 KB
TPL-ARC-013-Observability-Architecture-and-Telemetry-Strategy-Example-EN.pdfPDF
all101.5 KB
TPL-ARC-013-Gozlemlenebilirlik-Mimarisi-ve-Telemetri-Stratejisi-Bos-TR.pdfPDF
all106.0 KB
TPL-ARC-013-Gozlemlenebilirlik-Mimarisi-ve-Telemetri-Stratejisi-Ornek-TR.pdfPDF
all105.9 KB
TPL-ARC-013-Observability-Architecture-and-Telemetry-Strategy-Blank-EN.mdMD
all2.4 KB
TPL-ARC-013-Observability-Architecture-and-Telemetry-Strategy-Example-EN.mdMD
all2.5 KB
TPL-ARC-013-Gozlemlenebilirlik-Mimarisi-ve-Telemetri-Stratejisi-Bos-TR.mdMD
all2.5 KB
TPL-ARC-013-Gozlemlenebilirlik-Mimarisi-ve-Telemetri-Stratejisi-Ornek-TR.mdMD
all2.6 KB
Doğrulanmış SHA-256 · Makrosuz Güvenli Arşiv
Her indirme dinamik MANIFEST.json içerir

Yetkili Standartlar ve Kaynaklar