AiHummer
Türkçe▾
Oturum açHesap
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Operasyonlar/Gözlemlenebilirlik

Gözlemlenebilirlik

v1.2.x · güncellendi 2026-07-07

AiHummer gözlemlenebilirliğe sahip iki yüzey: geçit hizmet eder Prometheus GET /metrics temeller için kazıyabileceğiniz bir uçnokta ve isteğe bağlı olarak yapabilir telemetriyi OTLP üzerinden gönder yapılandırdığınız bir OpenTelemetry uç noktasına. Tarama /metrics temel izleme için; izler ve ayrıntılı metrikler için AiHummer’ı OTLP toplayıcınıza yönlendirin ve paketlenmiş Grafana panolarıyla verileri görselleştirin.

[!NOTE] pprof (/debug/pprof) dır değil maruz.

Prometheus /metrics uç nokta

GET /metrics Ekstra kurulum olmadan Prometheus metriklerini metin formatında sunar. Yalnızca hassas olmayan göstergeler açığa çıkar — yapı bilgisi, işlem çalışma süresi ve çalışma zamanı, veritabanı bağlantı havuzu durumu ve bir hazır olma göstergesi; kiracı verileri yok, sırlar yok, her istek için etiketler yok. İzler ve zengin metrikler için OTLP push kullanın.

OTLP itme

Telemetriyi açmak için tek bir değişken ayarlayın:

# gateway.env — export telemetry to your OTLP collector
AIHUMMER_OTEL_ENDPOINT=http://otel-collector:4317

ile AIHUMMER_OTEL_ENDPOINT ayarladığınızda, ağ geçidi telemetriyi o toplayıcıya gönderir. Oradan, arka ucunuza (Tempo, bir metrik deposu, loglar) ve Grafana’ya yönlendirin.

Panik ve hata yönetimi

Hata raporları hiçbir zaman dışarıya gönderilmez: ağ geçidinde harici bir hata izleyici istemcisi ve harici bir DSN yoktur — hatalarınıza ilişkin veriler asla kendi çevrenizden dışarı çıkmaz.

Yine de paniklere karşı dayanıklılık eksiksizdir:

  • bir HTTP işleyicisindeki panik, sıradan bir hata yanıtına dönüşür (AIH-… zarfını taşıyan bir 500) — süreç ölmez ve diğer istekleri sunmayı sürdürür;
  • arka plandaki bir goroutine içindeki panik de yakalanır ve ağ geçidini düşürmez.

Her iki durum da yapılandırılmış günlüğe düşer — bunları Günlükler sayfasında (aşağıda) veya journalctl ile okuyun.

Yönetici kullanıcı arayüzünde canlı kayıtlar

Yönetici arayüzü Günlükler sayfa, ağ geçidi günlüğünün canlı bir takibidir: yeni satırlar her birkaç saniyede otomatik olarak çekilir, en altta olduğunuzda otomatik kaydırma ile. Araç çubuğu bir çizgi arama ve bir seviye filtresi (tümü / hatalar / uyarılar / bilgi / hata ayıklama). Diğer birkaç sayfa (Gösterge Paneli, Oturumlar, Kanallar) da otomatik olarak yenilenir ve uzun listeler (denetim, değişiklikler, bildirimler vb.) “Daha fazla göster” düğmesi ile sayfa sayfa yüklenir.

Her hizmetin tam günlükleri hâlâ systemd’de yaşıyor — aihummer logs [unit] veya journalctl -u aihummer-gateway.

Grafana panoları

Hazır Grafana panoları sürümle birlikte gelir. Panelleri sıfırdan oluşturmadan operasyonel görünümleri elde etmek için bunları Grafana örneğinize aktarın.

Ne izlenir

Bunlar, sistemin sağlıklı olduğunu ve dönüşlerin akmakta olduğunu size söyleyen sinyallerdir:

Sinyal Neden önemli
Dönüş gecikmesi Ajan dönüşlerinin uçtan uca yanıt verebilirliği
Hata oranı Başarısız dönüşler / istekler — sorunun ilk belirtisi
Teslimat düzenlemeleri Yanıtların gerçekten kanallara ulaşıp ulaşmadığı
Bekleyen teslimatlar Teslim edilmeyen yanıtların birikmesi; sürdürülen büyüme, teslimatın takılı kalması demektir

Sürekli bir artış beklemede olan veya tekrarlayan başarısız teslimatlar teslimatın aksadığının en net erken uyarısıdır — dağıtımlar ve olaylar sırasında buna dikkat edin.

Sistem uç noktaları

OTLP’nin yanı sıra, geçit probe’lar, saatler ve istemci tanılama için faydalı küçük HTTP uç noktalarını açar:

Yöntem Uç nokta Amaç
GET /metrics Prometheus metrikleri (yapı, çalışma zamanı, DB havuzu, hazır olma)
GET /healthz Canlılık + sürüm
GET /readyz Hazırlık (Postgres’i kontrol eder; çalışmıyorsa 503)
GET /v1/ping Hafif erişilebilirlik kontrolü
GET /v1/time Sunucu zamanı
POST /v1/client-log İstemci tarafı günlük olaylarını al

Sağlık ve hazırlık kontrolleri aşağıda detaylı olarak ele alınmıştır systemd ve sağlık kontrolleri.

Sonra nereye?