Surveiller les intégrations d'OCI avec APM

Vous pouvez surveiller les intégrations Oracle Integration Cloud (OIC) avec Application Performance Monitoring (APM) en connectant un journal de flux d'activités OIC à la fonction prédéfinie de l'expéditeur de journal APM et en déplaçant les journaux de service vers un domaine APM. Pour plus de détails, voir Fonction d'expéditeur de journal APM.

Application Performance Monitoring peut être utilisé pour surveiller les instances Oracle Integration 3.
Note

Les instances Oracle Integration 2 ne sont pas prises en charge.

Configuration

Pour configurer la surveillance d'une instance Integration par un domaine APM, procédez comme suit :

  1. Saisir le flux d'activités de l'intégration dans une instance de journal. Suivez les étapes décrites sous Saisir le flux de données d'activités des intégrations dans la console Oracle Cloud Infrastructure.
  2. Créez une instance de la fonction d'expéditeur de journal APM à partir du catalogue des fonctions prédéfini et pointez-la vers le domaine APM qui surveillera l'intégration. Pour plus de détails, suivez les instructions de la documentation sur la fonction d'expéditeur de journal APM.
  3. Connectez le journal de l'étape 1 à la fonction de l'étape 2 en créant un connecteur dans le centre de connecteurs.

    Pour créer un connecteur, suivez les instructions ci-dessous :

    • Ouvrez le menu de navigation et cliquez sur Analyse et intelligence artificielle. Sous Messagerie, cliquez sur Centre de connecteurs.
    • Cliquez sur le bouton Créer un connecteur.
    • Entrez un nom et une description facultative.
    • Sélectionnez un compartiment.
    • Sous Configurer le connecteur, réglez la source à Journalisation et la cible à Fonctions.
    • Sous Configurer la source, sélectionnez le groupe de journaux et les journaux dans le journal de flux de données d'activités configuré à l'étape 1.
    • Sous Configurer la cible, réglez l'application de fonction et la fonction à la fonction créée à l'étape 2.
    • Remarque : Ne configurez pas de tâche.
    • Cliquez sur le bouton Créer.
    • Vous devez maintenant avoir un connecteur :
  4. Politiques de connecteur.

    Les politiques suivantes sont créées automatiquement lors de la création du connecteur :

    • Allow any-user to use fn-function in compartment id <target_function_compartment_ocid> where all
      {request.principal.type='serviceconnector', request.principal.compartment.id='<serviceconnector_compartment_ocid>'}
    • Allow any-user to use fn-invocation in compartment id <target_function_compartment_ocid> where all
       {request.principal.type='serviceconnector', request.principal.compartment.id='<serviceconnector_compartment_ocid>'}

Attributs d'intervalle

La liste des attributs pour les intervalles OIC est fournie dans le tableau suivant. Ce tableau comprend les éléments suivants :

  • Nom : Nom de l'attribut.
  • Description : Brève description de l'attribut.
  • Type : Type d'attribut : Dimension ou Mesure.
Ils ne peuvent pas être enregistrés immédiatement pour les intervalles de l'OCI. Vous pouvez les ajouter manuellement dans la configuration du domaine APM ou activer l'activation automatique si tel est le cas.
Le nom Description Type
ActionName Nom de l'action, souvent celui qui a été configuré dans l'intégration OIC. Dimension
ActionType Classificateur d'un mot pour l'opération OIC représentée par l'intervalle. Par exemple, Switch, Mapper ou Notification. Dimension
AuditMessage Texte de message supplémentaire lorsque l'application OIC s'exécute en mode de débogage ou de vérification. Dimension
EndpointConnectionId ID du point d'extrémité appelé. Dimension
EndpointName Nom du point d'extrémité appelé. Dimension
EndpointType Type de point d'extrémité appelé (rest, atpdatabase, ...). Dimension
InstanceCompletionState Défini pour l'intervalle de fin de flux, indiquant si le flux s'est terminé avec succès. Dimension
IntegrationId OCID de l'intégration OIC. Dimension
IntegrationVersion Numéro de version de l'intégration OIC. Dimension
Touche Clé d'un événement de suivi. Voir aussi Valeur. Dimension
Message Message que le flux de données d'activités OIC a enregistré pour l'opération. Dimension
OpcRequestId Opc-request-id du flux d'intégration OIC. Dimension
ProjectCode Code de projet OIC. Dimension
Type d'enregistrement Réglé sur certains intervalles importants indiquant le type d'action que l'intervalle représente. Vous pouvez filtrer la présence de ce champ pour réduire le bruit des intervalles moins importants. Dimension
UserId Utilisateur qui a créé l'intégration OIC. Dimension
Valeur Valeur d'un événement de suivi. Voir aussi Key. Dimension
EventId ID événement OIC Dimension
ParentEventId ID de l'événement précédent dans le flux de données d'activités. Dimension
InstanceId ID flux OIC Dimension
ParentInstanceId ID flux OIC du flux parent Dimension
ParentFlowParentEventId ID événement OIC de l'événement parent dans le flux parent. Dimension

Utiliser APM Trace Explore pour la surveillance

Une fois toutes les étapes de configuration terminées, les traces sont visibles dans l'explorateur de trace sous le domaine APM configuré pour la fonction d'expéditeur de journal APM.