Exploration du suivi des journaux d’activité Java dans Application InsightsExplore Java trace logs in Application Insights

Si vous utilisez Logback ou Log4J (v1.2 ou v2.0) pour le suivi, vous pouvez faire en sorte que vos journaux d’activité de suivi soient envoyés automatiquement à Application Insights, où vous pouvez les explorer et effectuer des recherches.If you're using Logback or Log4J (v1.2 or v2.0) for tracing, you can have your trace logs sent automatically to Application Insights where you can explore and search on them.

Conseil

Vous ne devez définir votre clé d’instrumentation Application Insights qu’une seule fois pour votre application.You only need to set your Application Insights Instrumentation Key once for your application. Si vous utilisez une infrastructure comme Java Spring, vous avez peut-être déjà inscrit la clé ailleurs dans la configuration de votre application.If you are using a framework like Java Spring, you may have already registered the key elsewhere in your app's configuration.

Utilisation de l’agent Java Application InsightsUsing the Application Insights Java agent

Par défaut, l’agent Java Application Insights capture automatiquement la journalisation effectuée au niveau WARN et au-dessus.By default, the Application Insights Java agent automatically captures logging performed at WARN level and above.

Vous pouvez changer le seuil de journalisation capturé à l’aide du fichier AI-Agent.xml :You can change the threshold of logging that is captured using the AI-Agent.xml file:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsightsAgent>
   <Instrumentation>
      <BuiltIn>
         <Logging threshold="info"/>
      </BuiltIn>
   </Instrumentation>
</ApplicationInsightsAgent>

Vous pouvez désactiver la capture de la journalisation par l’agent Java à l’aide du fichier AI-Agent.xml :You can disable the Java agent's logging capture using the AI-Agent.xml file:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsightsAgent>
   <Instrumentation>
      <BuiltIn>
         <Logging enabled="false"/>
      </BuiltIn>
   </Instrumentation>
</ApplicationInsightsAgent>

Sinon (par opposition à l’utilisation de l’agent Java), vous pouvez suivre les instructions ci-dessous.Alternatively (as opposed to using the Java agent), you can follow the instructions below

Installer le Kit de développement logiciel (SDK) JavaInstall the Java SDK

Suivez les instructions pour installer le kit de développement logiciel (SDK) Application Insights pour Java, si ce n’est pas déjà fait.Follow the instructions to install Application Insights SDK for Java, if you haven't already done that.

Ajouter des bibliothèques de journalisation à votre projetAdd logging libraries to your project

Choisissez la méthode adaptée à votre projet.Choose the appropriate way for your project.

Si vous utilisez Maven...If you're using Maven...

Si votre projet est déjà configuré pour être assemblé avec Maven, fusionnez les extraits de code suivants dans votre fichier pom.xml.If your project is already set up to use Maven for build, merge one of the following snippets of code into your pom.xml file.

Actualisez ensuite les dépendances du projet pour télécharger les fichiers binaires.Then refresh the project dependencies, to get the binaries downloaded.

LogbackLogback


    <dependencies>
       <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>applicationinsights-logging-logback</artifactId>
          <version>[2.0,)</version>
       </dependency>
    </dependencies>

Log4J v2.0Log4J v2.0


    <dependencies>
       <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>applicationinsights-logging-log4j2</artifactId>
          <version>[2.0,)</version>
       </dependency>
    </dependencies>

Log4J v1.2Log4J v1.2


    <dependencies>
       <dependency>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>applicationinsights-logging-log4j1_2</artifactId>
          <version>[2.0,)</version>
       </dependency>
    </dependencies>

Si vous utilisez Gradle...If you're using Gradle...

Si votre projet est déjà configuré pour utiliser Gradle, ajoutez une des lignes suivantes au groupe dependencies dans votre fichier build.gradle :If your project is already set up to use Gradle for build, add one of the following lines to the dependencies group in your build.gradle file:

Actualisez ensuite les dépendances du projet pour télécharger les fichiers binaires.Then refresh the project dependencies, to get the binaries downloaded.

