Önce başarısız olan aşamayı belirleyin: giriş, dosya kaydetme, Git, derleme, runtime başlangıcı, API erişimi veya mesaj işleme. Bir aşamanın başarısı sonraki aşamanın da başarılı olduğunu göstermez.
Belirtiye göre başlayın
| Belirti | İlk kontrol | Ayrıntılı rehber |
|---|---|---|
| Girişte döngü veya yönlendirme hatası | Doğru Lunex adresi, kimlik sunucusu adresi, client redirect URI ve saat uyumu. | Kimlik |
401 veya 403 | Oturum/token geçerliliği ve işlemin istediği rol. Platform girişini API çağırıcısının yetkisiyle karıştırmayın. | Platform yetkileri, API güvenliği |
| Editör değişikliği saklamıyor | Kaydetme bildirimini okuyun; başarısız taslağı koruyun, aynı dosyadaki eşzamanlı değişiklikleri kontrol edin. | Akış tasarımı, API oluşturma |
| Git commit/pull başarısız | Depo erişimi, hedef dal, token/SSH anahtarı ve Git sunucusunun yazma kuralları. | Git |
| Değişiklik Build sonucunda görünmüyor | Dosya kaydedilmiş mi, seçilerek commit edilmiş mi, doğru commit ve imaj kullanılıyor mu? | Sürümü dağıtma |
| Runtime başlamıyor | Log, Deployment sekmesindeki pod olayları, eksik property/Secret, bağımlılık ve kaynak sınırları. | Deployment/Log, kaynaklar, yapılandırma |
| API bulunamıyor veya hazır değil | Yayın ayarları, doğru adres, runtime hedefi, path/method ve implementation route. | Yayınlama |
API 400 döndürüyor | İstek yöntemi/yolu, media type, zorunlu alanlar ve etkin request validation. | Şemalar |
| Mock başarılı, gerçek çağrı hatalı | Mock yalnız örnek yanıt üretir. Bağlantı, route, secret ve çalışan sürümü gerçek runtime’da doğrulayın. | API test |
| Message Monitor boş | Ortam, proje, zaman aralığı, kayıt seviyesi, saklama süresi ve mesajın gerçekten çalışıp çalışmadığı. | İzleme, kayıt |
| Application ID/özel alan bulunamıyor | Değeri atayan adım gerçekten çalıştı mı; alan doğru ad ve türde mi; tamamlanma kaydı geldi mi? | Application ID, arama |
| Gövde veya geçmiş görünmüyor | Kayıt seviyesi, içerik erişim izni, boyut sınırı, saklama süresi ve gösterilen unavailable nedeni. | Çalıştırmayı inceleme |
| Kuyruk büyüyor | Consumer var mı, runtime çalışıyor mu, tüketim hızı yeterli mi, mesaj tekrar teslim ediliyor mu? | Kuyruk yönetimi |
| SAP metadata/çağrı hatası | Destination, ağ erişimi, kullanıcı yetkisi ve gerekli runtime kütüphaneleri. | SAP bağlantısı |
Başlatılamayan uygulama ile başarısız mesajı ayırın
Runtime hiç başlamadıysa route henüz mesaj işlememiş olabilir. Bu durumda Message Monitor yerine önce container günlüğünü ve pod olayını inceleyin. ImagePullBackOff imaj erişimiyle; Pending kapasite veya planlamayla; OOMKilled bellek sınırıyla ilgili olabilir. Görünen olayın ayrıntısı bir sonraki adımı belirler.
Runtime çalışıyor fakat mesaj hata alıyorsa Message Monitor’da ilgili message ve run’ı açın. Hata veren adım, kayıtlı istisna, bağlantı gözlemi ve zaman bilgilerini birlikte kullanın. Log metniyle izleme kaydını aynı ortam ve zaman aralığı üzerinden eşleştirin.
Yeniden denemeden önce
Bir dış sistemin yanıt vermemesi, işlemi hiç yapmadığını kanıtlamaz. Örneğin sipariş hedefte oluşmuş ama yanıt kaybolmuş olabilir. Hedefteki iş kaydını ve varsa idempotency anahtarını kontrol edin. Kuyruk mesajını yeniden teslim etmek veya API’yi tekrar çağırmak aynı işi ikinci kez yapabilir.
Route içindeki retry, broker redelivery ve elle tekrar gönderme birbirinden bağımsızdır. Deneme sayılarının birlikte nasıl davranacağını hata yönetimi ve kuyruk yönetimi sayfalarından kontrol edin.
Destek için hangi bilgileri toplayın?
Bir sorun kaydı hazırlarken aşağıdakileri birlikte verin:
- Ortam, proje kimliği ve işlemin gerçekleştiği zaman aralığı; saat dilimini ekleyin.
- Beklenen sonuç, gerçekleşen sonuç ve yeniden üretmek için kullanılan adımlar.
- Varsa Application ID, Message ID ve Run ID; bunların hangisi olduğunu belirtin.
- HTTP durum kodu veya tam hata metni; ilgili Log satırı veya pod olayı.
- Git commit, imaj etiketi ve Development/Packaged runtime bilgisi.
- Hassas bilgi içermeyen örnek girdi ve gerekiyorsa ekran görüntüsü.
Parola, token, Secret değeri, Authorization header’ı veya gerçek müşteri verisini sorun kaydına eklemeyin. Ekran görüntüsünde gerekli olmayan kimlik ve payload alanlarını çıkartın.