Entegrasyon sorunlarını giderme

API hub bağlayıcı entegrasyonuyla ilgili sık karşılaşılan bazı sorunlar ve sorun giderme adımları aşağıda açıklanmıştır.

API meta verileri API merkezinde görünmüyor

• İlk senkronizasyon süresi: İlk senkronizasyonun başlaması ve API verilerinin API Hub'da görünmesi birkaç saat sürebilir. Birkaç saat beklemeniz önerilir.
• Eklenti örneği durumu: API merkezindeki eklenti örneğinin silinmediğini veya değiştirilmediğini doğrulayın.
• Ağ geçidi kimliği: Apigee Edge for Private Cloud API hub bağlayıcı ayarlarınızda doğru ağ geçidi kimliğinin düzgün şekilde yapılandırıldığından emin olun.
• Günlükleri kontrol edin: Edge for Private Cloud API hub bağlayıcı hizmet günlüklerinde /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log herhangi bir hata kaydedilip kaydedilmediğini kontrol edin.

Proxy dağıtılmış ancak API merkezindeki bilgiler doğru değil

• Yayılma Gecikmesi: Dağıtılan proxy bilgilerinin yayılması ve API hub'ına yansıtılması için birkaç dakika bekleyin.
• Günlükleri kontrol edin: Yüklenen proxy'lerle ilgili ayrıntılar için Edge for Private Cloud API hub bağlayıcı günlüklerini inceleyin. Bu, proxy güncellemesinin senkronizasyon için başarılı bir şekilde işlenip işlenmediğini belirlemeye yardımcı olabilir.

Kullanıcı kuruluşu, API hub bağlayıcısında herhangi bir değişiklik yapmadan senkronizasyonu durdurdu

• Eklenti örneği durumu (API hub tarafı): API hub'daki ilişkili eklenti örneğinin devre dışı bırakılıp bırakılmadığını, silinip silinmediğini veya değiştirilip değiştirilmediğini doğrulayın. API hub'ı tarafındaki tüm değişiklikler, API hub'ı bağlayıcısından yapılan senkronizasyonu doğrudan etkileyebilir.
• Günlükleri kontrol edin: Senkronizasyon sürecinde kesinti olabileceğini gösteren hatalar, uyarılar veya sorunlar için Private Cloud API hub bağlayıcısı günlüklerini inceleyin. Bu durum, bağlantı sorunları veya API hub'ı ile ilgili kimlik doğrulama sorunlarından kaynaklanabilir.

Durum API'sini kullanma (kaydolan kuruluşlar için önerilir):

Durum API'si, hangi kuruluşların etkinleştirme işlemini gerçekleştirdiğini ve etkin bir şekilde senkronize ettiğini görmenin doğrudan bir yolunu sunar.

Günlük tabanlı sorun giderme

API hub bağlayıcı günlükleri nerede depolanır?

/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

Etkinleştirilen kuruluşlar hakkında nasıl bilgi edinebilirim?

Hangi kuruluşların (kurumlar) şu anda etkin olduğunu ve senkronize edildiğini belirlemek için durum API'sinden yararlanabilir ve sistem günlüklerini inceleyebilirsiniz.

• İşlem: Durum API uç noktasını çağırın.
• Beklenen çıktı: Kaydolan kuruluşlar, API yanıtındaki apiSyncStatus ve analyticsSyncStatus bölümlerinde listelenir. Meta veri senkronizasyonunun etkin olduğu kuruluşlar apiSyncStatus altında, çalışma zamanı senkronizasyonunun etkin olduğu kuruluşlar ise analyticsSyncStatus altında gösterilir.

  {
   "apiSyncStatus": [
     {
       "organization": "foo",
       "phase": "Preparing", // ColdTransfer => Preparing
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 100, // total proxies known to uapim connector
             "pendingItems": 90,  // pending proxies to upload
             "completedItems": 6, // completed proxies to upload
             "failedItems": 4 // proxies failed to upload
           }
         },
         "environment": { //environment upload status
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 1, // pending environments to process
             "completedItems": 3, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "bar",
       "phase": "Processing", // "Streaming" -> "Processing"
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 110, // total proxies known to uapim connector
             "pendingItems": 16, // pending proxies to upload
             "completedItems": 3, // completed proxies to upload
             "failedItems": 1 // proxies failed to upload
           }
         },
         "environment": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 3, // pending environments to process
             "completedItems": 1, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "test",
       "phase": "Queued", // "Yet to start" -> "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"
     }
   ]
  }
  

