Ürün Rehberi

Agent toplar

İzlenen sunucuda çalışır, veritabanına salt-okunur bir hesapla bağlanır ve host metriklerini /proc üzerinden okur.

gRPC ile gönderir

Tek bir giden TLS bağlantısı üzerinden (443/tcp) API'ye akış yapar. Agent hiçbir dinleme portu açmaz.

API işler ve saklar

Metadata PostgreSQL'e, zaman serisi metrikleri InfluxDB'ye yazılır; anomali, baseline ve korelasyon motorları burada çalışır.

UI gösterir

Aynı 443 portu üzerinden servis edilen web arayüzü; dashboard, alarm, RCA ve raporlar.

Kind + Helm

Ubuntu 24.04'e Kind, Helm ve komple ClusterEye stack'ini kurar.

1curl -sSL https://archive.clustereye.com/clustereye-stack-install.sh | bash

Bare-Metal Linux

Docker veya Kubernetes olmadan, doğrudan Linux üzerinde tam platform.

1curl -fsSL https://archive.clustereye.com/deploy/standalone/install.sh | sudo bash -s -- \
2  --api-version=VERSION --ui-version=VERSION \
3  --domain=YOUR_DOMAIN_OR_IP --postgres=local

Sadece Agent (Linux)

Mevcut bir ClusterEye sunucusuna bağlanan agent kurulumu.

1curl -sSL https://archive.clustereye.com/install.sh | sudo bash -s -- \
2  -p postgres --api-url <clustereye-host> --tls

Operatör başlatır

Alarm ya da incident panelinden tek tıkla. Otomatik tetikleme yoktur — hiçbir araştırma siz istemeden çalışmaz.

ClusterEye kanıt toplar

Yalnızca ClusterEye'ın zaten sakladığı veriler: alarm geçmişi, metrik serileri, olay ve değişiklik kayıtları, sorgu istatistikleri. Yeni bir veritabanı bağlantısı açılmaz.

Model plan yapar ve okur

Model hangi kanıtın gerektiğini söyler, sunucu izin verilen okuma araçlarını çalıştırır ve sonucu modele verir. Model SQL yazamaz, araç listesi dışına çıkamaz.

Sonuç kanıtla sunulur

Rakip hipotezler, her biri için destekleyen/çelişen kanıt numaraları, eksik kanıt listesi ve aksiyon önerileri. Yeterli kanıt yoksa motor bunu açıkça söyler.

Neyi okur

• Alarm ve incident kayıtları: ne zaman başladı, kaç kez tekrarladı, hangi alarmlarla birlikte görüldü, daha önce nasıl çözüldü.
• Metrik serileri ve öğrenilmiş normalleri (mevsimsel taban): CPU, bellek, bağlantı, bekleme süresi, depolama.
• Motor kanıtı: bloklama epizotları, deadlock kayıtları, yedek yaşı, replikasyon durumu, sorgu istatistikleri.
• Olay akışı: konfigürasyon değişiklikleri, dağıtımlar, failover'lar, agent sağlığı.

Neyi asla yapmaz

• Veritabanınıza bağlanmaz. Araştırma sırasında hiçbir canlı sorgu çalıştırılmaz — bu bir ayar değil, sabit bir sınırdır.
• Modelin yazdığı hiçbir şey çalıştırılmaz. Model yalnız kayıtlı okuma araçlarını çağırabilir; SQL üretemez, yazamaz, uygulayamaz.
• Kendi kendine tetiklenmez. Zamanlanmış ya da alarm tetikli otomatik araştırma yoktur.
• Ham sorgu metni dışarı çıkmaz; veri satırlarınız hiçbir zaman modele gitmez.
• Modelin düşünme adımları saklanmaz — yalnız plan, çağrılan araçlar ve nihai sonuç kaydedilir.

Gider

• Alarm/incident meta verisi: tip, şiddet, düğüm, veritabanı adı, zaman damgaları, tekrar sayısı.
• Metrik özetleri: ortalama, tepe, son değer, örnek sayısı ve öğrenilmiş beklenen değerle farkı.
• Sorgu parmak izleri: fiil + ilk tablo + uzunluk. Literaller '?' ile değiştirilir (ör. "SELECT … dbo.Orders … (redacted, 162 chars)").
• Olay başlıkları ve konfigürasyon değişikliği özetleri.

Gitmez

• Tablolarınızdaki veri satırları — hiçbir araç satır okumaz.
• Ham SQL metni, bind değerleri, literaller.
• Parola, token, bağlantı dizesi: her mesaj modele ulaşmadan önce maskeleme katmanından geçer.
• Modelin gizli düşünme zinciri (kaydedilmez, arayüzde gösterilmez).

