Documentation Oracle Cloud Infrastructure

Surveiller les intégrations OIC avec APM

Vous pouvez surveiller les intégrations Oracle Integration Cloud (OIC) à Application Performance Monitoring (APM) en connectant un journal de flux d'activité OIC à la fonction prédéfinie d'émetteur de journal APM et en déplaçant les journaux de service vers un domaine APM. Pour plus d'informations, reportez-vous à Fonction d'émetteur de journal APM.

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

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. Capturez le flux d'activité de l'intégration dans une instance de journal. Suivez les étapes décrites dans Capture du 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'émetteur de journal APM à partir du catalogue Functions 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 relative à la fonction d'émetteur de journal APM.
  3. Connectez le journal de l'étape 1 à la fonction de l'étape 2 en créant un connecteur dans le Hub de connecteurs.

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

    • Ouvrez le menu de navigation et cliquez sur Analyse et IA. Sous Messagerie, cliquez sur Hub de connecteurs.
    • Cliquez sur le bouton Créer un connecteur.
    • Entrez un nom et, éventuellement, une description.
    • Sélectionner un compartiment
    • Sous Configurer le connecteur, définissez la source sur Journalisation et la cible sur Fonctions.
    • Sous Configurer la source, sélectionnez le groupe de journaux et les journaux dans le journal de flux de données d'activité configuré à l'étape 1.
    • Sous Configurer la cible, définissez l'application de fonction et la fonction sur 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. Stratégies de connecteur.

    Les stratégies 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'étendue

La liste des attributs pour les étendues OIC est fournie dans le tableau suivant. Ce tableau comprend :

  • Nom : nom de l'attribut.
  • Description : brève description de l'attribut.
  • Type : type d'attribut : dimension ou mesure.
Ils peuvent ne pas être immédiatement enregistrés pour les étendues OIC. Vous pouvez les ajouter manuellement dans la configuration du domaine APM, ou activer l'activation automatique si tel est le cas.
Nom Description Type
ActionName Nom de l'action, souvent celui qui a été configuré dans l'intégration OIC. Dimension
ActionType Classeur d'un mot pour l'opération OIC représentée par l'étendue. Par exemple, Switch, Mapper ou Notification. Dimension
AuditMessage Texte de message supplémentaire lorsque l'application OIC s'exécute en mode débogage ou audit. Dimension
EndpointConnectionId ID de l'adresse appelée. Dimension
EndpointName Nom de l'adresse qui est appelée. Dimension
EndpointType Type d'adresse appelée (rest, atpdatabase, ...). Dimension
InstanceCompletionState Défini pour l'étendue 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
Clé Clé d'un événement de suivi. Voir aussi Valeur. Dimension
Message Message que le flux d'activités OIC a consigné pour l'opération. Dimension
OpcRequestId L'opc-request-id du flux d'intégration OIC. Dimension
ProjectCode Code du projet OIC. Dimension
RecordType Définir sur certaines étendues importantes indiquant le type d'action représenté par l'étendue. Vous pouvez filtrer sur la présence de ce champ pour réduire le bruit des étendues moins importantes. Dimension
UserId L'utilisateur qui a créé l'intégration OIC. Dimension
Valeur Valeur d'un événement de suivi. Voir aussi Key. Dimension
EventId ID d'événement OIC Dimension
ParentEventId ID de l'événement précédent dans le flux d'activités. Dimension
InstanceId ID de flux OIC Dimension
ParentInstanceId ID de flux OIC du flux parent Dimension
ParentFlowParentEventId ID d'événement OIC de l'événement parent dans le flux parent. Dimension

Utiliser l'exploration de trace APM pour la surveillance

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