Configurações gerais do agente Java

Para criar o diretório de extensões:

1. Navegue até o diretório onde newrelic.jar e newrelic.yml estão localizados. Crie um diretório chamado extensions.
2. Em newrelic.yml, verifique se a propriedade extensions.dir não está definida.

Para usar um diretório de extensões Java existente:

1. No arquivo newrelic.yml , localize a seção common .
2. Use a propriedade extensions.dir para especificar o local do arquivo.

Esta configuração é required. Você deve especificar a chave de licença associada à sua conta New Relic. Esta chave vincula os dados do seu agente à sua conta no serviço New Relic.

Esta configuração é required. Define o nome do aplicativo usado para reportar dados ao New Relic.

Se enable_auto_app_naming for falso, o agente reportará todos os dados para este aplicativo. Caso contrário, o agente reportará apenas tarefas em segundo plano (transação para aplicativo não web) para este aplicativo.

Para reportar dados para mais de um aplicativo, separe os nomes dos aplicativos com ponto e vírgula. Por exemplo, para reportar dados para My Application e My Application 2 use isto:

app_name: My Application;My Application 2

Para obter mais métodos de nomear seu aplicativo, consulte Nomeie seu aplicativo Java.

Sinalizador para habilitar o agente. Use esta configuração para forçar a execução ou não da execução do agente.

O limite apdex_t em segundos para a pontuação Apdex do aplicativo. Para o agente Java versões 1.2.008 ou superior, o valor apdex_t é configurado na interface e o valor em newrelic.yml é ignorado.

Número para diferenciar JVMs para o mesmo aplicativo na mesma máquina. New Relic usa host/port para unicidade, então você pode distinguir as JVMs colocando uma opção como esta nos argumentos de inicialização de cada JVM:

-Dnewrelic.config.appserver_port=8081

Depois de usar appserver_port para nomear as JVMs e reiniciá-las, você poderá vê-las individualmente no dropdown e na interface de criação de perfil.

Permite o registro em texto simples de todos os dados enviados ao New Relic para o arquivo de log do agente. Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Especifica um caminho para um pacote de certificado SSL personalizado que será usado pelo agente para estabelecer uma conexão segura com o New Relic. Se o seu pacote de certificado SSL personalizado não incluir certificados suficientes para se conectar ao New Relic, você precisará mesclar os certificados necessários em seu pacote de certificados personalizado.

Se vários endereços forem detectados durante o ciclo de conexão para um armazenamento de dados, essa configuração determinará qual endereço o agente escolherá:

• NONEO agente retorna um endereço vazio. Este é o comportamento padrão.

• FIRST: Usar o primeiro endereço detectado.

• LAST: Usar o último endereço detectado.

  Essa configuração existe no agente Java versão 8.25.0+.

Permite o relatório de dados separadamente para cada aplicativo web. Defina como true para ativar o suporte para nomeação automática de aplicativos. O nome de cada aplicativo web é detectado automaticamente e o agente reporta os dados separadamente para cada um. Isso fornece um detalhamento de desempenho mais detalhado para aplicativos da web no New Relic.

Para obter mais informações, consulte Nomeação automática de aplicativos.

Para obter mais métodos de nomear seu aplicativo, consulte Nomeie seu aplicativo Java.

Permite nomenclatura de transação baseada em componentes. Defina como true para ativar a nomenclatura de transação baseada em componentes. Defina como false para usar o URI de uma solicitação da web como o nome da transação. Para obter mais informações, consulte Nomenclatura de transação da web.

Ativa toda a instrumentação usando uma anotação @Trace . Desabilitar isso faz com que @Trace anotações sejam ignoradas.

