Sorun Giderme

Bulutta oturum görünmüyor

Pano
CLI

Administration → Keys bölümünü açın ve makine anahtarının etkin olduğunu ve events:add iznine sahip olduğunu doğrulayın. Ardından Observe → Events bölümünü açın, zaman aralığını genişletin ve ortam ile aracı filtrelerini temizleyin. Olaylar varsa, oturum kimliğini arayın ve Observe → Sessions bölümünde gruplandırmayı kontrol edin. Hiç olay yoksa, CLI’den Failproof daemon’ını tanılayın.

Canlı Events akışı, ana filtreleri ve yakın zamanda gelen aracı olayları görünüyor.

failproofai config --status
failproofai flush --wait --timeout 60
fp list envs
fp events --since 24h --limit 20
fp sessions --since 24h --limit 20

Yakalama işleminin etkinleştirildiğini, yapılandırılan anahtarın events:add iznine sahip olduğunu ve pano filtresinin yayılan ortamla eşleştiğini doğrulayın.

Python SDK olayları diskte kalıyor

Pano
CLI

Observe → Events bölümündeki filtreleri temizleyin ve tam SDK oturum kimliğini arayın. Hiçbir şey görünmüyorsa, kaynak makinedeki SDK spool’unu ve Failproof daemon’ını inceleyin.

failproofai config --status
failproofai flush --wait

Aracı işleminin AGENTEYE_SPOOL_TO_FAILPROOFAI=1 ayarladığını ve SDK başlamadan önce $FAILPROOFAI_HOME/custom-agents veya aksi takdirde ~/.failproofai/custom-agents dizininin mevcut olduğunu doğrulayın.

Makine politika almıyor

Pano
CLI

Admin → enforcement bölümünü açın, makinenin seçilmiş ve bildirilen sürümlerini karşılaştırın. Dağıtım kapsamının makinenin dahil edildiğini ve anahtarının policies:pull iznine sahip olduğunu doğrulayın. İngest, politika teslimatı yapılmadığında bile çalışabilir.

failproofai config --status
failproofai update
failproofai config --status

Makine kimliği ve etiketi ile pano hedefinin eşleştiğini doğrulayın. Mevcut kimlik bilgileri yalnızca olay alımı yetkisi veriyorsa, politika yeteneğine sahip bir anahtarla yeniden bağlanın.

Daemon kullanılamadığı için bir işlem reddediliyor

Pano
CLI

Admin → enforcement bölümünü açın ve makinenin son görülme zamanını ve bildirilen sürümünü inceleyin. Makine eski ise, bunu yerel daemon sorunu olarak değerlendirin. Kullanılamayan bir daemon’u atlatmak için yalnızca dağıtılan politikayı zayıflatmayın.

failproofai config --status
failproofai update
failproofai config
failproofai config --status

failproofaid yeniden başlatın veya güncelleyin; CLI ve daemon protokol sürümleri farklı olduğunda yapılandırmayı yeniden çalıştırın. Yapılandırılan daemon yolu tasarım gereği kapalı durumda başarısız olur.

Özel politika yüklenmiyor

Pano
CLI

Bulutta yazılan bir politika için, Admin → policy editor bölümünü açın, taslağı seçin ve yayınlamadan önce doğrulama hatalarını gözden geçirin. Yerel bir politika için, CLI ile doğrulayın, ardından bir test işleminden sonra kararların geldiğini doğrulamak için Observe → policy bölümünü açın.

Dosya adının policies.js, policies.mjs veya policies.ts ile bittiğini, modülün customPolicies.add(...) öğesini çağırdığını ve içe aktarmaların politika dosyasından çözümlendiğini doğrulayın.

failproofai policies --install --custom ./checkout.policies.ts
failproofai policies

Denetim sonuç bulamıyor

Pano
CLI

Analyze → audits bölümünü açın, çalıştırmayı seçin ve model analizi çalışıp çalışmadığını kontrol edin. Ardından kapsamı ve aralığını Observe → sessions ile karşılaştırın ve söz konusu popülasyondan temsilci izlemeleri açın.Sıfır sonuç, yalnızca analiz başarıyla çalıştırıldığında anlamlıdır. Analiz atlanırsa veya başarısız olursa, çalıştırma sonuç üretmez ve analiz edilmemiş aralığı gelecekteki başarılı bir çalıştırma için açık tutar. Model analizi devre dışıysa, denetim de sonuç üretmez çünkü belirleyici kimlik bilgileri ve PII taraması istatistik kaydeder ancak artık sonuç oluşturmaz.

Ortam, aracı, cadence ve tarama aralığının oturum popülasyonunu tanımladığı denetim formu.

fp audits show <audit-name>
fp audits runs <audit-name>
fp sessions --since 24h --env production
fp audits context-show <audit-name>
fp audits run <audit-name>
fp audits findings --audit <audit-name>

Çalıştırma sırada kalırsa, denetim aracı kapasitesini bekleyin veya denetim filosunu incelemesi için dağıtım operatöründen isteyin. Sıraya alınan bir denetim yeniden deneyin; hemen atlanmaz.

Çevrimiçi değerlendirmeler otomatik olarak çalışmıyor

Pano
CLI

Tamamlanmış bir oturumu açın ve manuel değerlendirmenin başarılı olup olmadığını kontrol edin. Barındırılan Bulut şu anda panoda değerlendirici uç nokta kontrolü yoktur; sunucu operatörü bunu yapılandırmalıdır.

Değerlendiricinin kendisini doğrulayın, ardından son değerlendirme durumlarını inceleyin:

curl https://evaluator.example.com/health
fp evals --since 1h

Kendi kendine barındırılan Bulut üzerinde, EVALUATOR_ENDPOINT sunucuda mevcut olduğunu ve EVALUATOR_TOKEN değerlendiricileri ile eşleştiğini doğrulayın. Uç nokta yoksa otomatik değerlendirme devre dışı bırakılır.

Bulut CLI kimlik doğrulaması yanlış kuruluşu hedeflemiş

Pano
CLI

Kuruluş değiştiricisini kullanın ve CLI ile sonuçları karşılaştırmadan önce beklenen slug’ı ve izinleri doğrulayın.

fp whoami
fp orgs current
fp orgs perms

API anahtarı modunda, fp --org <slug> --api-key <key> ... belirtin veya AGENTEYE_ORG ayarlayın. Kaydedilen İnsan oturumu kuruluş durumu, API anahtarı istekleri için kasıtlı olarak yoksayılır.

Bir politika geçerli çalışmayı engellemiş

Pano
CLI

Observe → policy bölümünü açın, kararı ve bağlantılı oturumu saklayın ve yanlış pozitif koşulunu tanımlayın. Ardından Admin → enforcement bölümünü açın ve etkilenen makineleri önceki sürüme geri alın. Policy editor bölümünde daha dar bir sürüm oluşturun, küçük bir kapsamda test edin ve geçerli çalışma başarılı olana kadar yalnızca genişletin.

Bulut dağıtımı geri alma yalnızca panoda kullanılabilir. Yerel oturum duraklatma, Bulut tarafından yönetilen politikaları devre dışı bırakmaz. Pano kullanılamıyorsa, makine ve dağıtım durumunu yakalayın ve engellenen işlemi tekrar tekrar yeniden denemek yerine pano erişimini geri yükleyin.

failproofai config --status

Connect your agents

Reference

HTTP API