Vérifier l'état et les erreurs d'importation

Vous pouvez vérifier l'état des importations de métadonnées et de données d'exécution à tout moment en interrogeant le point de terminaison d'état local du connecteur Apigee API Hub for Private Cloud.

Vérifier l'état de l'importation

Exécutez la commande curl suivante sur la machine virtuelle exécutant le connecteur Apigee API Hub for Private Cloud : 

curl localhost:8080/v1/uapim/status
 Une réponse réussie renvoie un objet JSON semblable à ce qui suit : 
    {
      "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"
        }
      ]
    }

Le résultat fournit des informations sur :

  • Métadonnées de l'API : état des importations de métadonnées de l'API, y compris l'organisation, l'environnement, l'étape actuelle (par exemple, "Transfert groupé", "Streaming", "Pas encore commencé"), le nombre total/terminé/en attente d'importations, le nombre d'erreurs et l'heure de la dernière mise à jour.
  • Métadonnées d'exécution : état des importations de données d'exécution, avec l'organisation, l'environnement, le nombre d'erreurs et l'heure de la dernière mise à jour.

Problèmes courants et étapes de dépannage

En cas de problème, consultez les journaux du connecteur et le point de terminaison d'état. Le fichier journal principal du connecteur de hub Apigee se trouve à l'emplacement /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

  1. Le connecteur Apigee API Hub for Private Cloud ne démarre pas :
    • Vérifiez les journaux : examinez /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log pour détecter les messages d'erreur liés à la configuration.
    • Vérifier les paramètres : vérifiez tous les paramètres configurés dans uapim-connector.properties et les variables d'environnement.
    • Accès Pub/Sub : vérifiez dans les journaux si opdk-connector peut accéder aux sujets Pub/Sub fournis.
    • Accès au serveur de gestion : vérifiez les journaux pour savoir si opdk-connector peut appeler le serveur de gestion Apigee avec l'URL et les identifiants fournis.
    • Temps de démarrage : si votre environnement Apigee comporte des milliers de déploiements, le connecteur de hub Apigee peut mettre environ 20 à 30 minutes à démarrer.
  2. Les métadonnées de l'API ne s'affichent pas dans le hub d'API :
    • Journaux du connecteur : consultez les journaux opdk-connector pour voir si le connecteur peut accéder au sujet Pub/Sub des métadonnées de l'API et appeler le serveur de gestion.
    • État de l'importation : vérifiez le résultat de curl localhost:8080/v1/uapim/status. Recherchez la section APIMetadata.
      • La date de dernière mise à jour est-elle récente ?
      • Le nombre d'erreurs augmente-t-il de manière constante ?
      • À quelle étape se trouve-t-il ?
    • Exceptions/erreurs : recherchez dans les journaux les exceptions ou les erreurs générées liées au traitement des métadonnées.
  3. Les données d'exécution ne s'affichent pas dans le hub d'API :
    • Journaux du connecteur : vérifiez si le connecteur opdk-connector peut accéder au sujet Pub/Sub du runtime et appeler le serveur de gestion.
    • État de l'importation : utilisez la commande curl localhost:8080/v1/uapim/status. Concentrez-vous sur la section RuntimeData.
      • La date de dernière mise à jour est-elle récente ?
      • Le nombre d'erreurs augmente-t-il de manière constante ?
    • Exceptions/erreurs : recherchez les exceptions ou les erreurs dans les journaux liés au traitement des données d'exécution.
    • Configuration du processeur de messages : assurez-vous que message-processor-communication.properties est correctement configuré sur tous les processeurs de messages pour la double écriture et que les processeurs de messages ont été redémarrés.
    • Installation NFS : vérifiez que l'installation NFS est correctement configurée et accessible à la fois par les MPs et le connecteur UAPIM.
  4. Le proxy est déployé, mais les informations du hub d'API ne sont pas exactes :
    • Temps d'attente : attendez quelques minutes que les données se propagent.
    • Journaux : consultez les journaux opdk-connector pour obtenir des informations sur les proxys importés. Cela peut vous aider à déterminer si le connecteur traite les événements de déploiement.