Sağlık tablosu
Kurulumdaki her servis: ne yaptığı, kapalıyken nelerin durduğu, sağlığını bildiren uç nokta ve tetiklenen bulgu.
- Sürüm: 0.4
- Rol: admin_user, viewer
- Tür: başvuru
Kurulumdaki her servis için bir satır. Bir olay sırasında okunması gereken sütun Ne durur sütunudur: bazı servisler, ürün hizmet vermeye devam edecek biçimde arızalanır. Kapalı olan bir kapsayıcının kullanıcının bildirdiği belirtiyle her zaman örtüşmemesinin nedeni budur.
Port, profil, bellek sınırı ve imaj bilgilerini içeren tam tablo, kurulum tanımından üretilir: bkz. Servisler, portlar ve profiller. Bu sayfa neyin bozulduğunu ve ne yapılacağını ekler.
Sağlık nasıl ölçülür
Anlık görüntü iki ayrı şey bildirir ve bunların uyuşmaması işe yarar bir bilgidir:
- Kapsayıcı sağlığı,
containersbölümündeki, kurulumun kendi sağlık denetimidir. Sürecin ayakta olup olmadığını söyler. - Servis sağlığı,
servicesbölümündeki, servisin kendi uç noktasıdır. Servisin işini yapabilip yapamadığını söyler. Bir kapsayıcı çalışırken modeli yüklenememiş olabilir.
Her servis satırı aynı biçimde ölçülür — tek istek, üç saniyelik sınır, hepsi paralel — bu nedenle gecikme değerleri birbiriyle karşılaştırılabilir. Dağıtılmamış bir servis, sağlıksız olarak bildirilmek yerine haritada hiç bulunmaz.
İstek yolu — tespit servisleri
Bunlar eşzamanlı yolda çalışır. Biri kapalıyken yaptığı tespit hiç gerçekleşmez; sonradan yeniden denenmez.
| Servis | Ne yapar | Kapalıyken ne durur | Sağlık uç noktası | Bulgu |
|---|---|---|---|---|
nestjs-core | Ağ geçidi: sohbet, tespit, yönetim API'si, ICAP dinleyicisi | Her şey. Pano yüklenir ve her çağrı başarısız olur — anlık görüntünün kendisi de toplanamaz, çünkü onu ağ geçidi sunar | GET /health | yok: bunun yerine kapsayıcının durumunu ve yeniden başlatma sayısını okuyun |
ml-detector | Adlandırılmış varlıklar üzerinde makine öğrenmesiyle kişisel veri tespiti | ML tabanlı kişisel veri tespiti. Regex desenleri çalışmayı sürdürür, dolayısıyla maskeleme durmaz, zayıflar | GET /api/v1/health | service-unhealthy-ml-detector |
hap-guard-v2 | 13 etiket üzerinden zararlı içerik sınıflandırması | Girişte ve çıkışta zararlı içerik tespiti | GET /health | service-unhealthy-hap-guard-v2 |
attack-guard | Jailbreak ve enjeksiyon sınıflandırması, ayrıca SQL ve betik enjeksiyonu taraması | Jailbreak ve enjeksiyon tespiti | GET /api/v1/jailbreak/health | service-unhealthy-attack-guard |
language-detector | Tespitten önce dil belirleme | Otomatik dil seçimi. Tespit, yapılandırılmış varsayılanla sürer | GET /health | service-unhealthy-language-detector |
Danger
Kapalı bir tespit servisi kapalı kalarak başarısız olmaz. Kesinti süresince maskelenecek ya da engellenecek olan trafik maskelenmemiş ve engellenmemiştir; geriye dönük bir tarama da yoktur. Bu nedenle her tespit servisi kesintisinden sonra o zaman aralığında ağ geçidinden neyin geçtiğini gözden geçirin.
İçerik servisleri
| Servis | Ne yapar | Kapalıyken ne durur | Sağlık uç noktası | Bulgu |
|---|---|---|---|---|
ocr-service | Görsellerden metin çıkarma | Görsel analizi hiç metin döndürmez, dolayısıyla ekran görüntülerindeki kişisel veriler görülmez | GET /api/v1/health | service-unhealthy-ocr-service |
document-parser | PDF ve Office belgelerinden metin çıkarma | Belge analizi | GET /api/v1/health | service-unhealthy-document-parser |
redactor | Görsel ve belgelerde maskeleme | Maskelenmiş indirmeler. Tespit, bulduklarını bildirmeyi sürdürür | GET /api/v1/health | service-unhealthy-redactor |
doc-classifier | Görsel belge sınıflandırması | Güçlü görsel sınıflandırıcı. Görsel yolu, metin tabanlı sınıflandırmaya ve makine tarafından okunabilir bölge tespitine geri düşer | GET /health | service-unhealthy-doc-classifier |
hallucination-guard | Bağlam taşıyan yanıtlarda dayanak denetimi | Halüsinasyon puanlaması. Bu, yanıtın arkasında çalışır; kullanıcılar bir değişiklik görmez | GET /api/v1/health | service-unhealthy-hallucination-guard |
report-renderer | Uyumluluk raporlarının PDF ve HTML olarak oluşturulması | Rapor dışa aktarımı. Veriler ekranda durmayı sürdürür | GET /health | service-unhealthy-report-renderer |
Maliyet ve analiz servisleri
| Servis | Ne yapar | Kapalıyken ne durur | Sağlık uç noktası | Bulgu |
|---|---|---|---|---|
prompt-compressor | Sağlayıcı çağrısından önce giriş token sayısını azaltır | Token azaltma. İstekler sağlayıcıya sıkıştırılmadan gider ve daha pahalıya mal olur | GET /health | service-unhealthy-prompt-compressor |
cost-analyzer | İstek geçmişinden model yönlendirme politikasını üretir | Yönlendirme önerileri ve öngörülen tasarruf | GET /health | service-unhealthy-cost-analyzer |
risk-analyst | Tekrar eden tespitleri inceleyen yerel model analisti | Analist incelemeleri. Yalnızca hem yerel model hem veritabanı araç sunucusu yanıt verdiğinde kendini sağlıklı bildirir | GET /health | service-unhealthy-risk-analyst |
mcp-server | Analist için salt okunur veritabanı erişimi | Ona bağımlı olan analist | GET /healthz | service-unhealthy-mcp-server |
llm-inference | Analistin kullandığı yerel modeli sunar | Analist | Analistin kendi sağlığı üzerinden bildirilir | service-unhealthy-risk-analyst |
deepteam | Kırmızı takım testlerinin çalıştırılması | Filtre testi koşuları | GET /health | service-unhealthy-deepteam |
code-safety | Ağ geçidinin çağırdığı dış kod denetleyicisi | Code Safety kararları. Diğer her şey çalışmayı sürdürür | GET /api/v1/code/health | service-unhealthy-code-safety |
Platform
Bunların kendilerine ait bir uygulama sağlık uç noktası yoktur. Onları containers ve
datastores bölümlerinden okuyun.
| Bileşen | Ne yapar | Kapalıyken ne durur | Nereden okunur | Bulgu |
|---|---|---|---|---|
postgres | Kalıcı her kayıt: kiracılar, kimlik bilgileri, filtreler, tespitler, oturumlar, olaylar | Fiilen her şey. Listeler hata vermek yerine boş döner | datastores.postgres | datastore-unreachable, migrations-pending |
redis | Hız sınırı sayaçları ve küme kilidi | Hız sınırlama açık kalarak zayıflar ve zamanlanmış işler durur. İstekler akmayı sürdürdüğü için sağlıklı görünür | datastores.redis | datastore-unreachable |
caddy | Panonun ve ağ geçidinin önünde 80 ve 443'ü sonlandırır | Dışarıdan bakınca her şey. 443'te hiçbir şey yanıt vermez | appliance.tls.servedBy | tls-443-not-served |
frontend | Pano | Pano. API kendi istemcilerine hizmet vermeyi sürdürür | containers kaydı | container-restarting |
cid-proxy | Ağ geçidinin önünde kimlik doğrulama ve yönlendirme | Topolojiye göre, üzerinden yönlendirilen ne varsa | containers kaydı | container-restarting |
reconfigure-agent | Ana makine ajanı: ana makine onarımı, tespit servisi yeniden ayarı ve anlık görüntüdeki ana makine ile kapsayıcı verileri | Ana makine onarımı ile anlık görüntünün host ve containers bölümleri | host null okunur | yok — anlık görüntü ölçemediği konuda sessiz kalır |
İsteğe bağlı kenar bileşenleri
| Bileşen | Ne yapar | Kapalıyken ne durur | Nereden okunur | Bulgu |
|---|---|---|---|---|
cid-inline-proxy | İstemci trafiğini çözen ve inceleme dinleyicisini çağıran ileri yönlü vekil sunucu | Tarayıcı trafiğinin satır içi incelenmesi | containers kaydı | container-restarting |
cid-userid-agent | Trafiği dizin kullanıcılarına atfeder | İncelenen trafikte kullanıcı atfı; tespitler adresi kaydetmeyi sürdürür | GET /healthz | service-unhealthy-userid-agent — anlık görüntü bu servisi userid-agent olarak anahtarlar |
ocr-service-gpu | OCR servisinin GPU derlemesi | Fazladan hiçbir şey — kart bulunan yerde CPU OCR servisinin yerini alır | containers kaydı | container-oom |
Destek araçları
Bunlar müşteri cihazında hiçbir zaman çalışmaz. Geliştirme ve laboratuvar çalışmaları için vardırlar; üretim makinesinde bunlardan birine ilişkin bir bulgu, yanlış profilin başlatıldığı anlamına gelir.
| Bileşen | Ne yapar |
|---|---|
pgadmin | Veritabanı tarayıcısı |
redis-commander | Redis tarayıcısı |
mailpit | Test sırasında giden postayı yakalar |
openldap-test | Entegrasyon testi için bir dizin |
Olay sırasında bir satır nasıl okunur
- Servisi anlık görüntünün
servicesbölümünde bulun. Orada yoksa dağıtılmamış demektir — bu bir arıza değildir. reachablefalse ise sorun uygulamanın altındadır: kapsayıcının durumunu ve yeniden başlatma sayısını okuyun. service-unhealthy adımlarını izleyin.reachabletrue vehealthyfalse ise hatayı okuyun. Olağan yanıt yüklenememiş bir modeldir; ağdan yalıtılmış bir cihazda ise olağan servis OCR servisidir — bkz. ocr-models-missing-airgapped.- Kapsayıcı bellek nedeniyle sonlandırıldıysa kusur serviste değil makinededir: container-oom.
İlgili sayfalar
- Tanılama anlık görüntüsü — anlık görüntünün taşıdığı her anahtar.
- Rehberli çalışma kitapları — her arıza için kontrol listesi.
Son güncelleme