Documentation Oracle Cloud Infrastructure

Enregistrement des étendues APM en tant qu'événements JFR

L'agent APM et le traceur APM prennent en charge l'enregistrement des étendues APM en tant qu'événements JFR.

Actuellement, les versions 11 et ultérieures de JDK sont prises en charge.

Cette section s'applique à l'agent APM et aborde les sujets suivants :

Pour plus d'informations sur l'enregistrement des étendues APM en tant qu'événements JFR à l'aide du traceur APM, reportez-vous à Enregistrement des étendues APM en tant qu'événements JFR sous Configuration du traceur Java APM.

Remarque

JFR (Java Flight Recorder) est un outil de collecte de données de diagnostic et de profilage sur une application Java en cours d'exécution. Pour plus d'informations sur JFR et JMC (Java Mission Control), reportez-vous à JDK Mission Control.

Capture d'événements APM dans des enregistrements JFR

Pour capturer des événements APM dans des enregistrements JFR à l'aide de l'agent APM, procédez comme suit :

  1. Assurez-vous que l'agent APM fonctionne correctement.

    Ouvrez l'explorateur de traces et vérifiez que vous pouvez visualiser toutes les traces. Pour plus d'informations sur l'ouverture et l'utilisation de l'explorateur de traces, reportez-vous à Surveillance des traces dans l'explorateur de traces.

  2. Examinez le fichier de propriétés de l'agent APM.

    Le fichier AgentConfig.properties est le fichier de propriétés de l'agent APM situé sous le répertoire oracle-apm-agent/config/<version>.

    La propriété com.oracle.apm.agent.tracer.enable.jfr permet d'activer ou de désactiver l'ajout d'événements APM dans des enregistrements JFR rendus disponibles.

    La valeur par défaut de la propriété com.oracle.apm.agent.tracer.enable.jfr est TRUE, ce qui indique que les événements APM sont déjà activés dans les enregistrements JFR.

    Pour désactiver les événements APM dans les enregistrements JFR, définissez la propriété com.oracle.apm.agent.tracer.enable.jfr sur FALSE.

  3. Lancez un enregistrement.

    Pour vérifier que tout fonctionne correctement, vous devez lancer un enregistrement à l'aide de la méthode de votre choix (vous pouvez utiliser l'interface utilisateur de JDK Mission Control ou l'utilitaire de ligne de commande JCMD).

    Pour vérifier que les événements de trace APM sont correctement ajoutés aux enregistrements JFR, connectez-vous à JDK Mission Control et vérifiez que les traces APM apparaissent sous Navigateur d'événements : cliquez sur APM OpenTracing et vérifiez que les événements de trace APM sont visibles.