> ## Documentation Index
> Fetch the complete documentation index at: https://docs.empiricintelligence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sorun giderme

> Kendi sandbox runtime kurulumlarınız için belirtiler, nedenler ve çözümler

Önce worker makinesinde worker'ın kendi tanılama komutunu çalıştırın:

```bash theme={null}
ei-worker doctor
```

## Köprü modu

| Belirti                                                                                                            | Olası neden                                                                                                              | Çözüm                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doctor` bulut erişilebilirlik kontrolünde başarısız oluyor                                                        | `https://api.empiricintelligence.com` adresine giden trafik engellenmiş veya `EI_WORKER_API_URL` yanlış                  | Worker makinesinden dışa doğru HTTPS trafiğine izin verin; URL'de yazım hatası olmadığını ve `https://` kullanıldığını doğrulayın                                                 |
| `doctor` anahtarı geçersiz veya yetkisiz olarak bildiriyor                                                         | Anahtar iptal edilmiş veya `EI_WORKER_RUNTIME_ID`, anahtarın üretildiği runtime ile eşleşmiyor                           | Her iki değeri de Empiric Intelligence temsilcinizin ilettiğiyle karşılaştırın; bir anahtar yalnızca kendi runtime'ı için geçerlidir                                              |
| Daemon hemen çıkıyor ve systemd onu yeniden başlatmıyor                                                            | **HTTP 426**: worker sürümü runtime için belirlenen alt sınırın altında                                                  | Empiric Intelligence temsilcinizin verdiği yeni wheel paketini kurun, ardından `systemctl restart ei-worker` çalıştırın                                                           |
| `doctor` saat sapması için uyarı veriyor veya başarısız oluyor                                                     | Makine saati 30 saniyeden (uyarı) veya 300 saniyeden (hata) fazla kaymış                                                 | Worker makinesinde NTP eşitlemesini düzeltin                                                                                                                                      |
| `doctor` platform erişilebilirlik kontrolünde başarısız oluyor                                                     | `E2B_DOMAIN`/`E2B_API_URL` yanlış, platform çalışmıyor veya intranet CA ile TLS doğrulaması başarısız                    | Platform değişkenlerini doğrulayın; özel bir CA için `SSL_CERT_FILE` ayarlayın (bkz. [Uyumluluk](/tr/runtimes/compatibility))                                                     |
| `doctor --probe` duraklatma kontrolünde başarısız oluyor                                                           | Platform, disk bütünlüğüyle duraklatmayı desteklemiyor (v0.5.0 öncesi CubeSandbox)                                       | Platformu yükseltin, ardından denetimi yeniden çalıştırın                                                                                                                         |
| `doctor --probe` anlık görüntü kontrolünde başarısız oluyor veya runtime `snapshot probe failed` hatası gösteriyor | Platform anlık görüntü alıp türetemiyor (v0.5.1 öncesi CubeSandbox) veya worker gerekli ağ politikası desteğinden yoksun | Platformu >= v0.5.1 sürümüne yükseltin ve `empiric-intelligence-worker==0.7.0` kurun, `doctor --probe` komutunu yeniden çalıştırın, ardından runtime için yeniden denetim isteyin |
| Empiric Intelligence'te runtime worker'ları çevrimdışı gösteriyor                                                  | Daemon çalışmıyor veya dışa çıkış trafiği kesilmiş                                                                       | Worker makinesinde `systemctl status ei-worker` ve `journalctl -u ei-worker` çalıştırın                                                                                           |
| Makine yük devretmesinden sonra işlemler belirsiz olarak bildiriliyor                                              | Yeni makinede, yeniden teslim edilen işlemlere ait günlük kaydı yok (bu bir hata değil, güvenlik davranışıdır)           | Her yük devretmede bir kez beklenen bir durumdur; aynı makinedeki yeniden başlatmaların sorunsuz kurtarılabilmesi için sonuç günlüğünü kalıcı depolamada tutun                    |

## Doğrudan mod

| Belirti                                                          | Olası neden                                                                                          | Çözüm                                                                                                                                                    |
| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Runtime `needs_credentials` durumunda takılı kalıyor             | Henüz API anahtarı girilmemiş                                                                        | Anahtarı, girilmek üzere Empiric Intelligence temsilcinize iletin                                                                                        |
| Runtime bir süre çalıştıktan sonra `error` durumuna geçiyor      | Platforma Empiric Intelligence bulutundan erişilemiyor veya anahtar platform tarafında değiştirilmiş | Platformun erişilebilirliğini ve IP izin listelerini kontrol edin; anahtar değiştiyse yeniden girilmesini ve denetimin yeniden çalıştırılmasını sağlayın |
| CubeSandbox platformunda denetim kimlik doğrulama hatası veriyor | E2B biçiminde olmayan bir anahtar için anahtar doğrulaması açık                                      | Runtime üzerinde anahtar doğrulamasının kapatılmasını isteyin (bkz. [Uyumluluk](/tr/runtimes/compatibility))                                             |

## Hâlâ çözülmediyse

Empiric Intelligence temsilcinize `doctor` komutunun tam çıktısını gönderin; daemon kaynaklı sorunlarda `journalctl -u ei-worker` çıktısının son satırlarını da ekleyin. Bunların hiçbiri platformunuzun API anahtarını içermez.