Piste d'API dans le cloud

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture
  • La piste d'API dans le cloud est un journal d'activité pour toutes les activités qui utilisent l'API dans le cloud et passent par le Serveur MID.

    Contenu de la piste d'API dans le cloud

    Figure 1. Formulaire Piste CAPI
    Formulaire Piste d’API dans le cloud
    Champ Description
    ID d'acheminement dynamique Numéro d'ID généré automatiquement pour l'entrée.
    Nom MID Nom du Serveur MID par lequel la Découverte a été effectuée.
    État de l'acheminement Indique si l'opération Découverte exécutée par l'API a réussi. Les valeurs possibles sont les suivantes :
    • réussite
    • erreur
    • exécution en cours
    Paramètres d'entrée Paramètre d'entrée qui a généré l'enregistrement de piste d'API. Cette valeur est généralement le centre de données dans lequel la Découverte a été effectuée.
    Nom de l'interface
    Invoqué par Cette valeur est toujours CMP lors de l'exécution de Découverte.
    Nom de méthode Opération d'interface à partir de l'API dans le cloud qui a traité cet enregistrement.
    Nom du fournisseur Fournisseur dans le cloud.
    Version Version spécifiée dans l'API dans le cloud.

    Journaux de piste CAPI

    La liste connexe Journaux de piste CAPI fournit plus de détails sur l'entrée de la piste d'API dans le cloud. Les types de clés de journal suivants sont disponibles :

    Clé du journal Description
    route_data Informations sur les appels d'API dans le cloud.
    dynamic_route Informations sur l'acheminement réel que les données ont pris, y compris les URI.
    route_result Charge utile reçue par l'instance ou description du résultat du transfert de données. Charge utile
    chunk_number Nombre de blocs de données reçus par l'instance.
    route_status Indique si la connexion de l'acheminement et le transfert de charge utile ont réussi.
    route_error Erreur qui s'est produite. Par exemple, l'erreur Failed to list loadbalancer Failed : HTTP error code : 403 signifie que vos informations d'identification étaient incorrectes et que Découverte n'a pas pu accéder à la ressource dans le cloud.
    errorDetail Plus de détails sur l'erreur, y compris l'API Cloud Provisioning and Governance et le connecteur qui a été utilisé dans la tentative Découverte, et les erreurs que le fournisseur de cloud a générées.
    Voici un exemple de route_error :
    Failed to list loadbalancer Failed : HTTP error code : 403

    Voici un exemple de l'entrée error_detail pour la même erreur :

    com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerException: Failed to list loadbalancer Failed : HTTP error code : 403
           at com.snc.cmp.connector.cloud.loadbalancer.customizer.impl.AWSLoadBalancerCustomizer.listLoadBalancers(AWSLoadBalancerCustomizer.java:56)
    	at com.snc.cmp.connector.cloud.loadbalancer.component.LoadBalancerProducer.process(LoadBalancerProducer.java:46)
    	at org.apache.camel.util.AsyncProcessorConverterHelper$ProcessorToAsyncProcessorBridge.process(AsyncProcessorConverterHelper.java:61)
           at org.apache.camel.processor.SendProcessor.process(SendProcessor.java:145)
           ...

    Ces deux erreurs signifient que les informations d'identification étaient incorrectes et que Découverte n'a pas pu accéder à la ressource dans le cloud. L'interface d'équilibreur de charge génère la première erreur, car l'appareil d'équilibreur de charge est le premier appareil qui permet d'accéder à la ressource dans le cloud. Les erreurs org.apache.camel indiquent des erreurs d'acheminement du côté d'Amazon Web Services.

    L'erreur correspondante du côté de l'instance est capturée dans la piste d'orchestration dans le cloud.

    Ouvrir la piste d'API dans le cloud

    Ouvrez la piste d'API dans le cloud pour déboguer et résoudre des problèmes tels qu'un échec de la politique ou de la Découverte des ressources dans le cloud.

    Avant de commencer

    Rôle requis : sn_cmp.cloud_operator ou sn_cmp.cloud_admin

    Procédure

    1. Dans le portail d’administration du cloud, accédez à Exploiter  > Pistes.
    2. Dans l'onglet Piste d'API dans le cloud, filtrez et triez la liste des enregistrements de la piste d'API dans le cloud selon vos besoins.
      Si, par exemple, vous recherchez un échec de Découverte, filtrez la liste afin que la colonne État de l'acheminement affiche uniquement les entrées contenant erreur.
    3. Cliquez sur un lien dans la colonne Créé pour ouvrir l'enregistrement de piste d'API dans le cloud.
    4. Dans la liste connexe Journaux de piste CAPI, ouvrez l'enregistrement de journal qui affiche les informations que vous souhaitez.
      Par exemple, ouvrez route_error ou error_detail pour déboguer une opération ayant échoué.