Dokümantasyon
Orbtrace el kitabı
En baştan başlayın ve sırayla okuyun. Her sayfa numaralı, her ekranın bir açıklaması, her grafiğin bir anlamı var. Daha önce hiç gözlemlenebilirlik (observability) aracı kullanmadıysanız bile bu kılavuz size hiçbir şeyi 'bildiğiniz varsayılarak' anlatmaz.
Buradan başlayın
Orbtrace nedir, ne işe yarar ve on dakikalık ilk çalıştırma.
- Orbtrace nedir?Daha önce hiç gözlemlenebilirlik (observability) aracı kullanmadıysanız önce bunu okuyun. Orbtrace'in çözdüğü problemi ve arayüzde ne göreceğinizi sade dille anlatır.
- KavramlarLog, trace, span, metrik, SLO, RCA kelimelerinin her birinin bir karşılığı var. Bu sayfa, arayüzde göreceğiniz her şeyi anlamadan önce kavramları somut benzetmelerle açıklar.
- Hızlı başlangıçHiçbir şey kurulu değilken ilk trace'i ekranda görene kadarki yol — kopyala-yapıştır, sırayla, Docker'lı herhangi bir makinede. Collector ayağa kaldırmak dahil her adımda dürüst.
Kurulum ve Dağıtım
Hazırlanın, sonra tek host, Kubernetes ya da buluta dağıtın.
- Kurulum hazırlığıOrbtrace'i kurmadan önce neye karar vermeniz ve neyi hazırlamanız gerektiği — üç dağıtım yolu, donanım ve kernel ön-koşulları, gerçek port listesi ve kurulum-sonrası kontrol listesi.
- Kapasite planlamaDağıtımı yükünüze göre boyutlandırın — hesaplayıcıya günlük hacminizi, saklama sürenizi ve servis sayınızı girin; Helm boyutunu, Doris FE/BE sayısını, vCPU, bellek ve disk ihtiyacını alın. Apache Doris'in yayınlanmış dağıtım rehberine dayanır.
- Tek host (Docker Compose)Önerilen hepsi-bir-arada dağıtım — tek bir docker compose up -d, Orbtrace uygulamasını, Doris'i, Postgres+pgvector'ı ve Valkey'i tek makinede ayağa kaldırır. Ayrıca en hızlı değerlendirme yolu.
- Bare metal (Ansible)Docker Compose ile aynı tek-host yığını, tek bir Linux host'ta sizin için kurulur ve yönetilir — Docker kurulur, sırlar vault'lanır ve yığın bir systemd servisi olarak çalışır.
- Kubernetes'e dağıtımDurumsuz Orbtrace uygulamasını OCI Helm chart'ı ile Kubernetes'te çalıştırın ve ihtiyaç duyduğu veri depolarına bağlayın. Genel bakış, önerilen mimari ve adım adım alt-sayfalar.
- Veri depolarını sağlayınBir Kubernetes dağıtımı için Postgres+pgvector ve Valkey'i (ya da Redis) nasıl çalıştıracağınız — chart içinde gömülü, bir VM ya da yönetilen serviste ya da Docker ile — ve chart'ı onlara nasıl yönlendireceğiniz.
- Doris kurulumuHelm chart'ının doris.host ile yönlendirdiği Doris telemetri deposunu nasıl sağlayacağınız — Doris'i nerede çalıştıracağınızı seçme, gereksinimler, küme içi Doris'in neden operatör kullandığı, operatörü kurma, DorisCluster uygulama ve Orbtrace'i ona karşı ayağa kaldırma.
- Helm ile kurunRegistry'ye kimlik doğrulayın, chart değerlerini düzenleyin, helm install çalıştırın ve doğrulayın — veri depolarınız hazır olduğunda Orbtrace için adım adım Helm kurulumu.
- OpenShift / OKDOrbtrace'i OpenShift'te varsayılan restricted-v2 SCC altında kurma — values-openshift overlay'i, tek node-seviyesi ön-koşul (Node Tuning Operator ile kernel ayarları), Doris operatör PSA + SCC'si ve Route tabanlı ingress.
- Portlar ve erişimKubernetes'te Orbtrace'e nasıl eriştiğiniz ve herhangi bir portu nasıl değiştireceğiniz — 8080'deki uygulama, Collector'ınızın OTLP portları ve Doris/Postgres/Valkey portları.
- Buluta dağıtımOrbtrace'i yönetilen bir Kubernetes kümesinde — EKS, AKS ya da GKE — Helm yolu ile ve bulutun yönetilen Postgres'i, önbelleği, deposu ve yük dengeleyicisiyle çalıştırın.
- AWS'ye dağıtım (EKS)Orbtrace'i Amazon EKS'te önerilen şekilde çalıştırın — Postgres+pgvector için RDS, throughput'u ayarlanmış bir gp3 StorageClass, operatör ya da EC2 ile Doris, ACM TLS'li bir ALB ingress ve AWS'ye özgü tuzaklar (EBS AZ kilidi, IRSA, security group'lar).
- Azure'a dağıtım (AKS)Orbtrace'i Azure Kubernetes Service'te önerilen şekilde çalıştırın — pgvector allowlist'li Azure Database for PostgreSQL, ayarlanabilir bir Premium SSD v2 StorageClass, operatör ya da Azure VM'leri ile Doris, AGIC ingress ve Azure'a özgü tuzaklar.
- GCP'ye dağıtım (GKE)Orbtrace'i Google Kubernetes Engine'de önerilen şekilde çalıştırın — Postgres+pgvector için Cloud SQL, ayarlanabilir bir Hyperdisk StorageClass, operatör ya da GCE ile Doris, yönetilen sertifikalı GKE Ingress ve GCP'ye özgü tuzaklar.
- Giriş ve SSOKullanıcılar Orbtrace'e nasıl giriş yapar. Bir Tek Oturum Açma (SSO) sağlayıcısı seçip bir defa konfigüre edin — ekibiniz içeri girer. Parola yok, ayrıca bir hesap yönetilmiyor.
- İlk girişTaze bir Orbtrace kurulumuna ilk giriş yaptığınızda göreceğiniz şeyler ve ekibinizi içeri almadan önce doğrulamanız gereken beş madde.
- LisanslamaOrbtrace lisanslamasının nasıl çalıştığı — ücretsiz COMMUNITY sürümü, ücretli sürümler, bir lisansın çevrimdışı nasıl alınıp etkinleştirileceği ve süresi dolduğunda tam olarak ne olacağı.
Verinizi gönderin
Uygulamalarınızı Orbtrace'e bağlayın ve verinin geldiğini görün.
- Uygulamaları enstrümante etLog, trace ve metrikleri gerçek servislerinizden Orbtrace'e gönderin. Java, .NET, Go, Node, Python, PHP, Ruby, Rust için kopyala-yapıştır blokları, ham-JSON-over-HTTP yolu, artı veritabanları, cache'ler ve mesaj kuyrukları.
- Entegrasyon desenleriOpenTelemetry Collector uygulamalarınızı Orbtrace'in Doris'ine nasıl bağlar — iki saha deseni, sinyal başına Doris exporter bağlantısı, önerilen üretim ayarları, ileri seviye tuning ve tek host, Kubernetes, OpenShift ve service mesh yerleşimleri.
Yapılandırma
Ayarlar, yapay zeka sağlayıcı, kimlik doğrulama, örnekleme, saklama süresi.
Ekran ekran
Arayüzdeki her sayfa — ne görüyorsunuz, hangi grafik neyi anlatıyor.
- Arayüz turuOrbtrace arayüzünün her düzen parçası — üst bar, kenar menü, zaman seçici, komut paleti, tema, altbilgi. Ekran rehberlerinden önce bir kez okuyun.
- Ana sayfaGirişten sonra düştüğünüz ilk ekran. Her panelin gösterdiği şey, her rengin anlamı ve yanlış görünüyorsa önce ne tıklamanız gerektiği.
- ServislerZamanınızın çoğunu geçireceğiniz iki ekran. Liste "hangi servis mutsuz?" sorusunu, detay "neden?" sorusunu yanıtlar.
- Servis haritasıFilo genelinde kimin kimi çağırdığının canlı grafı. Kenar kalınlığı, rengi ve düğüm şeklinin anlamını öğrenin — kötü bir bağımlılığı saniyelerde nasıl bulursunuz?
- LoglarBir olayı açıklayan log satırını bulduğunuz ekran. Histogram, arama çubuğu, desen kümelemesi, detay paneli — her birinin ne işe yaradığı.
- Canlı izlemeTüm filo için `tail -f`. Log satırlarının gelir gelmez akan beslemesi — Loglar ekranıyla aynı filtreler ama histogram yok, durdurma yok.
- Trace'lerListede doğru trace'i nasıl bulursunuz (histogram + sütunlar + otomatik tamamlama), açtıktan sonra şelaleyi ve span özniteliklerini nasıl okursunuz?
- MetriklerMetrik seçin, özniteliklerle dilimleyin, çizin. Dört grafik türü, metrikleri birleştirme ve sorguyu pano paneli olarak kaydetme.
- PanolarLog, trace ve metrik sorgularından oluşan sürükle-bırak panolar. Hangi panel türleri var, değişkenler nasıl çalışır, paylaşım nasıl olur.
- AlarmlarTam alarm konsolu — kurallar, kanallar, alıcılar, yönlendirme, eskalasyon, takvimler, susturmalar, bakım, denetim, analitik ve GitOps. Her alt sayfa ne için ve hangi sırayla kurulmalı.
- Olaylar & RCABir alarm yandığında bir olay açılır. Sebep RCA'sı, sebebi anlatan ve span'lerden kaynak gösteren bir paragraf yazar. Bu sayfa olay ekranının her parçasını açıklar.
- ReplayGeçmişten bir an seçin. Tek bir gerçeği değiştirin ("ya deploy yapılmasaydı?"). Orbtrace, yapay zekânızla geçmiş veri ve benzer olaylar kullanarak varsayım sonucu simüle eder. Bu sayfa, bir replay'in nasıl çalıştırılacağını ve sonucun nasıl okunacağını anlatır.
- Astra (AI asistanı)Telemetrinizi arayabilen, trace getirebilen, RCA çalıştırabilen ve sizin için alarm taslağı hazırlayabilen sohbet asistanı — artı "Fark ettiklerim" proaktif paneli. Nasıl kullanılır, neler yapabilir ve korkuluklar.
- OperasyonlarServis × operasyon derinleşmesi — "servis detayı" ekranıyla aynı, ama belirli bir endpoint'e (örn. `POST /checkout`) çevrilmiş.
- YönetimYalnız-yönetici ayarları — AI sağlayıcı, anomali tespiti, örnekleme tavanları, SLO varsayılanları, servis kataloğu, entegrasyonlar, kullanıcılar, lisans, saklama, Astra PII ve telemetri sağlığı. Her alt sayfa ne için.
- Sayılar nasıl hesaplanırServisler ve SLO ekranlarındaki her başlık sayısının tam olarak ne anlama geldiği, arkasındaki formül ve dürüst uyarılar — istek hızı, hata oranı, percentile'lar, sağlık, burn rate, hata bütçesi, Apdex, doygunluk ve "sapma".
İşletme
Gün-iki operasyonları — yedekler, yükseltmeler, sıkılaştırma, hava boşluklu çalıştırma.
- Yedekleme ve geri yüklemeNeyi yedeklemeli (ve neyi değil), Helm yedekleme CronJob'ları nasıl çalışır, manuel Compose/Ansible prosedürü ve nasıl geri yüklenir — hem ayarlar veritabanı hem telemetri deposu için.
- YükseltmelerOrbtrace'i yeni bir sürüme Docker Compose, Helm ve Ansible'da güvenle taşımak — neyin otomatik göç ettiği, önce neyi yedeklemeli ve nasıl geri alınır.
- Güvenlik sıkılaştırmaOrbtrace dizüstünüzün ötesinde herhangi bir şeyle karşılaşmadan önce çalıştırılacak kontrol listesi — TLS, sırlar, ağ açığı, kimlik doğrulama duruşu, actuator yüzeyi ve audit izi.
- Hava boşluklu çalıştırmaOrbtrace'i internet erişimi olmayan bir ağda çalıştırmak — çevrimdışı kurulum bundle'ı, Ollama ile yerel AI, çevrimdışı lisanslama ve (varsa) neyin dışarı ulaşması gerektiği.
Günlük iş akışları
SRE'lerin her gün yaptığı işlerin adım adım tarifleri.
- Olay araştırmaÇağrı geldiği andan olayı çözene kadarki tam SRE oyun kitabı. Tıklamalar sırasıyla, kelimelerle ekran görüntüleri.
- SLO + alarmlarSLO hedefi nasıl seçilir, Orbtrace'te nasıl tanımlanır ve yanında gelen dört pencereli yanma alarmları nasıl bağlanır. HTTP API için örnek SLO içerir.
- Replay çalıştırAdım adım örnek. Gerçek bir olay alıp (deploy sonrası yavaş checkout) varsayımı sorup sonucu okuyacağız.
Referans
Arama söz dizimi, sorun giderme, sık sorulan sorular.
- Arama söz dizimiLoglar, Trace'ler arama çubuklarında, Metrik filtrelerinde ve alarm kuralı editöründe kullanılan tam sorgu dili. Her yerde aynı söz dizimi.
- Sorun gidermeBir şey bozuk durumlarında semptomdan çözüme karar ağacı. Veri yok, kısmi veri, yavaş arayüz, AI hataları, giriş sorunları, container çöküşleri.
- SSSHer aday ve yeni operatörün ilk hafta sorduğu sorular. Her biri tek paragrafta yanıtlanmış.
- Webhook doğrulamaBir alarm webhook'unun gerçekten Orbtrace örneğinizden geldiğini doğrulayın — HMAC-SHA256 imzası, zaman-damgası kayma kontrolü ve idempotency-key tekilleştirmesi. Node, Python, Go ve Java için alıcı kod parçaları.
- Span birleştirmeOrphan span'leri yeniden bağlayan async-stitching motorunu ayarlayın — zamanlayıcı periyodu, aday pencereleri, güven eşiği ve üç skorlayıcı ağırlığı. Ayrıca motoru kapatmanın iki ayrı yolu ve hangisini ne zaman kullanacağınız.