XPROXY

Gerçek Zamanlı Telemetri Log Akışı

XProxy sunucunuzdaki proxy erişim günlüklerini gerçek zamanlı olarak Graylog veya SigNoz'a aktarın — birden fazla cihazı tek yerden izleyin, panolar oluşturun ve hatalar için uyarı alın.

Neden merkezi günlük akışı kullanmalısınız?

  • Birleşik izleme — tüm XProxy düğümlerinde erişimi ve sağlık durumunu gerçek zamanlı izleyin.
  • Kolay sorgulama — cihaz, bölge, eylem veya hata koduyla filtreleyin.
  • Daha hızlı sorun giderme — hataları, trafik ani artışlarını veya anormal davranışları hızla yalıtın.
Yapılandırma konumu: XProxy → Genel Ayarlar → Telemetri Günlükleri. Desteklenen sağlayıcılar: Graylog (GELF UDP) ve SigNoz (OTLP/HTTP).

Önerilen etiketleme

  • Ana Bilgisayar Tanımlayıcısı — sunucu başına ad, ör. sg-core-01, us-east-02.
  • Hizmet Adı — bölge veya iş birimine göre gruplama, ör. xproxy-region-a.

Her günlük bu etiketleri taşır; bu da pano ve cihazlar arası filtre oluşturmayı kolaylaştırır.

Seçenek A — Graylog

Graylog Kurulumu

Gereksinimler: Ubuntu Server 20.04 veya 22.04, en az 2 GB RAM (4 GB önerilir).

bash
curl x-proxy.io/graylog | bash
Graylog kurulumu

GELF UDP girişi oluşturma

  1. Graylog → Sistem → Girişler bölümünü açın.
  2. GELF UDP'yi seçin ve Yeni giriş başlat'a tıklayın.
  3. Bind adresini 0.0.0.0 ve Portu 12201 olarak ayarlayın.
  4. Kaydet'e tıklayın.
Graylog GELF UDP girişi

XProxy'yi Graylog için yapılandırma

  1. Genel Ayarlar → Telemetri Günlükleri bölümünü açın.
  2. Telemetriyi Etkinleştir anahtarını AÇIK konuma getirin.
  3. Sağlayıcıyı Graylog olarak ayarlayın.
  4. Graylog Sunucusu'nu YOUR_GRAYLOG_IP:12201 olarak girin.
  5. Ana Bilgisayar Tanımlayıcısı ve Hizmet Adı'nı ayarlayın (isteğe bağlı ancak önerilir).
  6. Kaydet'e, ardından Bağlantıyı Test Et'e tıklayın.
XProxy Graylog yapılandırma formu

Graylog sorgu örnekleri

graylog query
# By service/cluster
service_name:xproxy-region-a

# Only errors
error_code:!00000

# By action
action:CONNECT

# By device/slot
modem_position:3
Graylog arama sonuçları

Seçenek B — SigNoz

SigNoz Kurulumu (Topluluk)

Gereksinimler: Ubuntu Server 20.04, 22.04 veya 24.04. SigNoz Cloud kullanıyorsanız atlayın.

bash
curl x-proxy.io/signoz | bash
SigNoz kurulumu

XProxy'yi SigNoz için yapılandırma

  1. Genel Ayarlar → Telemetri Günlükleri bölümünü açın.
  2. Telemetriyi Etkinleştir anahtarını AÇIK konuma getirin ve Sağlayıcı olarak SigNoz'u seçin.
  3. OTLP/HTTP Uç Noktası'nı girin, ör. https://ingest.us.signoz.cloud:4318.
  4. Toplama Anahtarı'nızı yapıştırın (SigNoz Cloud) veya yerel kurulumlar için boş bırakın.
  5. Hizmet Adı'nı ayarlayın (ör. xproxy-region-a).
  6. Kaydet'e, ardından Bağlantıyı Test Et'e tıklayın.
XProxy SigNoz yapılandırma formu

SigNoz sorgu örnekleri

signoz query
# By service name
service.name = "xproxy-region-a"

# Only errors
attributes.error_code != "00000"

# By action
attributes.action = "CONNECT"

# By device/slot
attributes.modem_position = 3
SigNoz Günlük Gezgini

Günlük alanı başvurusu

AlanAçıklama
log_dateGünlüğün tarihi (DD/MM)
log_timeGünlüğün saati (HH:MM:SS)
proxy_serviceHizmet grubu adı (ör. MAIN)
modem_positionİsteği karşılayan cihaz/yuva dizini
proxy_protocolHTTP veya SOCKS5
proxy_portXProxy üzerindeki proxy dinleme bağlantı noktası
proxy_userKimlik doğrulama için kullanılan kullanıcı adı (IP beyaz listesinde boş)
client_ipProxy'yi kullanan istemcinin IP adresi
destination_hostProxy üzerinden istenen hedef ana bilgisayar
destination_portHedef bağlantı noktası
actionCONNECT (tünel) veya ACCESS (HTTP isteği)
error_code00000 = başarılı; sıfır değilse = hata
received_bytesHedeften istemciye gönderilen bayt
sent_bytesİstemciden hedefe gönderilen bayt

Hata kodu başvurusu

  • 00000 — Başarılı (bağlantı normal şekilde kapatıldı)
  • 00001–00009 — Kimlik doğrulama hataları (ACL/kullanıcı adı/parola)
  • 00010 — Trafik sınırı aşıldı
  • 00011–00019 — Bağlantı hataları (soket/bind/connect)
  • 00020–00029 — Dahili hatalar (ör. bellek tahsisi)
  • 00030–00039 — HTTP CONNECT proxy yönlendirme hataları
  • 00050–00069 — SOCKS5 proxy yönlendirme hataları
  • 00090–00099 — Bağlantı zaman aşımları / ağ sorunları
  • 00100 — Ana bilgisayar bulunamadı
  • 00200–00299 — UDP port eşleyici hataları
  • 00300–00399 — TCP port eşleyici hataları
  • 00400–00499 — SOCKS proxy hataları
  • 00500–00599 — HTTP proxy hataları

Sorun Giderme

  • Veri yok — telemetrinin etkin olduğundan ve Kaydet'e tıkladığınızdan emin olun. Herhangi bir proxy bağlantı noktası üzerinden trafik oluşturun.
  • Graylog — GELF UDP girişinin 12201 bağlantı noktasında çalıştığını ve güvenlik duvarının UDP 12201'e izin verdiğini doğrulayın.
  • SigNoz — uç nokta 4318 bağlantı noktasını içermeli ve HTTPS üzerinden erişilebilir olmalıdır. Toplama anahtarını ve çalışma alanı bölgesini doğrulayın.