Hata mesajları
DT Edge Platform'un yüzeylediği her hata kodu, anlamı, sonra nereye bakılacağı. Kodlar stabil string'lerdir — biri çıkarsa bu sayfayı arayın.
Lisans gating
| Kod | Nerede gördüğünüz | Anlamı | Sıradaki |
|---|---|---|---|
LICENSE_MISSING | Her aksiyonda toast; landing page | Lisans yüklü değil | Admin yükler — bkz. Nasıl yapılır: lisans yükle |
LICENSE_INVALID | Toast + License sayfası kırmızı badge | Verification başarısız; sebep hover'da | Sebebi License invalid runbook ile eşleştirin |
LICENSE_GRACE_READONLY | Mutation'larda toast | Lisans expired, grace'te; okumalar geçer, mutation'lar 503 | Grace bitmeden yenileyin |
LICENSE_FINGERPRINT_MISMATCH | Lisans yükleme | Lisansın --bind'i bu cluster'la eşleşmiyor | Yeni fingerprint alın, yeniden mint edin |
LICENSE_WRONG_PRODUCT | Lisans yükleme | --product provisioner ile mint edilmiş | --product dtedge ile yeniden mint edin |
LICENSE_SCHEMA_TOO_NEW | Lisans yükleme | Bu DT Edge Platform build'inden daha yeni schema | Önce DT Edge Platform image'ını yükseltin |
LICENSE_CLOCK_ROLLBACK | Server log + License sayfası | Host clock geriye gitti | timedatectl set-ntp true ile düzeltin, pod'ları restart edin |
FLEET_QUOTA_EXCEEDED | Install / edge create'te toast | Operation fleet cap'i aşacak | Fleet quota exceeded'i çöz |
Auth + oturum
| Kod | Anlamı | Sıradaki |
|---|---|---|
INVALID_CREDENTIALS | Yanlış e-posta / şifre (login) ya da yanlış mevcut şifre (change-password) | Tekrar deneyin |
2FA_REQUIRED | Şifre tamam; TOTP kodu gerek | 6 haneli kodu girin |
INVALID_2FA_CODE | TOTP yanlış | Telefon saatini kontrol edin; tekrar deneyin |
TOKEN_EXPIRED | JWT exp'i geçti | Yeniden login |
INVALID_TOKEN | İmza uyuşmuyor (server-side JWT_SECRET rotate edildi) | Yeniden login |
USER_DEACTIVATED | Hesabınız is_active=false | Admin'e danışın |
USER_NOT_FOUND | API key silinen bir kullanıcıya başvuruyor | API key'i yeniden mint edin |
2FA_REQUIRED (post-login) | Server policy 2FA gerektiriyor ama kayıt olmadınız | Login akışında setup wizard çıkar |
RBAC
| Kod | Anlamı | Sıradaki |
|---|---|---|
permission denied | Casbin enforce false döndü | Rolünüz bunu sağlamıyor; admin'den rol güncellemesini isteyin ya da farklı bir rol kullanın |
not a member of this organization | URL'in :org_id'si memberliklerinizde yok | Seçici ile org değiştirin |
super admin access required | Endpoint super-admin'e kilitli | Bir super-admin'in yapmasını isteyin |
Validasyon
| Kod | Anlamı |
|---|---|
INVALID_PAYLOAD | Request body parse olmadı (YAML typo, malformed JSON) |
INVALID_BASE64_KUBECONFIG | Yapıştırdığınız kubeconfig geçerli base64 değil |
INVALID_SETTING_KEY / INVALID_SETTING_VALUE | Admin → Settings save: bilinmeyen key veya geçersiz değer |
TELEMETRY_ID_REQUIRED / TELEMETRY_ID_TAKEN | Edge update: telemetry_id boş veya başka edge tarafından kullanılıyor |
Edge instance
| Kod | Anlamı |
|---|---|
EDGE_INSTANCE_NOT_FOUND | Edge ID sizin değil ya da yok |
EDGE_OPERATION_IN_PROGRESS | Bu edge'e karşı başka op uçuşta |
FAILED_ENCRYPT_KUBECONFIG | Server-side şifreleme hatası; ENCRYPTION_KEY env yanlış yapılandırılmış olabilir |
PUBLIC_RESOURCE_NOT_LICENSED | MaxPublic* cap'i 0 olan bir public/admin endpoint çağrılıyor — feature bu lisansta off |
Helm
| Kod | Anlamı |
|---|---|
OPERATION_IN_PROGRESS | Release çalışan bir op tarafından kilitli; bekleyin |
RELEASE_OWNERSHIP_FORBIDDEN | Public edge'te bu release başka org tarafından kuruldu; sadece o org upgrade/uninstall edebilir |
PROTECTED_NAMESPACE | kube-system / cert-manager / DT Edge Platform / vb.'ye install denemesi |
REGISTRY_UNREACHABLE_VERSION_BUMP | Smart upgrade yeni sürüm pull etmeye çalıştı ama registry kapalı. Mevcut sürüme pin'leyin (sürüm değişmez → saklanan chart'a fallback) |
Yedekleme konumları
| Kod | Anlamı | Sıradaki |
|---|---|---|
BACKUP_LOCATION_NOT_FOUND | Konum ID sizin org'unuza ait değil ya da silinmiş | Yedekleme Konumları sekmesindeki listeyi kontrol edin |
BACKUP_LOCATION_UNAVAILABLE | Konuma erişilemiyor | Endpoint, kimlik bilgileri ve CA sertifikasını kontrol edin; sekmedeki Test Et ile ilgili uç birime karşı doğrulayın |
BACKUP_LOCATION_NOT_VALIDATED | Konum zamanında doğrulanamadı | Uç birimde Velero'nun sağlıklı olduğundan emin olun; testi tekrarlayın (90 saniyeye kadar sürebilir) |
Bkz. Nasıl yapılır: yedekleme konumlarını yönet.
Alarmlar
| Kod | Anlamı |
|---|---|
GRAFANA_NOT_CONFIGURED | system_settings central Grafana URL/cred'lerini eksik |
NO_EDGES_IN_SCOPE | Aktif org'un alarmı scope etmek için edge'i yok |
INVALID_PROMQL | Parser hatası; mesaj pozisyon içerir |
FORBIDDEN_LABEL_<NAME> | Sorgu reserve edilmiş bir label'a (telemetry_id, dtedge_org_id, …) başvuruyor; silin — backend enjekte eder |
ALARM_NOT_FOUND | Kural UID sizin değil ya da yok |
GRAFANA_*_FAILED | Upstream Grafana API çağrısı başarısız (network, 5xx) |
Provisioner entegrasyonu
| Kod | Anlamı |
|---|---|
PROVISIONER_NOT_CONFIGURED | Admin → Settings'te provisioner_url / admin_key eksik |
PROVISIONER_UNREACHABLE | Upstream Provisioner'a network timeout |
NODES_MISSING_SSH | Upstream cluster destroy etmek satırın taşımadığı SSH cred'leri istiyor |
Operation'lar
| Kod | Anlamı |
|---|---|
OPERATION_NOT_FOUND | Operation ID yanlış veya silindi |
OPERATION_NOT_RETRIABLE | failed durumunda olmayan bir op'u retry'a çalıştınız |
FAILED_CREATE_OPERATION / FAILED_ENQUEUE_OPERATION | DB veya Redis hıçkırığı; tekrar deneyin sonra escalate edin |
Webhook (gelen)
| Kod | Anlamı |
|---|---|
INVALID_SIGNATURE | Inbound webhook HMAC uyuşmazlığı (Provisioner → DT Edge Platform); secret senkron değil |
STALE_TIMESTAMP | Replay window aşıldı (>5 dk) |
WEBHOOK_NOT_FOUND | Webhook config satırı silindi |
Genel
| Kod | Anlamı |
|---|---|
INTERNAL_SERVER_ERROR | Yakalanmayan exception; pod log'larını kontrol edin |
DB_UNAVAILABLE | Postgres kapalı veya erişilemez |
RATE_LIMITED | Per-API-key rate limit'e takıldı; yavaşlayın |
Ayrıca bakın
- Nasıl yapılır: fleet quota exceeded'i çöz
- Nasıl yapılır: lisans yükle
- Backend docs: API → Error codes