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 |
|---|---|
| O nome descritivo principal que identifica seu arquivo de instrumentação personalizada YAML. Inclua um espaço antes da propriedade |
| 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 |
| Se |
| Nenhum valor segue a propriedade |
| Corresponde ao objeto específico do MBean. Se você estiver usando o JDK versão 1.6 ou superior, |
| 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 |
| Não há valor na linha métrica. Incluir quatro espaços antes da métrica. |
| 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 |
|
|
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:
Abra o arquivo de configuração
newrelic.yml.Altere a propriedade nível de log para
log_level: finer.Inicie o aplicativo.
Verifique se o arquivo
logs/newrelic_agent.loginclui uma instrução indicando que o arquivo foi lido:Reading custom extension file /path/to/file/file.ymlSe 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.
Verifique se o arquivo inclui esta instrução:
Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAMLSe 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.