• /
  • 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

Agente Java: instrumentação JMX customizada por YAML

A plataforma Java SE inclui Java Management Extensions (JMX). JMX é uma forma de monitor e gerenciar aplicativos, dispositivos e serviços. Geralmente, os servidores de aplicativos possuem métricas JMX integradas que você pode monitor.

O agente Java da New Relic oferece a capacidade de monitor métricas específicas de MBeans e atributo em sua aplicação sem modificar o código usando um arquivo YAML de instrumentação personalizada. O agente Java irá ler o arquivo YAML na inicialização e registrar a métrica específica.

Dica

Você também pode monitor JMX com a infraestrutura de integração JMX.

Requisitos e acesso

O agente Java vê apenas métricas de MBeans em sua JVM atual. Se os MBeans estiverem sendo acessados remotamente ou existirem em uma JVM separada, eles não estarão disponíveis para o agente Java da New Relic.

Os dados JMX personalizados não serão exibidos em nossos gráficos, mas você pode consultar os dados e criar gráficos personalizados com eles.

Esta integração reporta apenas valores numéricos simples. Caso queira reportar outros tipos de valores, você pode querer utilizar a infraestrutura de integração JMX.

Regras de estrutura de arquivos

O arquivo de instrumentação personalizada deverá estar no formato YAML. Use um validador YAML para garantir que a sintaxe esteja precisa antes de usar o arquivo com o agente Java da New Relic e siga estas regras:

  • Os arquivos YAML diferenciam maiúsculas de minúsculas.
  • Todos os recuos estão em incrementos de dois caracteres. Os dados nas mesmas seções do arquivo devem usar o mesmo nível de recuo. Recue quaisquer subseções com dois espaços extras.
  • Você deve reiniciar o processo do host JVM para que as alterações entrem em vigor.

Propriedades disponíveis

Aqui está um resumo de cada propriedade no arquivo JMX. Para obter mais informações, consulte Exemplos JMX YAML personalizados.

Value

Definition

name

O nome descritivo principal que identifica seu arquivo de instrumentação personalizada YAML. Inclua um espaço antes da propriedade name .

version

A versão do arquivo de extensão. Se duas extensões tiverem o mesmo nome, somente a extensão com a versão mais recente será usada. Certifique-se de que a propriedade version esteja em uma linha separada de name. Inclua um espaço antes da propriedade version.

enabled

Se true, o agente Java lerá a extensão. Se false, o agente Java ignorará a extensão. Inclua um espaço antes da propriedade enabled .

jmx

Nenhum valor segue a propriedade jmx. Use zero espaços antes da propriedade.

object_name

Corresponde ao objeto específico do MBean. Se você estiver usando o JDK versão 1.6 ou superior, object_name poderá incluir asteriscos (*). Inclua dois espaços antes do travessão e um espaço entre o travessão e object_name.

root_metric_name

Disponível com o agente Java da New Relic versão 3.7.0 ou superior. Uma propriedade opcional que permite nomear a métrica usada no New Relic. Para usar valores de propriedade object_name , especifique a chave da propriedade entre colchetes ({}). O New Relic prefixará automaticamente o root_metric_name especificado com JMX e anexará o nome do atributo ao final da métrica. Inclua quatro espaços antes de root_metric_name.

metrics

Não há valor na linha métrica. Incluir quatro espaços antes da métrica.

attributes

Uma lista separada por vírgulas do atributo do MBean. O nome do atributo deve corresponder exatamente. Inclua 6 espaços antes do travessão e um espaço entre o travessão e a palavra-chave attributes .

type

  • Se simple, cada valor será relatado ao coletor New Relic.
  • Se monotonically_increasing (padrão), a diferença positiva será informada ao coletor New Relic.

Localização do arquivo YAML

O agente Java lê o arquivo YAML na inicialização do processo. Existem duas maneiras de especificar o local do arquivo YAML:

Cuidado

A métrica personalizada não funcionará se houver mais de um arquivo YAML na mesma pasta que o agente. Mova backups e cópias para outra pasta ao personalizar.

Verifique se o arquivo foi lido

Para verificar se o arquivo YAML foi lido pelo agente:

  1. Abra o arquivo de configuração newrelic.yml .

  2. Altere a propriedade nível de log para log_level: finer.

  3. Inicie o aplicativo.

  4. Verifique se o arquivo logs/newrelic_agent.log inclui uma instrução indicando que o arquivo foi lido:

    Reading custom extension file /path/to/file/file.yml
  5. Se você não conseguir encontrar esta instrução, verifique a localização do arquivo YAML. Certifique-se também de que o processo tenha acesso de leitura ao arquivo.

  6. Verifique se o arquivo inclui esta instrução:

    Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAML
  7. Se você não conseguir encontrar esta declaração, verifique se o documento foi analisado corretamente. Verifique também se existe outro arquivo de extensão com o mesmo nome e número de versão superior.

Consulta e gráfico de dados JMX

Você pode consultar seus dados JMX e usá-los para criar gráficos personalizados. Para saber mais sobre como consultar este tipo de dados consulte a consulta APM métrica.

Veja como pesquisar JMX ou o caminho direto para o contador conforme definido em seu arquivo YAML.

Para obter mais informações sobre como as métricas são nomeadas e armazenadas, consulte Exemplos JMX YAML personalizados.

Copyright © 2024 New Relic Inc.

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