AI araştırması veritabanıma bağlanıyor mu?

Hayır. Araştırma yalnızca ClusterEye'ın daha önce topladığı ve sakladığı veriler üzerinde çalışır: alarm geçmişi, metrik serileri, olay kayıtları, sorgu istatistikleri. Canlı veritabanı çağrısı bütçesi sıfırdır ve yapılandırmayla açılamaz, dolayısıyla araştırma başlatmak üretim veritabanınıza ek yük bindirmez.

Verilerim dışarı çıkıyor mu? Air-gapped ortamda çalışır mı?

Model kendi altyapınızda çalışabilir: OpenAI uyumlu herhangi bir uç nokta (ör. kendi sunucunuzdaki vLLM) yeterlidir ve internet erişimi gerekmez. Bu kurulumda kanıt ağınızdan çıkmaz. Tercih ederseniz bulut sağlayıcı da tanımlanabilir; bu durumda modele giden veri yine alarm meta verisi, metrik özetleri ve sorgu parmak izleriyle sınırlıdır — veri satırlarınız ve ham SQL metni hiçbir koşulda gönderilmez.

Modele tam olarak ne gönderiliyor?

Alarm ve incident meta verisi, metrik özetleri (ortalama, tepe, beklenen değerden sapma), olay ve konfigürasyon değişikliği başlıkları ve sorgu parmak izleri. Sorgu metni gönderilmeden önce fiil + ilk tablo + uzunluk biçiminde özetlenir ve literaller kaldırılır. Parola, token ve bağlantı dizeleri her mesajda maskelenir. Tablolarınızdaki veri satırları hiçbir araç tarafından okunmaz.

AI kendi kendine bir şey yapabilir mi?

Hayır. Model yalnızca kayıtlı, salt-okunur araçları çağırabilir; SQL üretemez, çalıştıramaz ve hiçbir değişiklik uygulayamaz. Önerdiği aksiyonlar metin olarak sunulur ve riskli olanlar açıkça 'DBA onayı gerekir' olarak işaretlenir. Araştırma da kendiliğinden başlamaz — zamanlanmış veya alarm tetikli otomatik çalışma yoktur.

Araştırmayı kimler başlatabilir?

Admin ve DBA rolleri başlatabilir; Enterprise lisansta 'ai' özelliği ve kullanıcı başına AI kotası gerekir. Alarmı görebilen herkes sonucu okuyabilir ve 'faydalı / faydalı değil' geri bildirimi verebilir. Her araç çağrısı ve her araştırma, kimin başlattığıyla birlikte denetim kaydına yazılır.

AI yanlış bir kök neden söylerse ne olur?

Sonuç tek bir cevap değil, rakip hipotezlerdir: her biri destekleyen ve çelişen kanıt numaralarıyla, eksik kanıt listesiyle birlikte sunulur. Güven seviyeleri deterministik kurallarla sınırlanır — tek sinyale, yalnız geçmişe ya da çelişkili kanıta dayanan bir hipotez modelin iddiasından bağımsız olarak yüksek güven alamaz. Motor 'net bir kök neden yok' ya da 'kanıt yetersiz' diyebilir ve saklanmayan kanıtı uydurmak yerine 'kullanılamıyor' olarak bildirir.

Agent servisi ayakta mı?

Servis çalışıyor ama düğüm UI'da görünmüyorsa sorun neredeyse her zaman ağ ya da veritabanı kimlik bilgisidir.

1systemctl status clustereye-agent
2journalctl -u clustereye-agent -f --no-pager

API'ye bağlanabiliyor mu?

Agent sunucusundan çalıştırın. Cevap gelmiyorsa 443/tcp firewall kuralını kontrol edin; self-signed sertifika kullanıyorsanız agent'ı -k ile kurun.

1curl -sS -o /dev/null -w '%{http_code}\n' https://<clustereye-host>/api/v1/health

Veritabanı hesabı yeterli mi?

Baseline yetkiler verildiyse bu sorgu çalışır. Motorunuza göre eşdeğerini (Oracle: V$SESSION, MSSQL: sys.dm_exec_sessions) deneyin.

1psql -h <host> -U clustereye -c 'SELECT count(*) FROM pg_stat_activity;'

Sorgu zekâsı boş mu?

Metrikler geliyor ama sorgu listesi boşsa eksik olan neredeyse kesinlikle motor ön koşuludur: pg_stat_statements, Query Store, performance_schema veya log_queries.

1SELECT * FROM pg_extension WHERE extname = 'pg_stat_statements';