Probleme mit der Integration beheben

Hier finden Sie einige häufige Probleme und Schritte zur Fehlerbehebung für die Integration des API-Hub-Connectors.

API-Metadaten werden nicht im API-Hub angezeigt

• Zeit für die erste Synchronisierung:Es kann einige Stunden dauern, bis die erste Synchronisierung beginnt und API-Daten im API Hub angezeigt werden. Es wird empfohlen, einige Stunden zu warten.
• Status der Plug-in-Instanz:Prüfen Sie, ob die Plug-in-Instanz im API-Hub gelöscht oder geändert wurde.
• Gateway-ID:Achten Sie darauf, dass die richtige Gateway-ID in den Einstellungen für den Apigee Edge for Private Cloud API-Hub-Connector konfiguriert ist.
• Logs prüfen:Prüfen Sie, ob in den Dienstlogs des Edge for Private Cloud API-Hub-Connectors /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log Fehler protokolliert wurden.

Proxy bereitgestellt, aber Informationen im API-Hub sind nicht korrekt

• Verzögerung bei der Weitergabe:Es kann einige Minuten dauern, bis die bereitgestellten Proxyinformationen weitergegeben werden und im API-Hub angezeigt werden.
• Logs prüfen:Sehen Sie sich die Logs des API-Hub-Connectors für Edge for Private Cloud an, um Details zu hochgeladenen Proxys zu erhalten. So lässt sich feststellen, ob das Proxy-Update für die Synchronisierung erfolgreich verarbeitet wurde.

Synchronisierung der Nutzerorganisation wurde beendet, ohne dass Änderungen am API-Hub-Connector vorgenommen wurden

• Status der Plug-in-Instanz (API-Hub-Seite): Prüfen Sie, ob die zugehörige Plug-in-Instanz im API-Hub deaktiviert, gelöscht oder geändert wurde. Alle Änderungen im API-Hub können sich direkt auf die Synchronisierung über den API-Hub-Connector auswirken.
• Logs prüfen:Sehen Sie sich die Logs des Edge for Private Cloud API Hub-Connectors an, um nach Fehlern, Warnungen oder Problemen zu suchen, die auf eine Unterbrechung des Synchronisierungsprozesses hinweisen könnten. Dazu können Verbindungsprobleme oder Authentifizierungsprobleme mit dem API-Hub gehören.

Status-API verwenden (für Organisationen, die sich angemeldet haben, empfohlen):

Über die Status-API können Sie direkt sehen, welche Organisationen die Synchronisierung aktiviert haben und aktiv synchronisieren.

Fehlerbehebung anhand von Logs

Wo werden die Connector-Logs für den API-Hub gespeichert?

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

Wie erhalte ich Informationen zu den aktivierten Organisationen?

Mit der Status API und den Systemlogs können Sie herausfinden, welche Organisationen derzeit aktiviert und synchronisiert werden.

• Aktion:Rufen Sie den Status-API-Endpunkt auf.
• Erwartete Ausgabe:Organisationen, die sich angemeldet haben, werden in der API-Antwort in den Abschnitten apiSyncStatus und analyticsSyncStatus aufgeführt. Organisationen, bei denen die Metadatensynchronisierung aktiviert ist, werden unter apiSyncStatus angezeigt. Organisationen, bei denen die Laufzeitsynchronisierung aktiviert ist, werden unter analyticsSyncStatus angezeigt.

  {
   "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"
     }
   ]
  }
  

• Systemlogs prüfen:Wenn Sie eine detailliertere Ansicht benötigen und die Einrichtung der Synchronisierung für einzelne Organisationen bestätigen möchten, können Sie die Systemlogs nach bestimmten Einträgen durchsuchen.
  • Logs prüfen:

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

  • Suchbefehle:Verwenden Sie grep oder ähnliche Tools zur Protokollsuche, um die folgenden Protokollzeilen zu finden:
    • Für die Metadatensynchronisierung von Organisationsmetadaten:

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

    • Beispiel für einen Log-Ausschnitt:

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

    • Suchen Sie nach dem Text Metadatensynchronisierung für Organisation einrichten:, gefolgt vom Namen der Organisation.
    • Für die Synchronisierung von Laufzeitdaten der Organisation „runtime-org“:

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

    • Beispiel für einen Log-Ausschnitt:

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

    • Suchen Sie nach dem Text Laufzeitdatensynchronisierung für Organisation einrichten, gefolgt vom Namen der Organisation.

Wie erhalte ich Informationen zu allen Organisationen und Umgebungen,die in den Logs nicht aktiviert werden konnten?

Wenn Sie Informationen zu Organisationen erhalten möchten, die nicht aktiviert werden konnten, können Sie die Systemprotokolle nach bestimmten Fehlereinträgen durchsuchen.

• Logs prüfen:/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Suchbefehle:Verwenden Sie grep oder ähnliche Tools zur Logsuchen, um Logzeilen zu finden, die auf einen Fehler beim Aktualisieren des Metadatensynchronisierungsstatus hinweisen.
  • Bei fehlgeschlagenen Statusupdates für die Metadatensynchronisierung für Organisation/Umgebung „failed-org“/„failed-env“:

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

  • Beispiel für einen Log-Ausschnitt:

    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

  • Suchen Sie nach dem Text Error while updating metadata sync status for org/env: gefolgt von der Organisation und Umgebung (z. B. failed-org/failed-env).

Wie kann ich eine Zusammenfassung der Änderung des Übertragungsstatus einer Organisation aus Protokollen erhalten?

Wenn Sie eine Zusammenfassung der Aktualisierungszeiten für den Synchronisierungsübertragungsstatus einer Organisation oder Umgebung erhalten möchten, können Sie die Systemlogs nach bestimmten Einträgen durchsuchen.

• Logs prüfen:/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Suchbefehle: Verwenden Sie grep oder ähnliche Tools zur Log-Suche, um Logzeilen zu finden, die auf eine Aktualisierung des Übertragungsstatus für eine Organisation und Umgebung hinweisen.
  • Statusaktualisierungen für die Übertragung:

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

  • Beispiel für einen Log-Ausschnitt:

    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

  • Suchen Sie nach dem genauen Text „Transfer status is updated for org/env“ (Der Übertragungsstatus wurde für org/env aktualisiert), gefolgt von der jeweiligen Organisation und Umgebung (z.B. org1/prod) und dem Status.