Oracle Cloud Infrastructure-Dokumentation

OIC-Integrationen mit APM überwachen

Sie können Oracle Integration Cloud-(OIC-)Integrationen mit Application Performance Monitoring (APM) überwachen, indem Sie ein OIC-Aktivitätsstreamlog mit der vordefinierten Funktion des APM-Logabsenders verbinden und Servicelogs in eine APM-Domain verschieben. Weitere Informationen finden Sie unter APM-Logabsenderfunktion.

Mit Application Performance Monitoring können Sie Oracle Integration 3-Instanzen überwachen.
Hinweis

Oracle Integration 2-Instanzen werden nicht unterstützt.

Konfiguration

Führen Sie die folgenden Schritte aus, um das Monitoring einer Integrationsinstanz durch eine APM-Domain zu konfigurieren:

  1. Erfassen Sie den Aktivitätsstream der Integration in einer Loginstanz. Befolgen Sie die unter Aktivitätsstream von Integrationen in der Oracle Cloud Infrastructure-Konsole erfassen beschriebenen Schritte.
  2. Erstellen Sie eine Instanz der Funktion "APM-Logabsender" aus dem vordefinierten Functions-Katalog, und verweisen Sie sie auf die APM-Domain, die die Integration überwacht. Weitere Informationen finden Sie in der Dokumentation zur APM-Logabsenderfunktion.
  3. Verbinden Sie das Log von Schritt 1 mit der Funktion von Schritt 2, indem Sie einen Connector im Connector-Hub erstellen.

    Um einen Connector zu erstellen, befolgen Sie die folgenden Anweisungen:

    • Öffnen sie das Navigationsmenü, und klicken Sie auf Analytics und KI. Klicken Sie unter Messaging auf Connector Hub.
    • Klicken Sie auf die Schaltfläche Connector erstellen.
    • Geben Sie einen Namen und optional eine Beschreibung ein.
    • Wählen Sie ein Compartment.
    • Setzen Sie unter Connector konfigurieren die Option Quelle auf Logging, und das Ziel auf Funktionen.
    • Wählen Sie unter Quelle konfigurieren die Loggruppe und Logs im Aktivitätsstreamlog aus, das in Schritt 1 konfiguriert wurde.
    • Setzen Sie unter Ziel konfigurieren die Funktionsanwendung und Funktion auf die Funktion, die in Schritt 2 erstellt wurde.
    • Hinweis: Konfigurieren Sie keine Aufgabe.
    • Klicken Sie auf die Schaltfläche Erstellen.
    • Sie sollten jetzt einen Connector haben:
  4. Connector-Policys.

    Die folgenden Policys werden beim Erstellen des Connectors automatisch erstellt:

    • 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>'}

Span-Attribute

In der folgenden Tabelle finden Sie eine Liste der Attribute für OIC-Spans. Diese Tabelle enthält:

  • Name: Name des Attributs.
  • Beschreibung: Kurze Beschreibung des Attributs.
  • Typ: Attributtyp: Dimension oder Metrik.
Sie können nicht sofort für OIC-Spans aufgezeichnet werden. Sie können sie manuell in der APM-Domainkonfiguration hinzufügen oder die automatische Aktivierung aktivieren, wenn dies der Fall ist.
Name Beschreibung Typ
ActionName Ein Name für die Aktion, häufig der Name, der in der OIC-Integration konfiguriert wurde. Dimension
ActionType Ein Ein-Wort-Classifier für den OIC-Vorgang, den der Span darstellt. Beispiel: Switch, Mapper oder Notification. Dimension
AuditMessage Zusätzliche Meldung, wenn die OIC-Anwendung im Debug- oder Auditmodus ausgeführt wird. Dimension
EndpointConnectionId Die ID des aufgerufenen Endpunkts. Dimension
EndpointName Der Name des Endpunkts, der aufgerufen wird. Dimension
EndpointType Die Art des Endpunkts, der aufgerufen wird (Rest, atpdatabase, ...). Dimension
InstanceCompletionState Wird für den End-of-Flow-Bereich festgelegt, der angibt, ob der Ablauf erfolgreich abgeschlossen wurde. Dimension
IntegrationId Die OCID der OIC-Integration. Dimension
IntegrationVersion Die Versionsnummer der OIC-Integration. Dimension
Schlüssel Der Schlüssel eines Verfolgungsevents. Siehe auch Wert. Dimension
Nachricht Die Meldung, dass der OIC-Aktivitätsstream für den Vorgang protokolliert wurde. Dimension
OpcRequestId Die opc-request-id des OIC-Integrationsflusses. Dimension
ProjectCode Der OIC-Projektcode. Dimension
Berichtstyp Legen Sie bestimmte wichtige Spans fest, die angeben, welche Art von Aktion der Span darstellt. Sie können nach dem Vorhandensein dieses Feldes filtern, um das Rauschen von weniger wichtigen Spans zu reduzieren. Dimension
UserId Der Benutzer, der die OIC-Integration erstellt hat. Dimension
Wert Der Wert eines Verfolgungsevents. Siehe auch Key. Dimension
EventId Die OIC-Ereignis-ID Dimension
ParentEventId Die ID des vorherigen Ereignisses im Aktivitätsstream. Dimension
Instanz-ID Die OIC-Fluss-ID Dimension
ParentInstanceId Die OIC-Fluss-ID des übergeordneten Ablaufs Dimension
ParentFlowParentEventId Die OIC-Ereignis-ID des übergeordneten Ereignisses im übergeordneten Ablauf. Dimension

APM Trace explorieren für Monitoring verwenden

Nachdem Sie alle Konfigurationsschritte abgeschlossen haben, werden die Traces im Trace-Explorer unter der APM-Domain angezeigt, die für die Funktion "APM-Logabsender" konfiguriert wurde.