• Sistem günlüklerini inceleme: Daha ayrıntılı bir görünüm elde etmek ve senkronizasyonun bağımsız kuruluşlar için ayarlandığını onaylamak üzere sistem günlüklerini belirli girişler açısından inceleyebilirsiniz.
  • Günlükleri kontrol edin:

    /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Arama komutları: Aşağıdaki günlük satırlarını bulmak için grep veya benzer günlük arama araçlarını kullanın:
    • org meta verilerinin meta veri senkronizasyonu için:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Örnek günlük snippet'i:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • Kuruluş adının ardından Setup metadata sync for organization: (Kuruluş için meta veri senkronizasyonunu ayarlayın:) metnini bulun.
    • Kuruluşun çalışma zamanı verilerinin senkronizasyonu için:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • Örnek günlük snippet'i:

      2025-07-10 08:47:09,902  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupRuntimeSyncData() : Setup runtime data sync for organization: runtime-org

    • Kuruluş adının ardından Kuruluş için çalışma zamanı veri senkronizasyonunu ayarlama: metnini bulun.

Günlüklerden etkinleştirilemeyen tüm (kuruluş,ortam) bilgileri nasıl alabilirim?

Etkinleştirilemeyen kuruluşlar hakkında bilgi edinmek için sistem günlüklerini inceleyerek belirli hata girişlerini bulabilirsiniz.

• Günlükleri kontrol edin: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Arama komutları: Meta veri senkronizasyon durumu güncellemesi sırasında hata olduğunu belirten günlük satırlarını bulmak için grep veya benzer günlük arama araçlarını kullanın.
  • failed-org/failed-env kuruluş/ortamı için başarısız olan meta veri senkronizasyonu durumu güncellemeleri:

    grep "Error while updating metadata sync status for org: failed-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Örnek günlük snippet'i:

    2025-07-15 10:30:15,123 main ERROR c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateMetadataSyncStatus() : Error while updating metadata sync status for org: failed-org

  • Kuruluş ve ortamdan (ör. failed-org/failed-env) önce gelen Error while updating metadata sync status for org/env: metnini bulun.

Günlüklerden kuruluşun aktarım durumu değişikliğinin özetini nasıl alabilirim?

(Kuruluş, ortam) senkronizasyon aktarım durumunun ne zaman güncellendiğiyle ilgili bir özet almak için sistem günlüklerini belirli girişler açısından inceleyebilirsiniz.

• Günlükleri kontrol edin: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Arama komutları: Bir kuruluş ve ortam için aktarım durumunda güncelleme olduğunu belirten günlük satırlarını bulmak üzere grep veya benzer günlük arama araçlarını kullanın.
  • Transfer durumu güncellemeleri için:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • Örnek günlük snippet'i:

    2025-07-15 18:35:01,789 main INFO c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateTransferStatus() : Transfer status is updated for org: org1 to BULK_TRANSFER
    2025-07-10 08:47:11,364  main INFO  c.a.u.m.UAPIMMetadataServiceImpl - UAPIMMetadataServiceImpl.updateEnvironmentStatus() : Transfer status is updated for org: org1 to STREAMING

  • "Transfer durumu, kuruluş/ortam için güncellendi" metnini, ardından belirli kuruluş ve ortamı (ör. org1/prod) ve durumu bulun.