LogbackLogback


    compile group: 'com.microsoft.azure', name: 'applicationinsights-logging-logback', version: '2.0.+'

Log4J v2.0Log4J v2.0

    compile group: 'com.microsoft.azure', name: 'applicationinsights-logging-log4j2', version: '2.0.+'

Log4J v1.2Log4J v1.2

    compile group: 'com.microsoft.azure', name: 'applicationinsights-logging-log4j1_2', version: '2.0.+'

Sinon...Otherwise ...

Suivez les instructions pour installer manuellement le kit de développement logiciel (SDK) Application Insights pour Java, téléchargez le fichier jar (une fois sur la page principale Maven, cliquez sur le lien « jar » dans la section de téléchargement) de l'appender approprié, puis ajoutez le fichier jar de l'appender téléchargé au projet.Follow the guidelines to manually install Application Insights Java SDK, download the jar (After arriving at Maven Central Page click on 'jar' link in download section) for appropriate appender and add the downloaded appender jar to the project.

EnregistreurLogger TéléchargementDownload BibliothèqueLibrary
LogbackLogback Jar de l’appender LogbackLogback appender Jar applicationinsights-logging-logbackapplicationinsights-logging-logback
Log4J v2.0Log4J v2.0 Jar de l’appender Log4J v2Log4J v2 appender Jar applicationinsights-logging-log4j2applicationinsights-logging-log4j2
Log4J v1.2Log4j v1.2 Jar de l’appender Log4J v1.2Log4J v1.2 appender Jar applicationinsights-logging-log4j1_2applicationinsights-logging-log4j1_2

Ajouter l’appender à votre infrastructure de journalisationAdd the appender to your logging framework

Pour recevoir le suivi, fusionnez l’extrait de code approprié dans le fichier de configuration Log4J ou Logback :To start getting traces, merge the relevant snippet of code to the Log4J or Logback configuration file:

LogbackLogback


    <appender name="aiAppender" 
      class="com.microsoft.applicationinsights.logback.ApplicationInsightsAppender">
        <instrumentationKey>[APPLICATION_INSIGHTS_KEY]</instrumentationKey>
    </appender>
    <root level="trace">
      <appender-ref ref="aiAppender" />
    </root>

Log4J v2.0Log4J v2.0


    <Configuration packages="com.microsoft.applicationinsights.log4j.v2">
      <Appenders>
        <ApplicationInsightsAppender name="aiAppender" instrumentationKey="[APPLICATION_INSIGHTS_KEY]" />
      </Appenders>
      <Loggers>
        <Root level="trace">
          <AppenderRef ref="aiAppender"/>
        </Root>
      </Loggers>
    </Configuration>

Log4J v1.2Log4J v1.2


    <appender name="aiAppender" 
         class="com.microsoft.applicationinsights.log4j.v1_2.ApplicationInsightsAppender">
        <param name="instrumentationKey" value="[APPLICATION_INSIGHTS_KEY]" />
    </appender>
    <root>
      <priority value ="trace" />
      <appender-ref ref="aiAppender" />
    </root>

Les appenders Application Insights peuvent être référencés par n’importe quel enregistreur configuré et pas nécessairement par l’enregistreur racine (comme indiqué dans les exemples de code ci-dessus).The Application Insights appenders can be referenced by any configured logger, and not necessarily by the root logger (as shown in the code samples above).

Explorer le suivi dans le portail Application InsightsExplore your traces in the Application Insights portal

Maintenant que vous avez configuré votre projet pour qu’il envoie le suivi à Application Insights, vous pouvez rechercher et consulter ce suivi dans le portail Application Insights, dans le panneau Recherche.Now that you've configured your project to send traces to Application Insights, you can view and search these traces in the Application Insights portal, in the Search blade.

Les exceptions envoyées via les enregistreurs d'événements s'afficheront sur le portail en tant que données de télémétrie d'exception.Exceptions submitted via loggers will be displayed on the portal as Exception Telemetry.

Dans Application Insights, ouvrez Recherche

Étapes suivantesNext steps

Recherche de diagnosticDiagnostic search