Explore registos de vestígios de Java na aplicação Informações

Atenção

Este documento aplica-se à aplicação Informações Java 2.x que já não é recomendado.

A documentação para a versão mais recente pode ser encontrada na Aplicação Informações Java 3.x.

Se estiver a utilizar o Logback ou o Log4J (v1.2 ou v2.0) para rastreio, pode enviar automaticamente os seus registos de rastreio para a Aplicação Informações onde poderá explorar e pesquisar neles.

Dica

Só precisa de definir a sua Chave de Instrumentação Informações aplicação uma vez para a sua aplicação. Se estiver a utilizar uma estrutura como a Java Spring, pode já ter registado a chave em outro lugar na configuração da sua aplicação.

Nota

A 31 de março de 2025, o suporte da ingestão de chaves de instrumentação terminará. A ingerção de chaves de instrumentação continuará a funcionar, mas deixaremos de fornecer atualizações ou suporte para a funcionalidade. Transição para cordas de ligação para tirar partido de novas capacidades.

Utilização da aplicação Informações agente Java

Por predefinição, o agente Java Informações aplica automaticamente captura a sessão realizada ao WARN nível e acima.

Pode alterar o limiar de registo registado que é capturado utilizando o AI-Agent.xml ficheiro:

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

Pode desativar a captura de registo do agente Java utilizando o AI-Agent.xml ficheiro:

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

Alternativamente (em vez de usar o agente Java), pode seguir as instruções abaixo

Instale o Java SDK

Siga as instruções para instalar a Aplicação Informações SDK para Java, caso ainda não o tenha feito.

Adicione bibliotecas madeireiras ao seu projeto

Escolha a forma adequada para o seu projeto.

Se estiver a utilizar Maven...

Se o seu projeto já estiver configurado para usar o Maven para construir, misture um dos seguintes excertos de código no seu ficheiro pom.xml.

Em seguida, refrescar as dependências do projeto, para fazer o binário ser descarregado.

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>

Se estiver a utilizar Gradle...

Se o seu projeto já estiver configurado para utilizar Gradle para construção, adicione uma das seguintes linhas ao dependencies grupo no seu ficheiro build.gradle:

Em seguida, refrescar as dependências do projeto, para fazer o binário ser descarregado.

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

Caso contrário...

Siga as diretrizes para instalar manualmente a aplicação Informações Java SDK, faça o download do jarro (Depois de chegar à Página Central de Maven clique no link 'jar' na secção de descarregamento) para obter um apetedante apropriado e adicione o frasco de appender descarregado ao projeto.

Madeir Download Biblioteca
Logback Logback appender Jar applicationinsights-logging-logback
Log4J v2.0 Frasco de appender Log4J v2 applicationinsights-logging-log4j2
Log4j v1.2 Frasco de appender Log4J v1.2 aplicações-ineserções-log4j1_2

Adicione o appender à sua estrutura de registo

Para começar a obter vestígios, misture o corte de código relevante para o ficheiro de configuração Log4J ou 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>

Os appenders Informações aplicações da aplicação podem ser referenciados por qualquer madeireira configurado, e não necessariamente pelo madeiriro raiz (como mostram as amostras de código acima).

Explore os seus vestígios no portal Informações aplicação

Agora que configura o seu projeto para enviar vestígios para a Aplicação Informações, pode visualizar e pesquisar estes vestígios no portal Informações aplicação, na lâmina de busca.

As exceções submetidas através de madeireiros serão apresentadas no portal como Telemetria de Exceção.

In the Application Insights portal, open Search

Passos seguintes

Pesquisa de diagnóstico