İçeriğe geç
Dokümantasyon
Geliştirme dokümantasyonu
Bu belgeler Keydra'nın geliştirilmekte olan hâlini anlatır; yayımlanmış bir sürüm değildir. Anlatılanlar bir sürüm çıkana kadar değişebilir.

Sorun giderme

Keydra'nın gerçekten ürettiği hatalar, her birinin anlamı ve çözümü.

Bir hedefe bağlanılamıyor#

Satır Erişilemiyor durumunda kalıyor ya da Bağlantıyı test et başarısız oluyor.

Prosedür

  1. Keydra’nın adrese erişip erişemediğini kontrol edin. Bağlantıyı kuran tarayıcınız değil Keydra’dır; dizüstünüzden çalışan bir adres kapsayıcıdan çalışmayabilir.

  2. Hedef özel bir ağdaysa profile bir tünel tanımlayın — bkz. Hedeflere atlama sunucusu üzerinden erişme.

  3. Kimlik bilgilerini kontrol edin. Parola isteyen bir hedef, parola verilmediğinde bağlantı aşamasında değil kimlik doğrulama aşamasında reddeder; dışarıdan ikisi aynı görünür.

  4. Hedef TLS konuşuyorsa TLS kullan seçeneğini işaretleyin. Sertifika özel bir otorite tarafından imzalanmışsa, o otoritenin Keydra’nın çalıştığı makinenin güven deposunda bulunması gerekir; Keydra sistem deposunu kullanır ve kendi ayarı yoktur.

  5. Sentinel profillerinde Sentinel master adı değerini kontrol edin. Keydra master’ın adresini Sentinel’e sorar; Sentinel’in tanımadığı bir ad için adres dönmez.

Doğrulama

Bağlantıyı test et, hiçbir şey kaydetmeden formdaki bilgilerle bağlantıyı dener ve sonucu bildirir.

Kimse giriş yapamıyor#

Prosedür
Doğru olduğunu bildiğiniz parola reddediliyorsa

Mesajın Kullanıcı adı veya parola yanlış. mı yoksa Çok fazla giriş denemesi yapıldı mı olduğuna bakın. İkincisi sınırlamadır; birkaç dakika bekleyin. Bkz. Giriş koruması.

Sağlayıcı düğmesi sizi sağlayıcıya götürüyor ama sağlayıcı reddediyorsa

Sorun neredeyse her zaman yönlendirme adresidir. Adresi Erişim → Giriş bölümündeki sağlayıcı formundan, sağlayıcı anahtarı da dahil birebir kopyalayıp sağlayıcıya kaydedin.

Sağlayıcı kabul ediyor ama Keydra boş sayfa gösteriyorsa

Hesap oluşmuş ama hiçbir yetkisi yoktur. Hesap, birinin giriş yapmasını ve hiçbir şey görmemesini sağlar. Bir rol verin — bkz. Erişim verme.

Yönlendirme yanlış adrese dönüyorsa

KEYDRA_PUBLIC_URL değerini ayarlayın. Önde bir ters vekil sunucu varsa KEYDRA_BEHIND_PROXY ve KEYDRA_TRUSTED_PROXIES değerlerini de girin.

Bütün sayfalarda Güvenlik kapalı yazıyorsa

KEYDRA_SECURITY_ENABLED değeri false demektir. Kuruluma erişebilen herkes her şeyi yapabilir. Bkz. Keydra’yı dışarı açmadan önce kimlik doğrulamayı yapılandırma.

Zamanlanmış iş çalışmadı ya da uyarı gelmedi#

Prosedür
Zamanlanmış iş çalışmadıysa

  1. Her örnekte Hakkında sayfasına bakın. Zamanlanmış işleri yalnızca lider işlerini üstlenen örnek kaydeder; hiçbiri üstlenmiyorsa hiçbir iş kayıtlı değildir.

  2. İşin etkin olduğunu doğrulayın ve çalışma geçmişine bakın. Çalışma kaydı, iş başlamadan önce oluşturulur; bu yüzden hiç bitmeyen bir iş "hiç çalışmadı" değil "bitmedi" olarak görünür.

  3. İzni kontrol edin. Zamanlanmış iş, elle yapılsaydı gereken izni ister ve bu izin çalışma anında yeniden denetlenir. İş yazıldıktan sonra geri alınan bir yetki, çalışmayı sessiz değil reddedilmiş hâle getirir.

