APM-Spans als JFR-Ereignisse aufzeichnen

APM-Agent und APM-Tracer unterstützen die Aufzeichnung von APM-Spans als JFR-Ereignisse.

Aktuell wird JDK 11 oder höher unterstützt.

Dieser Abschnitt gilt für den APM-Agent und enthält die folgenden Themen:

Informationen zum Aufzeichnen von APM-Spans als JFR-Ereignisse bei Verwendung des APM-Tracers finden Sie unter APM-Spans als JFR-Ereignisse aufzeichnen unter APM-Java-Tracer konfigurieren.

Hinweis

Java Flight Recorder (JFR) ist ein Tool zum Erfassen von Diagnose- und Profilingdaten über eine ausgeführte Java-Anwendung. Informationen zu Java Flight Recorder (JFR) und Java Mission Control (JMC) finden Sie unter JDK Mission Control.

APM-Ereignisse in JFR-Aufzeichnungen erfassen

So erfassen Sie APM-Ereignisse in JFR-Aufzeichnungen bei Verwendung des APM-Agent:

  1. Stellen Sie sicher, dass der APM-Agent ordnungsgemäß arbeitet.

    Öffnen Sie den Trace-Explorer, und vergewissern Sie sich, dass Sie alle Traces anzeigen können. Informationen zum Öffnen und Verwenden des Trace-Explorers finden Sie unter Traces im Trace-Explorer überwachen.

  2. Prüfen Sie die APM-Agent-Eigenschaftendatei.

    Die Datei AgentConfig.properties ist die APM-Agent-Eigenschaftendatei im Verzeichnis oracle-apm-agent/config/<version>.

    Die Eigenschaft com.oracle.apm.agent.tracer.enable.jfr aktiviert oder deaktiviert das Hinzufügen von APM-Ereignissen in JFR-Aufzeichnungen, die verfügbar gemacht werden.

    Der Standardwert für die Eigenschaft com.oracle.apm.agent.tracer.enable.jfr ist TRUE, d.h., APM-Ereignisse sind in JFR-Aufzeichnungen bereits aktiviert.

    Um APM-Ereignisse in JFR-Aufzeichnungen zu deaktivieren, setzen Sie die Eigenschaft com.oracle.apm.agent.tracer.enable.jfr auf FALSE.

  3. Starten Sie eine Aufzeichnung.

    Um zu testen, ob alles ordnungsgemäß funktioniert, müssen Sie anhand Ihrer bevorzugten Methode eine Aufzeichnung starten (entweder über die JDK Mission Control-UI oder das JCMD-Befehlszeilenutility).

    Um zu überprüfen, ob APM-Traceereignisse ordnungsgemäß zu JFR-Aufzeichnungen hinzugefügt wurden, melden Sie sich bei JDK Mission Control an, und vergewissern Sie sich, dass die APM-Traces im Ereignisbrowser sichtbar sind: Klicken Sie auf APM OpenTracing, und vergewissern Sie sich, dass APM-Traceereignisse sichtbar sind.