Orbtrace
ENTR
Satışla görüş
Self-host

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.

Ortamınıza uyan dağıtım yolunu seçin. Her biri aynı sonuçla biter: Orbtrace donanımınızda çalışır, 8080 portunda erişilebilir ve İlk giriş'e hazırdır.

Başlamadan önce bilmeniz gereken tek şey

Orbtrace ürünü gönderir — sunucu, UI ve depolama. Telemetriyi kendisi almaz ve bir OpenTelemetry Collector paketlemez. Kurulumdan sonra, veriyi Orbtrace'in veritabanına ileten bir Collector ayağa kaldırırsınız (tek bir docker run ya da mevcut hattınızda bir blok). Bkz. Entegrasyon desenleri. Bu sayfalar Orbtrace'i çalıştırır; Collector hemen sonraki adımdır.

Hangi yolu istediğinize karar verin

Ne kadar büyük kuracağınızdan emin değil misiniz?

Bir yol seçmeden önce Kapasite planlama'yı çalıştırın — günlük hacminizi, saklamayı ve servis sayınızı girin; Helm boyutlandırmasını, Doris FE/BE sayılarını, sağlanacak vCPU / bellek / diski ve yapıştırmaya hazır bir my-values.yaml overlay'ini döndürür. Apache Doris'in yayınlanmış dağıtım rehberliğine dayanır.

Tüm yollar aynı çalışan Orbtrace ile biter. Fark, nerede çalıştığı ve ne kadar ölçeklendiğidir:

YolEn uygunuNe çalıştırırÖlçek
Docker ComposeÖnerilen varsayılan — tek-host üretim ve en hızlı değerlendirme yoluTek makinede, tek komutla her şey — uygulama + Doris + Postgres + Valkey, birbirine bağlıTek host
Kubernetes (Helm)Zaten Kubernetes işleten, HA ve büyük hacim gereken ekiplerDurumsuz uygulama küme içinde; Doris'i (ve önerilen şekilde Postgres'i) siz sağlarsınızÇok node
Bare metal (Ansible)Sizin için kurulup yönetilmesini istediğiniz tek bir Linux hostCompose yığını, bir systemd servisi olarak kurulup çalıştırılırTek host
Bulut (EKS / AKS / GKE)AWS, Azure ya da GCP'de yönetilen bir Kubernetes kümesiSağlayıcının yönetilen Postgres ve deposuyla Helm yoluÇok node

Docker Compose yalnızca test için mi? Hayır. Tüm yığını — Doris dahil — tek komutla ayağa kaldırır; bu da onu hem Orbtrace'i denemenin en hızlı yolu hem de küçük-orta hacimler için gayet iyi bir tek-host üretim dağıtımı yapar. Helm'e yalnızca bir Kubernetes kümesi üzerinde yatay ölçeklenmeniz gerektiğinde geçin; Ansible'ı ise aynı tek-host yığınının sizin için kurulup yönetilmesini istediğinizde kullanın.

Ön koşullar — tüm yollar için geçerli

  • Linux (Ubuntu 22.04+ / Debian 12+ / RHEL veya Rocky 9+ test edildi). macOS yalnızca Docker Compose için, geliştirme amaçlı çalışır.

  • CPU: en az 4 çekirdek, 8 önerilir.

  • RAM: varsayılan yığın için en az 8 GB, 16 GB rahat. Ciddi iş yükleri için Doris node başına 32 GB+.

    '4 GB minik VPS' iddiası hakkında

    Varsayılan yığın Apache Doris'i üç depolama node'u ile çalıştırır; bu tek başına birkaç GB ister. 4 GB bunun için yeterli değildir. 4 GB'lık bir makine, gönderilen Compose dosyasının kutudan sağlamadığı, azaltılmış tek-Doris-node ayak izi ister — Doris'i bilerek kısmadıysanız 8 GB'ı gerçek taban kabul edin.

  • Disk: Doris veri dizini için SSD kesinlikle önerilir. Sıkıştırmadan önce milyon span/gün başına yaklaşık 30 GB bütçeleyin (sonrasında ~3–5 GB).

  • Kernel (Doris bunu ister): vm.max_map_count ≥ 2000000 ve swap kapalı. Compose yığını bunları sizin için ayrıcalıklı bir init container'ıyla ayarlar; Ansible playbook'u host'ta ayarlar. Kubernetes'te bir node ayarıdır — bkz. Doris kurulumu.

  • Portlar:

    On screen
    • 8080Orbtrace backend + UI. Varsayılan olarak yayınlanır. Sizin ve ekibinizin açtığı adres budur.
    • 4317 / 4318OTLP gRPC / HTTP — Orbtrace tarafından değil, Collector'ınız tarafından açılır. Uygulamalarınız buraya gönderir. (Bkz. Entegrasyon desenleri.)
    • 8030 / 9030Doris FE — Stream Load (HTTP) ve MySQL wire. Yalnızca loopback'e bağlıdır; asla bir LAN'da açığa çıkarmayın.
    • internalPostgreSQL (ayarlar) ve Valkey (önbellek) hiç yayınlanmaz — yalnızca yığının ağı içinden erişilebilir.
    • 80 / 443Yalnızca HTTPS için önüne bir ters proxy koyarsanız — opsiyonel Caddy edge profili, kendi Nginx'iniz ya da Helm Ingress. Varsayılan olarak açılmaz.

Hacme dayalı boyutlandırma için (Doris FE/BE sayıları, CPU/bellek/disk) bkz. Kapasite planlama.

Yolunuzu seçin

Kurulum-sonrası kontrol listesi

Herhangi bir yoldan sonra, başkalarını içeri almadan önce şunları yapın:

  1. PGPASSWORD'ün placeholder olmadığını doğrulayın (Compose sizi onunla açılmaktan alıkoymaz). DORIS_PASSWORD bilerek boş kalır — pakete dahil Doris'in root hesabı parolasızdır, onu "düzeltmeyin".
  2. Kimlik doğrulamayı kurun — en az bir SSO sağlayıcısı bağlayın; bkz. Kimlik doğrulama.
  3. Varsa lisansınızı uygulayın — Admin → License ya da ORBTRACE_LICENSE_KEY. Olmadan ücretsiz COMMUNITY sürümündesiniz (3 servis / 3 gün saklama). Bkz. Lisanslama.
  4. Bir Collector ayağa kaldırıp veri aktığını kanıtlayın — Entegrasyon desenleri, sonra Uygulamalarınızı enstrümante edin ile gerçek bir servisi ona yönlendirin.
  5. TLS'i sonlandırın — Caddy edge profili, kendi ters proxy'niz ya da Helm Ingress tls.
  6. RCA / Replay istiyorsanız bir AI sağlayıcısı seçin — Admin → AI (bkz. Admin ekranları).
  7. Yedekleri kurun — Kubernetes'te chart'ın backup.* CronJob'larını etkinleştirin (Postgres pg_dump + Doris snapshot). Compose/Ansible'da bir Postgres pg_dump'ı ve bir Doris BACKUP SNAPSHOT'ı zamanlayın.

Bir adım takılırsa Sorun giderme'ye atlayın.

ÖncekiHızlı başlangıçSonrakiKapasite planlama