Orbtrace

Veri depolarını sağlayın

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

Postgres ve Valkey'in her ikisi de varsayılan olarak gömülüdür (chart onları küme içinde çalıştırır) — yani en hızlı yol hiçbir şeyi değiştirmemek, yalnızca bir Postgres parolası vermektir. Üretim dayanıklılığı için ikisini de dışarı alabilirsiniz. Doris istisnadır: chart onu hiçbir zaman çalıştırmaz, dolayısıyla her zaman kendiniz sağlarsınız — onun kendi sayfası vardır, Doris kurulumu.

Bu `my-values.yaml` parçaları nereye gider

Bu sayfadaki YAML, my-values.yaml'ınıza gider — yalnızca değiştirdiğiniz anahtarları içeren küçük bir overrides dosyası. Tüm values.yaml'ı kopyalamazsınız: ./orbtrace'i kurduğunuzda (Helm ile kurun), Helm chart'ın kendi values.yaml'ını otomatik taban alır ve my-values.yaml'ınızı üstüne katmanlar (helm install ./orbtrace -f <boyut-preset> -f my-values.yaml). Bir depo gömülü kaldığında burada parolası dışında hiçbir şey ayarlamazsınız — chart onu kurar ve küme içi host/port'u otomatik bağlar.

Postgres + pgvector

Helm'de gömülü (varsayılan)

Kurulacak bir şey yok, yönlendirilecek bir şey yok: chart, Postgres+pgvector'ı küme içinde kurar ve ona otomatik bağlanır — host ya da port vermezsiniz. postgres.mode: bundled'yu (varsayılan) bırakın ve yalnızca bir parola ayarlayın:

my-values.yaml
postgres:
  mode: bundled
  password: guclu-bir-parola # zorunlu — ayarladığınız tek şey

Yapılandırmanın tamamı bu — host, port, veritabanı ve kullanıcı hepsi küme içi Service'ten türetilir; siz vermezsiniz. Çalışır duruma gelmenin en hızlı yolu budur ve değerlendirme ile küçük tek-küme dağıtımları için uygundur. Metadata (kullanıcılar, incident'lar, RCA vektörleri) yeniden üretilemez olduğu ve gömülü örnek tek replika olduğu için, üretimde dışarı alınmalıdır — aşağıda.

Harici — bir VM ya da yönetilen Postgres 18 (üretim için önerilen)

  1. Bir VM'e PostgreSQL 18 kurun ya da yönetilen bir örnek edinin (AWS RDS, Cloud SQL, Azure Database — hepsi vector uzantısını destekler).
  2. Veritabanını, bir oturum kullanıcısını oluşturun ve uzantıyı etkinleştirin. Aşağıdaki orbtrace adları yalnızca bizim geleneğimiz — istediğiniz veritabanı/kullanıcı adını seçin ve seçiminizi 3. adımda aynen kullanın. Superuser olarak (psql) bağlanıp çalıştırın:
    CREATE DATABASE orbtrace;
    CREATE USER orbtrace WITH PASSWORD 'guclu-bir-parola';
    GRANT ALL PRIVILEGES ON DATABASE orbtrace TO orbtrace;
    \c orbtrace
    CREATE EXTENSION IF NOT EXISTS vector;
  3. my-values.yaml'ınızda kendinize yönlendirin. Tek gereken postgres.mode: external — o önceliklidir, gömülü Postgres otomatik olarak kurulmaz:
    my-values.yaml
    postgres:
      mode: external
      host: pg.db.internal # kümeden erişilebilir
      port: 5432 # varsayılan — yalnızca sizinki farklıysa değiştirin
      database: orbtrace # 2. adımda hangi adı verdiyseniz o
      username: orbtrace # 2. adımda oluşturduğunuz kullanıcı
      password: guclu-bir-parola # ya da yerine existingSecret ayarlayın

Harici için en hızlısı, düz bir VM'de — tek bir Docker container

Tek bir container size pgvector'ı hazır gömülü Postgres verir:

docker run -d --name orbtrace-pg -p 5432:5432 \
  -e POSTGRES_DB=orbtrace -e POSTGRES_USER=orbtrace \
  -e POSTGRES_PASSWORD=guclu-bir-parola \
  pgvector/pgvector:pg18
docker exec orbtrace-pg psql -U orbtrace -d orbtrace \
  -c 'CREATE EXTENSION IF NOT EXISTS vector;'

Sonra yukarıdaki 3. adımdaki aynı postgres.* değerlerini ayarlayın (host = VM'in adresi).

Valkey (ya da Redis)

Orbtrace önbelleğe Redis protokolüyle konuşur, dolayısıyla bu Valkey ya da herhangi bir Redis-uyumlu sunucu olabilir — düz Redis de aynı şekilde çalışır. Chart'ın paketlediği imaj Valkey'dir.

Helm'de gömülü (varsayılan, önerilen)

valkey.mode: bundled'yu bırakın — yapılandıracak bir şey yok. Yalnızca önbellek tuttuğu için küme içinde tutmak üretimde bile uygundur.

Harici — Valkey ya da Redis (VM / yönetilen / Docker)

  1. Kümeden erişilebilir, Redis-uyumlu bir sunucu çalıştırın. Docker ile her iki imaj da çalışır:
    docker run -d -p 6379:6379 valkey/valkey:9-alpine
    # ya da düz Redis:
    docker run -d -p 6379:6379 redis:7-alpine
  2. my-values.yaml'ınızda kendinize yönlendirin. Tek gereken valkey.mode: external — o önceliklidir, gömülü Valkey otomatik olarak kurulmaz:
    my-values.yaml
    valkey:
      mode: external
      host: cache.db.internal # Valkey ya da Redis host'unuz
      port: 6379
      # password: "" # opsiyonel — kimlik doğrulamasız için boş bırakın

Apache Doris

Telemetri deposu — chart'a göre her zaman haricidir. Onu bir VM/yönetilen serviste, küme içi doris-operator ile ya da (değerlendirme için) hepsi-bir-arada Compose yığınıyla çalıştırın. Doris kurulumu tam adım adım anlatımdır: operatör kurulum komutları, uygulanacak testbed-doğrulamalı bir DorisCluster, node ön-koşulları ve kurmadan önce nasıl doğrulayacağınız. Sonra chart'ı doris.host ile ona yönlendirin.

Sıradaki: Doris kurulumu.