Yükleme durumunu ve hataları kontrol etme

Apigee API Hub for Private Cloud bağlayıcısının yerel durum uç noktasını sorgulayarak meta veri ve çalışma zamanı verisi yüklemelerinin durumunu istediğiniz zaman kontrol edebilirsiniz.

Yükleme durumunu kontrol etme

Apigee API Hub for Private Cloud bağlayıcısını çalıştıran sanal makinede aşağıdaki curl komutunu kullanın:

curl localhost:8080/v1/uapim/status

  {
 "apiSyncStatus": [
   {
     "organization": "foo",
     "phase": "Preparing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 100,
           "pendingItems": 90,
           "completedItems": 6,
           "failedItems": 4
         }
       },
       "environment": { //environment upload status
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 1,
           "completedItems": 3,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "bar",
     "phase": "Processing",
     "components": [
       "proxy": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 110,
           "pendingItems": 16,
           "completedItems": 3,
           "failedItems": 1
         }
       },
       "environment": {
         "lastUpdated": "2025-04-16T00:56:45Z",
         "progress": {
           "totalItems": 5,
           "pendingItems": 3,
           "completedItems": 1,
           "failedItems": 1
         }
       }]
   },
   {
     "organization": "test",
     "phase": "Queued",
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ],
 "analyticsSyncStatus": [
   {
     "organization": "test",
     "environment": "dev",
     "failedItems": 2,
     "lastUpdated": "2025-04-16T00:56:45Z"
   },
   {
     "organization": "test",
     "environment": "prod",
     "failedItems": 4,
     "lastUpdated": "2025-04-16T00:56:45Z"
   }
 ]
}

Çıkışta aşağıdaki konularla ilgili analizler yer alır:

• API meta verileri: Kuruluş, ortam, mevcut aşama (ör. "Hazırlanıyor", "İşleniyor", "Sıraya alındı"), toplam/tamamlanan/bekleyen yüklemeler, hata sayısı ve son güncelleme zamanı dahil olmak üzere API meta verisi yüklemelerinin durumu.
• Çalışma zamanı meta verileri: Kuruluş, ortam, hata sayısı ve son güncelleme zamanını gösteren çalışma zamanı verisi yüklemelerinin durumu.

Sık karşılaşılan sorunlar ve sorun giderme adımları

Sorun yaşarsanız bağlayıcının günlüklerine ve durum uç noktasına bakın. Apigee hub bağlayıcısının ana günlük dosyası /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log konumunda bulunur.

1. Apigee API Hub for Private Cloud bağlayıcısı başlatılamıyor:
   • Günlükleri kontrol edin: Yapılandırmayla ilgili hata mesajları için /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log dosyasını inceleyin.
   • Ayarları doğrulayın: uapim-connector.properties ve ortam değişkenlerinde yapılandırılan tüm ayarları tekrar kontrol edin.
   • Pub/Sub erişimi: Günlüklerde, opdk-connector öğesinin sağlanan Pub/Sub konularına erişip erişemediğini doğrulayın.
   • Yönetim sunucusu erişimi: opdk-connector, verilen URL ve kimlik bilgileriyle Apigee yönetim sunucusunu başarıyla çağırabiliyorsa günlükleri kontrol edin.
   • Başlatma süresi: Apigee ortamınızda binlerce dağıtım varsa Apigee hub bağlayıcısının başlatılması yaklaşık 20-30 dakika sürebilir.
2. API meta verileri, API merkezinde gösterilmiyor:
   • Bağlayıcı günlükleri: opdk-connector günlüklerini inceleyerek API meta verileri Pub/Sub konusuna erişip yönetim sunucusunu çağırıp çağıramadığını kontrol edin.
   • Yükleme durumu: curl localhost:8080/v1/uapim/status çıkışını kontrol edin. APIMetadata bölümünü bulun.
     • lastUpdated yakın zamanda mı güncellendi?
     • errorCount sürekli olarak artıyor mu?
     • Hangi aşamada?
   • İstisnalar/hatalar: Günlüklerde meta veri işleme ile ilgili olarak oluşturulan istisnaları veya hataları arayın.
3. Çalışma zamanı verileri API merkezinde gösterilmiyor:
   • Bağlayıcı günlükleri: opdk-connector'ın çalışma zamanı Pub/Sub konusuna erişip yönetim sunucusunu çağırabildiğini kontrol edin.
   • Yükleme durumu: curl localhost:8080/v1/uapim/status komutunu kullanın. RuntimeData bölümüne odaklanın.
     • lastUpdated yakın zamanda mı güncellendi?
     • errorCount sürekli olarak artıyor mu?
   • İstisnalar/hatalar: Çalışma zamanı veri işleme ile ilgili günlüklerde istisna veya hata olup olmadığını kontrol edin.
   • İleti işlemcisi yapılandırması: Çift yazma için tüm ileti işlemcilerinde message-processor-communication.properties öğesinin doğru şekilde yapılandırıldığından ve ileti işlemcilerinin yeniden başlatıldığından emin olun.
   • NFS bağlama: NFS bağlamanın doğru şekilde yapılandırıldığını ve hem MP'ler hem de UAPIM bağlayıcısı tarafından erişilebilir olduğunu doğrulayın.
4. Proxy dağıtıldı ancak API merkezindeki bilgiler doğru değil:
   • Bekleme süresi: Verilerin yayılması için birkaç dakika bekleyin.
   • Günlükler: Yüklenen proxy'ler hakkında bilgi edinmek için opdk-connector günlüklerini kontrol edin. Bu, bağlayıcının dağıtım etkinliklerini işleyip işlemediğini belirlemeye yardımcı olabilir.