Tower ve sürekli metrikler

Tower, ağınızdaki bir makinede çalışan küçük bir ağ geçididir. Sunucu ve veritabanı Collector'ları (ya da kendi OpenTelemetry Collector'ınız) metriklerini Tower'a OTLP/HTTP ile gönderir; Tower bunları tek bir giden bağlantıyla kontrolcüye iletir. Kontrolcü metrikleri kendi PostgreSQL'inde tutar, koşu sonuçlarının yanında görebilirsiniz.

• Tower yalnız kontrolcüye bağlanır. Ağınıza dışarıdan bağlantı açılmaz, internet çıkışı gerekmez.
• Kontrolcüye ulaşamazsa gelen metrikleri diskte tutar (varsayılan 1 GB / 24 saat) ve bağlantı gelince sırayla iletir. Tampon dolarsa en eskisi atılır ve sayılır.
• Her ağ bölgesine (veri merkezi, DMZ, bulut VPC) bir Tower yeterlidir.

Sayfa: Tower'lar ve metrikler Spitfire'da: /towers (yalnız kurulum yöneticisi).

#Metrikleri açmak

1. Tower'lar ve metrikler sayfasında Metrikleri topla ve sakla anahtarını açın.
2. Metriklerin veritabanında yer kaplayacağını onaylayan kutuyu işaretleyin. Kim, ne zaman açtı kaydedilir.
3. Saklama süresi girin. Lisansınızın tavanını aşamazsınız:

4. Depolama bütçesi (GB) girin. %80 dolunca uyarılırsınız, %90 dolunca yeni metrik yazılmaz.
5. Kaydet.

#Tower kurulumu

1. Tower ekle → ad (ör. istanbul-dc) ve isteğe bağlı bölge girin.
2. İki token yalnız bir kez gösterilir, ikisini de saklayın:
   • sftower_…: Tower'ın kendi token'ı (SPITFIRE_TOWER_TOKEN).
   • sfcol_…: Tower'a gönderen Collector'ların token'ı (Authorization: Bearer sfcol_…).
3. Tower makinesinde verilen Docker komutunu çalıştırın:

docker run -d --name spitfire-tower --restart unless-stopped -p 4318:4318 \
  -v spitfire-tower:/var/lib/spitfire-tower \
  -e SPITFIRE_TOWER_CONTROLLER=https://<kontrolcü> \
  -e SPITFIRE_TOWER_TOKEN=sftower_... \
  <spitfire imajı> spitfire-tower

4. Listede durum Bağlı olur (ilk bağlantı birkaç saniye sürer).

Tower ayarları (ortam değişkeni):

#Sunucu ve PostgreSQL metrikleri (Collector)

Spitfire, resmi OpenTelemetry Collector Contrib (otel/opentelemetry-collector-contrib:0.164.0) için hazır bir config üretir. Collector'ı izlenecek sunucuya kurun; PostgreSQL'e ağdan bağlanabildiği sürece veritabanını da aynı Collector okur.

1. Tower'lar ve metrikler → Collector config.
2. Tower adresi: Tower aynı makinedeyse http://localhost:4318, değilse http://<tower-makinesi>:4318.
3. Bu sunucunun metrikleri kutusu: CPU, bellek, disk, ağ, yük, dosya sistemi.
4. PostgreSQL ekle: adres (db.corp:5432), kullanıcı (varsayılan spitfire_monitor), veritabanları (boş: hepsi), TLS.
5. Docker ya da otelcol-contrib binary seçin → Config üret.
6. collector.yaml dosyasını Collector makinesine kaydedin.
7. İzleme kullanıcısını PostgreSQL'de bir yönetici ile oluşturun:

CREATE ROLE spitfire_monitor WITH LOGIN PASSWORD '<password>';
GRANT pg_monitor TO spitfire_monitor;

8. Verilen komutu env'leri doldurarak çalıştırın:

docker run -d --name spitfire-collector --restart unless-stopped --network host --pid host \
  -v /:/hostfs:ro -v "$PWD/collector.yaml:/etc/otelcol-contrib/config.yaml:ro" \
  -e SPITFIRE_COLLECTOR_TOKEN=<sfcol_…> \
  -e SPITFIRE_PG_PASSWORD=<password> \
  otel/opentelemetry-collector-contrib:0.164.0

9. Bir dakika içinde sunucu ve veritabanı Kaynaklar listesinde görünür.

#Koşu raporunda

Bir test koşusu sürerken metrik gönderen her sunucu ve veritabanı, koşunun Backend sekmesinde Tower metrikleri kaynağı olarak görünür; bunun için teste bağlantı eklemeniz gerekmez:

• Sunucu: CPU %, bellek %, yük (1 dk), disk I/O, ağ I/O.
• Veritabanı: bağlantılar, bağlantı / en fazla %, commit/s, rollback/s, deadlock/s, satır işlemleri/s.

Her değer aşama (ramp, plato…) ortalaması olarak tabloda, zaman içinde grafik olarak çizilir.

#Kendi Collector'ınızı bağlamak

Kendi OpenTelemetry Collector'ınızın ayarına bir exporter ekleyin (<tower> yerine Tower makinesinin adresi):

exporters:
  otlphttp/spitfire:
    endpoint: http://<tower>:4318
    headers:
      Authorization: "Bearer sfcol_..."
service:
  pipelines:
    metrics:
      exporters: [otlphttp/spitfire]

Collector yeniden başlatıldıktan sonra kaynak Kaynaklar listesinde görünür. Sunucular host.name ile, veritabanları server.address[:port] (yoksa host.name) ile sayılır.

#Lisans sınırları

Planınız kaç sunucu ve veritabanının metriğini alabileceğinizi belirler:

Growth ve Scale'e ek paket alınabilir: +10 sunucu ya da +5 veritabanı (Lisans sayfası → Ek paket al). Sınıra gelince yeni kaynaklar alınmaz ve sayfada listelenir. Kullanmadığınız bir kaynağı Kaynaklar listesinden silerek yer açabilirsiniz; Collector göndermeye devam ederse kaynak yeniden oluşur.

#Sorun giderme