• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Instrumentação Java por XML

Para sua aplicação Java New Relic-monitor, um método de instrumentação personalizada é usar um arquivo XML para especificar os métodos de sua aplicação que devem ser instrumentados. O agente Java irá ler o arquivo XML e instrumentar as classes relevantes na inicialização; Os arquivos XML adicionados ao diretórioextensions após a inicialização não requerem uma reinicialização da JVM para serem detectados.

Veja agente Java instrumentação personalizada para uma descrição das opções de instrumentação personalizada e as razões para usá-las.

Acessando seu arquivo XML

Vá para one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Instrumentation. A partir daqui você pode:

  • Baixe um arquivo XML de amostra. (Você pode fazer isso no pop-up que aparece quando você clica em Import an XML file.)
  • Selecione um arquivo XML existente para edição.
  • Pesquise o histórico de instrumentação.

Estrutura do arquivo XML

Seu pacote de download do agente New Relic (newrelic_agent.zip) contém dois modelos para usar instrumentação XML:

  • O modelo extension.xsd é a definição do esquema XML que todas as extensões personalizadas devem seguir.
  • O modelo extension-example.xml é um exemplo. Este arquivo serve para alguns dos métodos básicos do JDK. Se você editar e renomear esse arquivo, certifique-se de modificar o atributo name="extension-example" para corresponder ao novo nome de arquivo.

Para obter mais informações sobre as propriedades no modelo extension.xsd , consulte a visão geral do formato de arquivo XML.

Validação de arquivo XML

Antes de iniciar seu aplicativo, valide seu arquivo XML usando a ferramenta de linha de comando do New Relic. A ferramenta de linha de comando só pode ser usada quando suas classes estão em um jar. Existem duas maneiras de validar sua instrumentação XML:

O aplicativo é executado com o newrelic.jar. A chamada deve conter a palavra-chave instrument seguida pelo sinalizador -file com o caminho para seu arquivo XML. A propriedade -debug é opcional e pode ser configurada como true para fornecer mais informações durante a validação.

A ferramenta irá:

  • Valide a sintaxe XML.
  • Verifique se cada classe a ser instrumentada está presente no class path.
  • Verifique se cada método está contido na classe apropriada.

Se o arquivo XML for válido, você verá uma instrução pass impressa no terminal:

PASS: The extension at file.txt was successfully validated.

Se o XML falhar na validação, você verá uma mensagem de falha impressa no terminal:

FAIL: reason

Localização do arquivo XML

O agente Java lê todos os arquivos XML no diretório extensions na inicialização do processo. O diretório extensions também é lido a cada ciclo de coleta. Os arquivos XML adicionados a esse diretório durante o tempo de execução serão lidos em alguns minutos, portanto, não requerem reinicialização da JVM.

Existem duas maneiras de especificar o local do arquivo XML:

XML file location options

Procedure

Crie um diretório de extensões

  1. No diretório onde newrelic.jar e newrelic.yml estão localizados, crie um diretório chamado extensions.
  2. Coloque o arquivo XML neste diretório com uma extensão .xml .
  3. Em newrelic.yml, verifique se a propriedade extensions.dir não está definida.

Especifique um diretório de extensões existente

  1. No arquivo de configuração newrelic.yml na seção comum, use a propriedade extensions.dir para especificar o diretório onde o arquivo XML está localizado.
  2. Certifique-se de que o arquivo esteja no diretório especificado e que tenha uma extensão .xml .

Verifique se o arquivo foi lido

Para verificar se o agente leu o arquivo XML, primeiro defina o gerenciamento de logs como finer:

  1. Edite o arquivo de configuração newrelic.yml e altere a propriedade log_level :

    log_level: finer
  2. Inicie ou reinicie o aplicativo.

Se a leitura foi bem-sucedida, logs/newrelic_agent.log indicará isso em uma instrução semelhante a:

Reading custom extension file /path/to/file.xml

Se nenhuma instrução aparecer em logs/newrelic_agent.log, o arquivo XML não foi encontrado. Verifique a localização do arquivo XML e certifique-se de que o processo New Relic tenha acesso de leitura ao arquivo.

Vários arquivos XML

Embora seja preferível usar um único arquivo XML, você pode usar vários arquivos XML personalizados. Todos esses arquivos serão instrumentados desde que o nome da extensão nos arquivos seja exclusivo.

  • Se dois arquivos XML personalizados contiverem o mesmo nome de extensão, aquele com a versão mais recente será implementado e o outro será ignorado.
  • Caso os dois arquivos tenham o mesmo nome e versão, então o primeiro arquivo lido pelo agente será implementado e o outro será ignorado.

XML e YAML

Antes de 2.10.0, Arquivos YAML podem ser usados para instrumentação personalizada. Esses arquivos YAML legados ainda são suportados. Porém, novos usuários deverão utilizar arquivos XML para instrumentação personalizada.

Legacy users: Se existirem arquivos YAML e XML com o mesmo nome de extensão, apenas o arquivo XML será instrumentado. O arquivo YAML será ignorado. Se você deseja que os arquivos YAML e XML sejam instrumentados, atribua a cada arquivo um nome de extensão diferente.

Exemplo de arquivo XML

Para obter um exemplo de arquivo XML de instrumentação personalizada, veja Exemplos Java XML.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.