Kural hiç tetiklenmiyorsa

  1. Kuralın etkin olduğunu doğrulayın. Yalnızca etkin kurallar hedefi örneklenmiş tutar.

  2. Ne kadar sürmeli değerini kontrol edin. O süre boyunca sürmeyen bir koşul beklemede durumundan çıkmaz.

  3. Kural geçmiş bir aralıkla karşılaştırıyorsa ölçüm deposunun tanımlı olduğunu ve o kadar geriye ait veri tuttuğunu doğrulayın. Taban çizgisi okunamayan kural olduğu gibi bırakılır: ne tetiklenir ne sessizleşir.

Kural tetikleniyor ama mesaj gelmiyorsa

  1. Olayı Geçmiş bölümünden inceleyin. Gönderim sonucu, başarısızlık ve nedeni olay kaydına işlenir.

  2. Gönderimin kimlik bilgisini kontrol edin. API bu bilgiyi döndürmediği için, belirteç alanı boş bırakılarak kaydedilen bir form eski değeri korumuş olabilir; ya da hiç belirteç girilmemiştir.

Anahtarlar ve değerler beklenmedik davranıyor#

Prosedür
Anahtar listesi sonuna gelmeden duruyor

Sayfa Sınıra ulaşıldı der; güvenle tutabileceği kadar anahtar tutar. Farklı anahtarları görmek için süzgeci daraltın. Bu, var olan anahtarların değil çizilen listenin sınırıdır.

Değerin yalnızca başı görünüyor

Değer Kısmen gösteriliyor olarak işaretlenmiştir. Bütün hâlde döndürülemeyecek kadar büyüktür ve buradan düzenlemek ya da kopyalamak geri kalanının üzerine daha kısa bir metin yazardı. Değeri API üzerinden ya da dışa aktarma dosyasından okuyun.

Değer anlamsız görünüyor

Kodlama seçimini Otomatik yerine değerin gerçek biçimine getirin. Otomatik tespit bir tahmindir; özellikle Brotli kendini tanıtan bir imza taşımaz.

Listede görünen anahtar açılınca yok

Panel şunu yazar: Bu anahtar artık yok — liste oluşturulduktan sonra süresi doldu ya da silindi. SCAN canlı bir anahtar uzayında gezinir; anlık görüntü almaz.

Konsolda komut reddediliyor

Bkz. Bazı komutlar neden reddedilir. Ret mesajı gerekçeyi belirtir ve liste yapılandırmayla değiştirilebilir.

Dağıtım sorunları#

Prosedür
Uygulama başlamıyor

  • KEYDRA_DB_URL, KEYDRA_DB_USERNAME ve KEYDRA_DB_PASSWORD değerlerini kontrol edin. Bellek içi bir alternatif yoktur: Keydra yalnızca PostgreSQL ile çalışır.

  • KEYDRA_SECRET_KEY değerinin tanımlı olduğunu kontrol edin. Bu anahtar olmadan saklanan kimlik bilgileri çözülemez.

Dağıtımdan sonra kimlik bilgileri çözülmüyor

KEYDRA_SECRET_KEY değişmiş ve eski anahtar KEYDRA_PREVIOUS_SECRET_KEYS içine yazılmamış demektir. Eski anahtarı geri koyun ve Örnek anahtarını değiştirme adımlarını sırasıyla izleyin.

Arayüz açılıyor ama bütün istekler reddediliyor

Oturumunuzun açık olup olmadığını kontrol edin. Oturum durumunu sormak herkese açıktır; bu soruya gelen bir 401, sunulan çerezin reddedildiği anlamına gelir. Çoğunlukla başka bir tarayıcıdan sonlandırılmış bir oturumdur.

Bir örnekteki değişiklikler diğerindeki tarayıcıya ulaşmıyor

KEYDRA_STORE_URL tanımlı değildir ya da örnekler farklı depoları gösteriyordur. Ortak depo olmadan bildirim hattı yalnızca kendi soketlerine yayın yapar.

Yedek hedefi sınaması MinIO ya da S3 uyumlu bir depoda başarısız oluyor

Kovayı yol olarak adresle seçeneğini işaretleyin. Bu seçenek kapalıyken IP adresindeki bir MinIO bucket.10.0.0.4 olarak aranır ve hata bir DNS sorunu gibi görünür.

Dış adres reddediliyor

Link-local adresler reddedilir ve bunu açan bir ayar yoktur. 169.254.169.254 adresi makinenin bulut kimlik bilgilerini döndürür.

Bu sayfayı düzenle