# Sorun giderme Önce denetim kaydına bakın: her engelin `reason` ve `ruleId` alanı nedenini söyler ([Denetim kaydı](/docs/audit)). | Belirti | Olası neden | Çözüm | | --- | --- | --- | | Ağ geçidi açılmıyor: `could not reach AvertGate … to resolve policy` | Panel adresine ulaşılamıyor (ağ, proxy, yanlış taban adres). | Adresi ve ağ erişimini kontrol edin. Politika çözülemezse ağ geçidi bilerek başlamaz. | | Ağ geçidi açılmıyor: `rejected the API key or agent (HTTP …)` | API anahtarı ya da ajan anahtarı geçersiz, iptal edilmiş ya da ajan silinmiş. | Panelde ajanı ve anahtarları doğrulayın; gerekirse yeni anahtar üretin. | | Araç hep `BLOCK` alıyor | `unlisted_tools: deny`: politikada olmayan araç reddedilir. | Aracı sunucunuzun listelediği adla politikaya ekleyin. Önce `--shadow` ile gözlemleyin. | | Beklenmeyen `BLOCK` | Kısıt, egress taraması, loop breaker ya da yanıt taraması. | Kaydın `ruleId` değerine bakın (`dlp_exfiltration`, `loop-breaker`, `ingress_prompt_injection` gibi). | | Araç çalıştı ama ajan sonucu görmedi | Yanıt taraması sonucu şüpheli buldu; sonuç ajandan saklandı. | Kayıttaki "ingress scan detected …" nedenine bakın. Bkz. [Çalışma döngüsü](/docs/runtime-loop). | | Onay gelmiyor ya da hemen `BLOCK` | `SLACK_WEBHOOK_URL` var ama `APPROVAL_BASE_URL` yok; ya da 2 dakikalık süre doldu. | İki değişkeni de ayarlayın; süreyi `APPROVAL_TIMEOUT_MS` ile değiştirin. | | Politikayı değiştirdim, etkisi yok: `policy reload failed … keeping active policy intact` | Yeni dosya geçersiz; önceki politika kullanılmaya devam ediyor. | Hatayı düzeltin. Doğrulama için bkz. [Politika dosyası](/docs/policy-file). | | Panelde olay görünmüyor: `telemetry failed to reach cloud` veya `telemetry ingest returned HTTP …` | Panele bağlantı yok ya da anahtar reddediliyor. | Bağlantıyı ve API anahtarını kontrol edin. Araç çağrıları etkilenmez; yerel denetim kaydı yazılır. | | Denetim zinciri doğrulanmıyor | Kayıt dosyası değiştirilmiş ya da bozulmuş. | `avertgate verify` çalıştırın; zincir geçersizse sonucu raporlar ve çıkış kodu 1 olur. | > **Hata raporu hazırlarken**: Olay kaydındaki `reason`, `ruleId` ve zaman damgasını paylaşın. Politika dosyasını paylaşmadan önce içindeki sırları çıkarın.