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
Başarılı bir yanıt, aşağıdakine benzer bir JSON nesnesi döndürür:
    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

Çıkış, aşağıdaki konularda analizler sağlar:

  • API meta verileri: Kuruluş, ortam, mevcut aşama (ör. "Toplu Aktarım", "Akış", "Henüz başlamadı"), toplam/tamamlanan/bekleyen yüklemeler, hata sayısı ve son güncelleme zamanı dahil olmak üzere API meta verileri 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ı

Sorunlarla karşılaşırsanı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: API meta verileri Pub/Sub konusuna erişip yönetim sunucusunu çağırıp çağıramadığını görmek için opdk-connector günlüklerini inceleyin.
    • 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?
      • What stage is it in?
    • İ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 message-processor-communication.properties öğesinin tüm MP'lerde doğru şekilde yapılandırıldığından ve MP'lerin 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.