Exploración de los registros de seguimiento de Java en Application Insights

Precaución

Este documento se aplica a Application Insights para Java 2.x, que ya no se recomienda.

La documentación de la versión más reciente se puede encontrar en Application Insights para Java 3.x.

Si está usando Logback o Log4J (v1.2 o v2.0) para el seguimiento, los registros de seguimiento se pueden enviar automáticamente a Application Insights, donde puede explorarlos y buscar en ellos.

Sugerencia

Solo tiene que establecer la clave de instrumentación de Application Insights una vez para la aplicación. Si usa una plataforma como Java Spring, es posible que ya haya registrado la clave en otra parte de la configuración de la aplicación.

Nota

El 31 de marzo de 2025 finalizará la compatibilidad con la ingesta de claves de instrumentación. La ingesta de claves de instrumentación seguirá funcionando, pero la característica ya no recibirá actualizaciones ni soporte técnico. Transición a las cadenas de conexión para aprovechar las nuevas funcionalidades.

Uso del agente de Java de Application Insights

De forma predeterminada, el agente de Java de Application Insights captura automáticamente el registro realizado en el nivel WARN y superiores.

Puede cambiar el umbral de registro capturado mediante el archivo AI-Agent.xml:

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

Puede deshabilitar la captura de registro del agente de Java mediante el archivo AI-Agent.xml:

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

También puede seguir las instrucciones que se indican a continuación (en lugar de usar el agente de Java)

Instalación del SDK de Java

Siga las instrucciones para instalar el SDK de Application Insights para Java, si aún no lo ha hecho.

Incorporación de bibliotecas de registro al proyecto

Elija la forma adecuada para su proyecto.

Si está usando Maven...

Si su proyecto ya se ha configurado para usar Maven para la compilación, combine uno de los siguientes fragmentos de código en el archivo pom.xml.

A continuación, actualice las dependencias del proyecto, para obtener los archivos binarios descargados.

Logback


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

Log4J v2.0


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

Log4J v1.2


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

Si está usando Gradle...

Si el proyecto ya se ha configurado para usar Gradle para la compilación, agregue una de las líneas siguientes al grupo dependencies en el archivo build.gradle.

A continuación, actualice las dependencias del proyecto, para obtener los archivos binarios descargados.

Logback


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

Log4J v2.0

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

Log4J v1.2

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

De lo contrario...

Siga las instrucciones para instalar manualmente el SDK de Java de Application Insights, descargar el archivo JAR (tras llegar a la página central de Maven, haga clic en el vínculo "jar" en la sección de descarga) para el appender adecuado y agregar al proyecto el archivo JAR del appender descargado.

Registrador Descargar Biblioteca
Logback JAR del appender de Logback applicationinsights-logging-logback
Log4J v2.0 JAR del appender de Log4J v2 applicationinsights-logging-log4j2
Log4J v1.2 JAR del appender de Log4J v1.2 applicationinsights-logging-log4j1_2

Incorporación del appender el marco de registro

Para empezar a recibir los seguimientos, combine el fragmento de código relevante al archivo de configuración Log4J o Logback:

Logback


    <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.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.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>

Los appenders de Application Insights pueden hacer referencia a cualquier registrador configurado y no necesariamente por el registrador de raíz (como se muestra en los ejemplos de código anteriores).

En el portal de Application Insights, explore los seguimientos.

Ahora que ha configurado el proyecto para enviar el seguimiento a Application Insights, puede ver y buscar estos seguimientos en el portal de Application Insights, en la hoja Búsqueda.

Las excepciones enviadas a través de registradores se mostrarán en el portal como telemetría de excepciones.

In the Application Insights portal, open Search

Pasos siguientes

Búsqueda de diagnóstico