Résoudre les problèmes d'intégration

Voici quelques problèmes courants et les étapes de dépannage correspondantes pour l'intégration du connecteur du hub d'API.

Les métadonnées de l'API ne s'affichent pas dans le hub d'API

• Délai de synchronisation initiale : le démarrage de la synchronisation initiale et l'affichage des données de l'API dans le hub d'API peuvent prendre quelques heures. Nous vous recommandons d'attendre quelques heures.
• État de l'instance de plug-in : vérifiez que l'instance de plug-in dans le hub d'API n'a pas été supprimée ni modifiée.
• ID de la passerelle : assurez-vous que l'ID de la passerelle est correctement configuré dans les paramètres du connecteur de hub d'API Apigee Edge pour Private Cloud.
• Vérifiez les journaux : vérifiez si des erreurs sont consignées dans les journaux du service de connecteur du hub d'API Edge pour Private Cloud /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

Proxy déployé, mais les informations du hub d'API ne sont pas exactes

• Délai de propagation : prévoyez quelques minutes pour que les informations sur le proxy déployé se propagent et s'affichent dans le hub d'API.
• Vérifiez les journaux : consultez les journaux du connecteur du hub d'API Edge for Private Cloud pour en savoir plus sur les proxys importés. Cela peut vous aider à déterminer si la mise à jour du proxy a été traitée avec succès pour la synchronisation.

L'organisation utilisateur a cessé de se synchroniser sans que rien n'ait été modifié dans le connecteur du hub d'API

• État de l'instance de plug-in (côté API Hub) : vérifiez si l'instance de plug-in associée dans API Hub a été supprimée, désactivée ou modifiée. Toute modification apportée au hub d'API peut avoir un impact direct sur la synchronisation à partir du connecteur du hub d'API.
• Consultez les journaux : examinez les journaux du connecteur de hub d'API Edge pour Private Cloud afin de détecter les erreurs, les avertissements ou les problèmes qui pourraient indiquer une interruption du processus de synchronisation. Cela peut inclure des problèmes de connectivité ou d'authentification avec le hub d'API.

Utiliser l'API d'état (recommandé pour les organisations ayant activé la fonctionnalité) :

L'API d'état permet de voir directement quelles organisations ont activé la synchronisation et la synchronisent activement.

Dépannage basé sur les journaux

Où sont stockés les journaux du connecteur de hub d'API ?

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

Comment obtenir des informations sur les organisations activées ?

Pour déterminer quelles organisations sont actuellement activées et synchronisées, vous pouvez utiliser l'API d'état et inspecter les journaux système.

• Action : appelez le point de terminaison de l'API d'état.
• Résultat attendu : les organisations ayant activé la fonctionnalité seront listées dans les sections apiSyncStatus et analyticsSyncStatus de la réponse de l'API. Les organisations pour lesquelles la synchronisation des métadonnées est activée s'affichent sous apiSyncStatus, et celles pour lesquelles la synchronisation de l'exécution est activée s'affichent sous analyticsSyncStatus.

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

• Inspecter les journaux système : pour obtenir une vue plus précise et confirmer la configuration de la synchronisation pour des organisations individuelles, vous pouvez examiner les journaux système pour trouver des entrées spécifiques.
  • Vérifiez les journaux :

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

  • Commandes de recherche : utilisez grep ou des outils de recherche de journaux similaires pour trouver les lignes de journaux suivantes :
    • Pour la synchronisation des métadonnées de l'organisation :

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

    • Exemple d'extrait de journal :

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

    • Recherchez le texte Configurer la synchronisation des métadonnées pour l'organisation, suivi du nom de l'organisation.
    • Pour la synchronisation des données d'exécution de l'organisation runtime-org :

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

    • Exemple d'extrait de journal :

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

    • Recherchez le texte Configurer la synchronisation des données d'exécution pour l'organisation, suivi du nom de l'organisation.

Comment obtenir des informations sur toutes les organisations et tous les environnements qui n'ont pas pu être activés à partir des journaux ?

Pour obtenir des informations sur les organisations qui n'ont pas pu être activées, vous pouvez examiner les journaux système à la recherche d'entrées d'erreur spécifiques.

• Vérifiez les journaux : /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Commandes de recherche : utilisez grep ou des outils de recherche de journaux similaires pour trouver les lignes de journal indiquant une erreur lors de la mise à jour de l'état de la synchronisation des métadonnées.
  • Pour les mises à jour de l'état de synchronisation des métadonnées ayant échoué pour l'organisation/l'environnement 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

  • Exemple d'extrait de journal :

    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

  • Recherchez le texte Error while updating metadata sync status for org/env:, suivi de l'organisation et de l'environnement (par exemple, failed-org/failed-env).

Comment obtenir un récapitulatif des changements d'état du transfert d'une organisation à partir des journaux ?

Pour obtenir un récapitulatif des dates de mise à jour de l'état de transfert de la synchronisation (organisation, environnement), vous pouvez examiner les journaux système pour trouver des entrées spécifiques.

• Vérifiez les journaux : /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• Commandes de recherche : utilisez grep ou des outils de recherche de journaux similaires pour trouver les lignes de journal indiquant une modification de l'état du transfert pour une organisation et un environnement.
  • Pour obtenir des informations sur l'état du transfert :

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

  • Exemple d'extrait de journal :

    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

  • Recherchez le texte exact "L'état du transfert a été mis à jour pour l'organisation/l'environnement", suivi de l'organisation et de l'environnement spécifiques (par exemple, org1/prod) et de l'état.