Evento ingerir URI usado por algum recurso do agente. O padrão é o endpoint de ingestão de produção dos EUA. Pode ser configurado manualmente para enviar o evento para outro endpoint de ingestão (por exemplo, produção na UE: https://insights-collector.eu01.nr-data.net/v1/accounts/events).

Os clientes compatíveis com FedRAMP devem usar o endpoint compatível com FedRAMP: https://gov-insights-collector.newrelic.com/v1/accounts/events

Define a localização do diretório de extensões opcionais. Se esta propriedade não estiver configurada, o agente procurará um subdiretório denominado extensions no mesmo diretório que newrelic.jar e newrelic.yml.

Para que a alta segurança seja ativada, esta propriedade deve ser definida como true e a propriedade de alta segurança na interface do usuário do New Relic deve ser ativada. Ativar alta segurança significa que o SSL está ativado, a solicitação e a fila de parâmetros não são coletadas e a consulta não pode ser enviada para a New Relic em sua forma bruta.

Fornece a capacidade de configurar um endpointcompatível com FedRAMP para uso do agente, com o valor gov-collector.newrelic.com.

Uma chave de API de inserção válida para sua conta. Isso não é usado atualmente pelo agente.

Anexe a tag a este aplicativo.

Observe que esta opção agora habilita o tag, que substituiu o recurso de rótulo. Você ainda pode consultar seus rótulos históricos. Várias tags podem ser anexadas usando um ponto e vírgula como separador, como segue:

-Dnewrelic.config.labels="tagName1:tagValue1;tagName2:tagValue2;tagName3:tagValue3"

Em casos raros, pode ocorrer um vazamento de memória com instrumentação que usa a API assíncrona herdada para rastrear o ciclo de vida de servlets assíncronos ou Jetty Continuations. O vazamento de memória se manifestaria como transações vazadas que foram suspensas, mas nunca retomadas. Esta configuração funciona como uma solução alternativa para evitar que tal cenário ocorra. É aconselhável ativar esta solução alternativa apenas ao encontrar esse tipo de vazamento de memória.

Limita o número de linhas que o agente coleta de cada stack trace. Aumentar esse valor pode afetar o desempenho, pois aumenta a quantidade de memória que o agente usa e a quantidade de dados enviados para o New Relic.

URI de ingestão métrica utilizada por algum recurso do agente. O padrão é o endpoint de ingestão de produção dos EUA. Pode ser configurado manualmente para enviar métricas para outro endpoint de ingestão (exemplo de URI de produção da UE: https://metric-api.eu.newrelic.com/metric/v1).

Os clientes compatíveis com FedRAMP devem usar o endpoint compatível com FedRAMP: https://gov-metric-api.newrelic.com/metric/v1

O host proxy por meio do qual se conectará ao coletor New Relic. Se um proxy for usado, a configuração do host será necessária. Outras configurações de proxy são opcionais.

A senha para autenticação de proxy. Se um proxy for usado, a configuração do host será necessária. Outras configurações de proxy são opcionais. As configurações de nome de usuário e senha serão usadas para autenticar desafios de autenticação básica de um servidor proxy.

O número da porta do host proxy. Se um proxy for usado, a configuração do host será necessária. Outras configurações de proxy são opcionais.

O nome de usuário para autenticação de proxy, como autenticação Básica (texto não criptografado). Se um proxy for usado, a configuração do host será necessária. Outras configurações de proxy são opcionais. As configurações de nome de usuário e senha serão usadas para autenticar desafios de autenticação básica de um servidor proxy.

O esquema de proxy usado. A configuração proxy_scheme: "https" permitirá que o agente se conecte por meio de proxies usando o esquema HTTPS.

Se os erros são relatados para o Reactor Netty. O padrão é falso. Se definido como verdadeiro, os erros do Reactor Netty serão relatados.

Habilite o encerramento atrasado da JVM para dar ao agente a chance de enviar os dados métricos mais recentes para o New Relic antes do encerramento da JVM.

O número de segundos após os quais o agente usará a configuração send_data_on_exit .

Habilite relatórios de configurações de JVM para New Relic.

Quando definido como true, as propriedades da JVM serão enviadas para o New Relic.

Requer conexões com o coletor New Relic para passar por SSL.

O agente se comunica com o New Relic via HTTPS por padrão, e o New Relic requer HTTPS para todo o tráfego para APMe a API REST do New Relic.

Este trabalho é feito de forma assíncrona com os threads que processam o código da sua aplicação, portanto o tempo de resposta não será diretamente afetado por esta mudança.

Permita que o agente conecte o coletor New Relic imediatamente após a inicialização do aplicativo.

Para detalhes mais concisos do trace da transação, o agente não relata Scala Futures como segmentos de transação, e esses Futures não contribuem para o tempo total da transação.

Ativar scala_futures_as_segments aumenta sua sobrecarga. Se você deseja que o Scala Futures reporte como segmentos de transação para que você possa visualizá-los em um rastreamento da transação, você pode habilitá-lo:

scala_futures_as_segments:
  enabled: true

Quando o tempo exclusivo de um segmento for inferior a 2% do tempo total de transação, a métrica para aquela chamada de método será agregada em Java/other.

Definir trim_stats como false desativará esse comportamento, permitindo que as métricas sejam exibidas individualmente.

trim_stats: false

A partir da versão do agente 8.7.0, se definido como true e o Agente estiver em execução com o JBoss EAP/Wildfly, isso impedirá que o agente exija que qualquer classe no pacote javax.management seja carregada pelo carregador de classe do sistema. Isso foi adicionado para ajudar a corrigir problemas de inicialização do aplicativo com Módulos JBoss quando a API de gerenciamento J2EE/Jakarta é usada. Mais informações são fornecidas no documento resolução de problemas do JBoss/Wildfly.

Sinalizador expiratório que permite que o agente seja executado com versões java não suportadas.

Defina um nome de exibição para decorar o rótulo “host:port” na interface do New Relic. Requer agente Java 3.17 ou superior.

String contendo um caminho completo para o arquivo de configuração newrelic. Se estiver vazio, o agente assume que newrelic.yml está no mesmo diretório que newrelic.jar.

Habilite o log de depuração.

String contendo a configuração do ambiente a ser usada pelo agente.

String contendo o diretório inicial do agente. O padrão é o mesmo diretório do jarfile do agente.

String contendo o nome do arquivo de log do agente.