Untersuchen von Java-Ablaufverfolgungsprotokollen in Application InsightsExplore Java trace logs in Application Insights

Wenn Sie für die Ablaufverfolgung Logback oder Log4J (Version 1.2 bzw. 2.0) verwenden, werden Ihre Ablaufverfolgungsprotokolle automatisch an Application Insights gesendet. Hier können Sie sie durchsuchen und untersuchen.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.

Tipp

Sie müssen den Application Insights-Instrumentierungsschlüssel nur einmal für Ihre Anwendung festlegen.You only need to set your Application Insights Instrumentation Key once for your application. Wenn Sie ein Framework wie Java Spring verwenden, haben Sie den Schlüssel möglicherweise bereits an anderer Stelle in der Konfiguration Ihrer App registriert.If you are using a framework like Java Spring, you may have already registered the key elsewhere in your app's configuration.

Verwenden des Java-Agents von Application InsightsUsing the Application Insights Java agent

Sie können den Java-Agent von Application Insights so konfigurieren, dass Ihre Protokolle automatisch erfasst werden, indem Sie das Feature in der AI-Agent.xml-Datei aktivieren:You can configure the Application Insights Java agent to automatically capture your logs, by enabling the feature in the AI-Agent.xml file:

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

Alternativ können Sie die folgenden Anweisungen befolgen.Alternatively, you can follow the instructions below.

Installieren des Java SDKInstall the Java SDK

Führen Sie die Anweisungen zum Installieren des Application Insights SDK für Java durch, sofern dies noch nicht geschehen ist.Follow the instructions to install Application Insights SDK for Java, if you haven't already done that.

Hinzufügen von Protokollierungsbibliotheken zu Ihrem ProjektAdd logging libraries to your project

Wählen Sie die geeignete Methode für Ihr Projekt.Choose the appropriate way for your project.

Wenn Sie Maven verwenden...If you're using Maven...

Wenn Ihr Projekt bereits für die Verwendung von Maven für den Buildprozess eingerichtet ist, fügen Sie einen der folgenden Codeabschnitte Ihrer Datei "pom.xml" hinzu: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.

Aktualisieren Sie dann die Projektabhängigkeiten, damit die Binärdateien heruntergeladen werden.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>

Wenn Sie Gradle verwenden...If you're using Gradle...

Wenn Ihr Projekt bereits für die Verwendung von Gradle für Buildprozesse eingerichtet ist, fügen Sie eine der folgenden Zeilen der Gruppe dependencies in der Datei "build.gradle" hinzu: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:

Aktualisieren Sie dann die Projektabhängigkeiten, damit die Binärdateien heruntergeladen werden.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.+'

Andernfalls...Otherwise ...

Befolgen Sie die Richtlinien für die manuelle Installation des Application Insights Java SDK, laden Sie die JAR-Datei für den entsprechenden Appender herunter (klicken Sie dazu auf der Maven-Hauptseite im Downloadabschnitt auf den Link „jar“), und fügen Sie die heruntergeladene JAR-Datei für den Appender zum Projekt hinzu.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.

ProtokollierungstoolLogger DownloadDownload BibliothekLibrary
LogbackLogback JAR-Datei für Logback-AppenderLogback appender Jar applicationinsights-logging-logbackapplicationinsights-logging-logback
Log4J v2. 0Log4J v2.0 JAR-Datei für Log4J-v2-AppenderLog4J v2 appender Jar applicationinsights-logging-log4j2applicationinsights-logging-log4j2
Log4J v1. 2Log4j v1.2 JAR-Datei für Log4J-v1.2-AppenderLog4J v1.2 appender Jar applicationinsights-logging-log4j1_2applicationinsights-logging-log4j1_2

Hinzufügen des Appenders zu Ihrem ProtokollierungsframeworkAdd the appender to your logging framework

Zum Starten von Ablaufverfolgungen führen Sie den relevanten Codeausschnitt mit der Konfigurationsdatei für Log4J oder Logback zusammen: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>

Die Application Insights-Appender können von jeder konfigurierten Protokollierung und müssen nicht unbedingt von der Stammprotokollierung referenziert werden (siehe die obigen Codebeispiele).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).

Untersuchen Ihrer Ablaufverfolgungen im Application Insights-PortalExplore your traces in the Application Insights portal

Nachdem Sie das Projekt so konfiguriert haben, dass Ablaufverfolgungen an Application Insights gesendet werden, können Sie diese Ablaufverfolgungen im Application Insights-Portal auf dem Blatt Suche anzeigen und durchsuchen.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.

Über Protokollierungen übermittelte Ausnahmen werden im Portal als Ausnahmetelemetrie angezeigt.Exceptions submitted via loggers will be displayed on the portal as Exception Telemetry.

Öffnen Sie im Application Insights-Portal das Blatt „Suche“.

Nächste SchritteNext steps

DiagnosesucheDiagnostic search