Configuração do agente Java: arquivo de configuração

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.

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 obter detalhes mais concisos do rastreamento da transação, o agente não reporta os Futuros Scala como segmentos de transação, e esses Futuros 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.

Quando definido como true, ativa o AI Monitoring.

Se definido como false, o agente omitirá o conteúdo de entrada e saída (como sequências de texto de prompt e respostas) capturado no evento LLM. Esta é uma configuração de segurança opcional se você não quiser registrar dados confidenciais enviados e recebidos de seus LLMs.

Esta configuração pode ser usada para ativar ou desativar todos os atributos.

Se atributo estiver habilitado, as chaves de atributo encontradas nesta lista serão enviadas para a New Relic. Separe as chaves da lista com vírgula; por exemplo:

key1, key2, key3

Consulte também as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para a New Relic. Separe as chaves da lista com vírgula; por exemplo:

key1, key2, key3

Consulte também as regras de atribuição de agentes.

O relatório atributo é configurável através dos seguintes meios.

YAML:

attributes:
http_attribute_mode: both

Propriedade do sistema:

-Dnewrelic.config.attributes.http_attribute_mode=both

Variável de ambiente:

NEW_RELIC_ATTRIBUTES_HTTP_ATTRIBUTE=both

As opções de configuração são:

• standard : Os relatórios utilizarão padrões (ou seja, OTEL) atributo. Esta configuração é incentivada. Isso minimizará o impacto na funcionalidade e manterá o nível mais baixo de ingestão para relatórios de atributo.
• legacy : Os relatórios serão feitos pelo atributo HTTP reintroduzido, esta configuração pode impactar a funcionalidade atual ou futura.
• both : Esta é a configuração padrão, o reporte será feito pelo atributo HTTP reintroduzido e pelo atributo OTEL. Esta configuração também aumentará a ingestão de dados.

O número de segundos após os quais o agente expirará automaticamente um token assíncrono que não tenha expirado explicitamente com token.expire(). Para obter instruções de uso, consulte token: Conectar threads assíncronos.

O número de segundos após os quais o agente encerrará automaticamente um segmento que não foi explicitamente encerrado com segment.end() ou segment.ignore(). Para obter instruções de uso, consulte Segmentos: atividade assíncrona arbitrária de tempo.

Por padrão, o agente insere automaticamente uma chamada de API em JSPs compilados para injetar o JavaScript de monitoramento nas páginas da web. Defina esse atributo como false para desativar esse comportamento.

Quando auto_instrument é true, por padrão todas as páginas são instrumento. Liste todas as páginas que você deseja que a instrumentação automática ignore aqui. Você ainda pode usar instrumentação manual nestas páginas.

Por exemplo:

browser_monitoring:
  disabled_auto_pages: /WEB-INF/jsp/testpage_1.jsp, /WEB-INF/jsp/testpage_2.jsp

Esta configuração pode ser usada para ativar ou desativar todos os atributos de monitoramento do Browser. Esses são os dados que você pode consultar. Se attributes.enabled for falso no nível raiz, nenhum atributo será enviado no monitoramento do Browser independente de como esta propriedade em browser_monitoring estiver configurada.

Se atributo estiver ativado para browser_monitoring, todas as chaves de atributo encontradas nesta lista serão enviadas para New Relic em visualizações de página. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para a New Relic nas visualizações de página. Para mais informações, consulte as regras de atribuição de agentes.

Se o seu aplicativo estiver se comportando conforme o esperado, você pode desabilitar o circuit breaker.

Personalize a porcentagem de memória heap livre abaixo da qual o circuit breaker deve desarmar. Quando a porcentagem de memória de heap livre for menor que memory_threshold e o tempo de CPU gasto na coleta de lixo for maior que gc_cpu_threshold, o circuit breaker. Para diminuir a probabilidade de o circuit breaker desarmar, diminua memory_threshold e/ou aumente gc_cpu_threshold. Ajuste esses valores conforme necessário, com base no desempenho operacional e no comportamento do seu aplicativo.

Personalize a porcentagem do tempo de CPU da coleta de lixo acima do qual o circuit breaker deve desarmar. Quando a porcentagem de memória heap livre for menor que memory_threshold e o tempo de CPU gasto na coleta de lixo for maior que gc_cpu_threshold, o circuit breaker . Para diminuir a probabilidade de o circuit breaker desarmar, diminua memory_threshold e/ou aumente gc_cpu_threshold. Ajuste esses valores conforme necessário, com base no desempenho operacional e no comportamento do seu aplicativo.

Determina se o agente pesquisa a API de metadados da AWS.

Determina se o agente pesquisa a API de metadados do Azure.

Determina se o agente pesquisa a API de metadados do Google Cloud Platform.

Determina se o agente reporta a variável de ambiente KUBERNETES_SERVICE_HOST .

Determina se o agente lê variáveis de ambiente do Pivotal Cloud Foundry.

Determina se o agente lê informações Docker do sistema de arquivos.

o nível do código métrico está desabilitado por padrão na versão 7.10.0 do agente. Defina isso como verdadeiro para ativá-lo. A partir da versão 7.11.0 do agente, o padrão é, conforme observado acima, true.

o rastreamento multiaplicativo está habilitado por padrão. Defina isso como falso para desligá-lo.

Isto habilita o serviço de evento personalizado.

O tamanho máximo de um valor de atributo, após o qual o valor será truncado. O padrão é 255 bytes (na codificação UTF-8 charset) e o limite máximo é 4095.

Esta configuração existe no agente Java versão 8.9.0+.

• O número máximo de eventos personalizados amostrados relatados a cada 60 segundos.
• Ao configurar o agente para AI Monitoring, defina o valor máximo 100000. Garante que a quantidade máxima de eventos LLM seja capturada.

Quando habilitado, a nomenclatura aprimorada de transação Spring nomeará qualquer transação originada de um controlador Spring após a rota definida e o método HTTP. Por exemplo: /customer/v1/edit (POST). Isso inclui controladores que implementam ou estendem interfaces/classes com anotações relacionadas ao WebMVC (@RestController, @Controller, @RequestMapping, etc).

Por padrão, isso é configurado para false, que nomeará a transação para esses tipos de controladores com base no nome e método da classe do controlador. Por exemplo; CustomerController/edit. Esta é a lógica de nomenclatura herdada das versões anteriores do agente. Controladores "padrão", com todas as anotações relevantes presentes na classe real, ainda serão nomeados com base na rota e no método HTTP.

Esta configuração existe no agente Java versão 8.9.0+.

Por padrão, o ponto de extremidade do atuador integrado e o ponto de extremidade do atuador personalizado (usando a anotação @endpoint e suas subclasses) serão todos nomeados como OperationHandler/handle no New Relic. Habilitar essa configuração fará com que o nome da transação reflita o URI endpoint do atuador base real. Por exemplo, invocar /actuator/loggers ou actuator/loggers/com.newrelic resultará no nome da transação actuator/loggers (GET). Isso é para evitar MGI.

Suportado ao usar Spring Boot v3 e posterior.

Esta configuração existe na versão 8.15.0+ do agente Java.

String contendo o nome completo da classe de anotação que o agente usa para determinar quais métodos especificados pelo usuário devem ser usados. Para obter mais informações sobre anotações customizadas, consulte Coleção Java métrica personalizada.

Ative esta opção para capturar o nome userPrincipal . Este nome está incluído como trace da transação atributo (com nomes de atributo user e enduser.id), e pode ser consulta. Isso também permite que você veja na Errors Inbox quantos usuários foram impactados por um grupo de erros.

Defina como false para desativar distributed tracing. Por exemplo, no arquivo de configuração, você usaria:

distributed_tracing:
  enabled: false

Aqui estão outras opções para desativar distributed tracing:

Propriedade do sistema:

-Dnewrelic.config.distributed_tracing.enabled=false

Variável de ambiente:

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=false

Por padrão, as versões suportadas do agente utilizam o cabeçalho newrelic e os cabeçalhos W3C Trace Context para distributed tracing. O cabeçalho distributed tracing newrelic permite interoperabilidade com agentes mais antigos que não suportam cabeçalhos W3C Trace Context . As versões do agente que suportam cabeçalhos W3C Trace Context os priorizarão em relação a newrelic cabeçalhos para distributed tracing.

Se você não quiser utilizar o cabeçalho newrelic, defini-lo como true fará com que o agente exclua o cabeçalho newrelic e use apenas cabeçalhos W3C Trace Context para distributed tracing.

Por exemplo, para excluir cabeçalhos newrelic no arquivo de configuração, você usaria:

distributed_tracing:
  exclude_newrelic_header: true

Para excluir cabeçalhos newrelic usando uma propriedade do sistema, você usaria:

-Dnewrelic.config.distributed_tracing.exclude_newrelic_header=true

Habilite a coleta de erros.

Os nomes de classes de exceção especificados serão ignorados e não afetarão taxa de erros ou pontuação Apdex, nem serão reportados à APM. Cannot be specified by system property.

Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Por exemplo:

error_collector:
  ignore_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

Uma variável de ambiente pode ser usada para listar nomes de classes de exceção que você deseja que sejam ignorados:

NEW_RELIC_ERROR_COLLECTOR_IGNORE_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

Especifique os nomes das classes de exceção que o agente deve ignorar. Mensagens ignoradas não afetarão taxa de erros ou pontuação Apdex, nem serão reportadas à APM. Contém yaml pares que consistem em:

• Um nome de classe de exceção totalmente qualificado que não deve ser relatado ao APM

  E

• Uma lista de exceções messages para correspondência (pelo menos uma é obrigatória)

  Se o nome da classe de exceção corresponder a um erro, mas a mensagem não, esse erro will not será ignorado. As sequências de mensagens usam contains para correspondência. Uma mensagem não pode ser fornecida sozinha e deve sempre ser associada a um nome de classe totalmente qualificado. Cannot be specified by system property.

  Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

  Por exemplo:

  error_collector:
    ignore_messages:
      com.example.MyException:
        - "Some error message to ignore"
        - "Some other error message to ignore"
      com.example.DifferentException:
        - "Some different error message to ignore"

  Copiar

  Uma variável de ambiente pode ser usada para listar nomes de classes de exceção e mensagens que você deseja ignorar:

  NEW_RELIC_ERROR_COLLECTOR_IGNORE_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

  Copiar

Uma lista separada por vírgulas composta por intervalos individuais e tracejados de códigos de status HTTP que não devem ser tratados como erros.

Se esta propriedade for comentada no arquivo de configuração newrelic.yml , o código de status 404 será automaticamente ignorado. Ao utilizar a configuração no lado do servidor, o código de status 404 deve ser especificado para que seja ignorado.

Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Por exemplo:

error_collector:
  ignore_status_codes: 404,507-511

Impede que classes de exceção especificadas afetem a taxa de erros ou a pontuação Apdex enquanto ainda relatam os erros ao APM. Cannot be specified by system property.

Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Por exemplo:

error_collector:
  expected_classes:
    - "com.example.MyException"
    - "com.example.DifferentException"

Uma variável de ambiente pode ser usada para listar nomes de classes de exceção esperados:

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_CLASSES="[\"com.example.MyException\", \"com.example.DifferentException\"]"

Contém pares yaml que consistem em um nome de classe de exceção totalmente qualificado que deve ser marcado como esperado e, portanto, impedido de afetar taxa de erros ou pontuação Apdex e uma lista de exceções messages para correspondência, a última das quais pelo menos uma é obrigatória . Se o nome da classe de exceção corresponder a um erro, mas a mensagem não, então esse erro will not será marcado como esperado e, portanto, afetará a taxa de erros e a pontuação do Apdex.

As sequências de mensagens usam contains para correspondência. Uma mensagem não pode ser fornecida sozinha e deve sempre ser associada a um nome de classe totalmente qualificado. Cannot be specified by system property.

Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Por exemplo:

error_collector:
  expected_messages:
    com.example.MyException:
      - "Some expected error message"
      - "Some other expected error message"
    com.example.DifferentException:
      - "Some different expected error message"

Uma variável de ambiente pode ser usada para listar nomes e mensagens de classes de exceção esperadas:

NEW_RELIC_ERROR_COLLECTOR_EXPECTED_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"

Uma lista separada por vírgulas composta por intervalos individuais e tracejados de códigos de status HTTP a serem marcados como esperado e, assim, impedidos de afetar taxa de erros ou pontuação Apdex.

Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

Por exemplo:

error_collector:
  expected_status_codes: 415,500-506

Os códigos de status esperados também podem estar na variável de ambiente NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES .

Esta configuração pode ser usada para ativar ou desativar todos os atributos para erros de rastreamento. Se attributes.enabled for false no nível raiz, nenhum atributo será enviado para erros de rastreamento, independentemente de como essa propriedade estiver configurada em error_collector.

Se atributo estiver habilitado para erros de rastreamento, todas as chaves de atributo encontradas nesta lista serão enviadas para New Relic em erros de rastreamento. Para mais informações, consulte as regras de atribuição de agentes.

As chaves atributo encontradas nesta lista não serão enviadas para a New Relic em caso de erros de rastreamento. Para mais informações, consulte as regras de atribuição de agentes.

Quando vários erros são detectados em uma transação, apenas o último erro será relatado por padrão. Definir esta propriedade como false reportará apenas o primeiro erro detectado. Para obter mais informações, consulte a API NoticeError. Por exemplo:

error_collector:
  ignoreErrorPriority: false

Todos os nomes de classes de exceção especificados não serão tratados como erros. Obsoleto a partir do agente Java 3.40.0 e substituído por ignore_classes.

Por exemplo:

error_collector:
  ignore_errors: some.other.MyException

Esta configuração pode ser usada para controlar a coleta de URIs de solicitação de saída para erros e rastreamento da transação. Defina como verdadeiro para desativar a coleta dessas informações.

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

Se o nome do host não puder ser determinado, o endereço IP do host será usado. Esta propriedade determina se o endereço IPv4 ou IPv6 deve ser usado. O padrão é IPv4.

Para obter ajuda para obter uma entrada válida de host do observador trace do Infinite Tracing, consulte localizar ou criar um Trace Observer.

Você pode configurar isso via YAML:

infinite_tracing:
  trace_observer:
    host: YOUR_TRACE_OBSERVER_HOST

Você também pode usar a propriedade do sistema newrelic.config.infinite_tracing.trace_observer.host ou a variável de ambiente NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST.

Por padrão, as anotações @TraceLambda estão desabilitadas. Para usar a funcionalidade de anotação para rastrear métodos lambda, você deve ativar explicitamente o recurso da seguinte maneira:

Você pode configurar isso via YAML:

instrumentation:
  trace_lambda:
    enabled: true

Você também pode usar a propriedade do sistema newrelic.config.instrumentation.trace_lambda.enabled=true ou a variável de ambiente NEW_RELIC_INSTRUMENTATION_TRACE_LAMBDA_ENABLED.

Usado para ativar/desativar a coleta e relatórios de jar.

Usado para ativar/desativar a coleta de jars temporários. Jars temporários são aqueles que residem no diretório especificado pela propriedade do sistema java.io.tmpdir.

O número máximo de jars a serem processados por segundo. Deve ser positivo.

Defina como true para ativar a criação de perfil em tempo real com JFR. Essa configuração será aplicada dinamicamente e não requer reinicialização da JVM.

Defina como true para ativar o registro de auditoria que exibirá todas as métricas e eventos JFR em cada lote de colheita. O registro de auditoria é extremamente detalhado e só deve ser usado para fins de resolução de problemas.

Esta configuração pode ser usada para ativar ou desativar todas as funcionalidades JMX.

Essa configuração pode ser ativada para permitir que o agente Java exponha metadados de vinculação por meio de JMX remoto.

Defina como true para ativar o recurso principal de logs contextualizados. Quando habilitado, a instrumentação adicional framework de log é habilitada, independentemente de os logs serem decorados ou enviados para o New Relic ou não.

Defina como false para desativar completamente esse recurso, incluindo a coleta de métricas log .

Habilita o envio de log do aplicativo para New Relic.

Defina como true para que seu registro decorado seja enviado para a New Relic.

Defina como false se não quiser que seu registro decorado seja enviado para a New Relic.

Um número inteiro positivo que especifica o número máximo de linhas de log por minuto a serem enviadas.

Defina como 0 para desativar efetivamente o envio de log.

Defina um valor mais baixo para reduzir a quantidade de linhas de log enviadas (pode causar amostragem de log). Defina um valor mais alto para enviar mais linhas de log.

Cada log recebe a mesma prioridade que sua transação associada. log que ocorrem fora de uma transação receberão uma prioridade aleatória. Alguns registros podem não ser incluídos porque são limitados por max_samples_stored. Por exemplo, se o registro em log max_samples_stored estiver definido como 10.000 e a transação 1 tiver 10.000 entradas de log, somente as entradas de log da transação 1 serão registradas. Se a transação 1 tiver menos de 10.000 logs, você receberá todos os logs da transação 1. Se ainda houver espaço, você receberá todo o log da transação 2 e assim por diante.

Se após todos os logs de transação amostrados forem registrados, e eles não atingirem o limite em max_samples_stored, então será enviada a mensagem do log de transação amostrada que não estava em nossa amostragem. Se sobrar alguma, as mensagens do log fora da transação serão registradas.

Defina isto como true envio de dados de contexto como atributo log para New Relic.

Defina como false se não desejar que os dados de contexto no log sejam enviados para o New Relic.

Se context_data estiver habilitado para encaminhamento de logs, todas as chaves de atributo encontradas nesta lista serão enviadas para New Relic nos registros de log. Se esta lista estiver vazia, todos os atributos serão enviados.

Se context_data estiver habilitado para encaminhamento de logs, todas as chaves de atributo encontradas nesta lista NÃO serão enviadas para New Relic nos registros de log.

A lista de inclusão e exclusão segue as regras Exclude overrides include, More specific rules take priority, Keys are case-sensitive e Use an asterisk for wildcards definidas nas regras de atributo.

Possibilita a captura de informações métricas sobre seu log e nível de log, que são exibidas em gráfico na página Summary do APM.

Deixe definido como true para permitir que o agente capture informações métricas sobre seu log.

Defina como false para desativar esse recurso.

Isto controla se as linhas de log armazenadas localmente são decoradas ou não. Isso independe de o encaminhamento de logs estar habilitado ou não e é usado para oferecer suporte a clientes que desejam usar uma solução separada de encaminhamento de logs.

Defina como true para fazer com que o agente adicione logs contextualizados vinculando metadados a linhas log armazenadas localmente pela estrutura suportada.

Defina como false para desativar o recurso de decoração local. Isso não afetará a decoração das linhas log enviadas para a New Relic.

Defina como true para rolar o registro diariamente.

O número máximo de arquivos de log a serem mantidos ao usar rotação de log.

O nome do arquivo de log não qualificado ou a string STDOUT que fará log na saída padrão.

O caminho do arquivo de log.

O nível de detalhamento do log. Quando você altera essa configuração no arquivo de configuração yaml do agente, ela será atualizada dinamicamente. No entanto, a variável de ambiente e a propriedade do sistema não serão atualizadas dinamicamente.

O agente usa seu próprio arquivo de log para manter seu registro separado do seu aplicativo. As opções válidas, em ordem de detalhamento, são:

• off

• severe

• warning

• info

• fine

• finer

• finest

  Cuidado

  Não use o registro debug ou trace , a menos que o suporte da New Relic solicite que você os use. Esses níveis de registro em log podem gerar sobrecarga excessiva. Na maioria das situações, use info.

  Essa configuração é dinâmica, portanto, a execução do agente notará alterações em newrelic.yml sem reiniciar a JVM.

O tamanho do arquivo de log em quilobytes no qual os arquivos de log são rotacionados. Defina como 0 sem limite.

Adiciona propriedades de mensagem ao atributo tracer . Defina como false para desligá-lo.

Permite que o recurso de autoconfiguração OpenTelemetry SDK do agente seja habilitado. Pode ser definido através da propriedade do sistema:

-Dnewrelic.config.opentelemetry.sdk.autoconfigure.enabled=true

O padrão é verdadeiro.

Para desabilitar completamente todas as funcionalidades de segurança, defina este sinalizador como falso. Esta propriedade é lida apenas uma vez no início do aplicativo. O padrão é falso.

Determina se os dados de segurança são enviados para o New Relic ou não. Quando estiver desabilitado e agente.enabled for verdadeiro, o módulo de segurança será executado, mas os dados não serão enviados. O padrão é falso.

Modo de fornecimento do New Relic Security: IAST. O padrão é IAST. Devido à natureza invasiva da varredura IAST, NÃO ative esse modo em um ambiente de produção ou em um ambiente onde os dados de produção são processados.

URL de conexão SaaS da New Relic Security. Este é o endpoint para o qual o agente de segurança envia dados; ele deve corresponder ao ambiente que você configurou para o agente Java do APM.

Produção nos EUA: wss://csec.nr-data.net

Ative a detecção de eventos de segurança RCI. O padrão é verdadeiro.

Habilite a detecção de eventos de segurança RXSS. O padrão é verdadeiro.

Habilite a detecção de eventos de segurança de desserialização. O padrão é verdadeiro.

Usado para ativar/desativar a detecção de transações lentas.

Determina quanto tempo uma transação deve levar em milissegundos para que um evento SlowTransaction seja relatado.

Se for definido como verdadeiro, toda transação será verificada por exceder o limite de transação definido na conclusão. Observe que se um grande número de transações exceder o limite, isso pode ser computacionalmente caro, pois um stack trace é enviado a cada evento SlowTransaction.

Usado para ativar/desativar relatórios de eventos de extensão.

• Determina o número de eventos de span que podem ser capturados durante um ciclo de coleta de agente. Disponível no agente Java 7.4.0 e superior.

• Ao configurar o agente para AI Monitoring, defina o valor máximo 10000. Garante que a quantidade máxima de rastreamento seja capturada.

  Importante

  Aumentar o número de eventos de span pode levar a sobrecarga adicional do agente.

Esta configuração pode ser usada para ativar ou desativar todos os atributos do evento span. Se attributes.enabled no nível raiz for false, nenhum atributo será enviado para span evento, independentemente de como esta propriedade (span_events.attributes.enabled) estiver definida.

Se atributo estiver habilitado para span evento, todas as chaves de atributo encontradas nesta lista serão enviadas para New Relic em span_events. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para New Relic no evento span. Para mais informações, consulte as regras de atribuição de agentes.

Por padrão, isso é definido como false, o que significa que o agente envia mensagens de todas as exceções para o coletor New Relic.

• Se você definir isso como true, o agente retirará as mensagens das exceções para evitar que ele capture inadvertidamente informações confidenciais.
• Se você ativar o modo de alta segurança, ele será automaticamente definido como true.
• Se você definir enabled como true , mas quiser que o agente capture mensagens de exceções específicas, adicione as exceções à sua lista de permissões.

Se você definir enabled como true , mas quiser que o agente capture mensagens para exceções específicas, adicione cada exceção a whitelist, separadas por vírgula.

Se você definir enabled como true , mas quiser que o agente capture mensagens para exceções específicas, adicione cada exceção a allowed_classes, separadas por vírgula.

Habilite o profiler de thread.

Habilite o serviço de evento de transação.

O número máximo de eventos de transação amostrados relatados a cada 60 segundos.

Uma lista de mapas com as chaves emparelhadas header_name e o opcional header_alias. Escolha um ou mais cabeçalhos de solicitação HTTP personalizados para adicionar como atributo de transação.

Você pode listar a configuração de vários cabeçalhos:

transaction_events:
  custom_request_headers:
    -
      header_name: "X-Custom-Header-1"
    -
      header_name: "X-Custom-Header-2"
      header_alias: "CustomHeader2alias"

No primeiro conjunto de mapas, X-Custom-Header-1 é capturado e relatado pelo agente como o nome do cabeçalho para um valor correspondente do objeto de solicitação. O header_name também será o nome do atributo enviado para New Relic.

No segundo conjunto de mapas, o cabeçalho da solicitação é X-Custom-Header-2, mas CustomHeader2alias é o nome enviado para New Relic.

Esta configuração pode ser usada para ativar ou desativar todos os atributos do evento de transação. Se attributes.enabled for false no nível raiz, nenhum atributo será enviado para o evento de transação, independentemente de como essa propriedade estiver configurada em transaction_events.

Se o atributo estiver habilitado para evento de transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic no evento de transação. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para a New Relic em evento de transação. Para mais informações, consulte as regras de atribuição de agentes.

Esta configuração pode ser usada para ativar ou desativar todos os atributos para segmentos de transação. Se attributes.enabled no nível raiz for false, nenhum atributo será enviado para segmentos de transação, independentemente de como esta propriedade (transaction_segments.attributes.enabled) estiver configurada.

Se atributo estiver habilitado para segmentos de transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic em segmentos de transação. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas para a New Relic em segmentos de transação. Para mais informações, consulte as regras de atribuição de agentes.

O tracer de transação está habilitado por padrão. Defina como false para desligá-lo.

Determina se o agente irá capturar o plano EXPLAIN para consulta lenta. Compatível apenas com MySQL e PostgreSQL.

Limite em segundos para o tempo de execução da consulta abaixo do qual a consulta lenta e o plano EXPLAIN (se compatível) não serão capturados. Relevante para consulta lenta somente quando record_sql está definido como raw ou obfuscated. Relevante para planos EXPLAIN somente quando explain_enabled está definido como true.

O limite de caracteres para a cadeia de consulta SQL. Se você tiver muitas consultas SQL lentas com grandes quantidades de informações, isso poderá afetar negativamente o desempenho ou a rapidez com que você vê seus dados no New Relic. Aumente o valor gradualmente até encontrar o equilíbrio certo entre informação e desempenho.

Defina como true para ativar o registro de consulta ao arquivo de log do agente em vez de fazer upload para o New Relic. consulta são logados usando o modo record_sql .

Quando o tracer de transação está ativado, as instruções de consulta podem ser gravadas opcionalmente. O gravador possui três modos:

• off: Não envie nenhuma consulta.
• raw: Envie a instrução de consulta em seu formato original.
• obfuscated: remove literais numéricos e de string.

Esta opção é apenas para Play 2.x+. A instrumentação Play/Scala pode usar Thread.getStackTrace() para melhorar a nomenclatura tracer , mas ao custo de maior sobrecarga.

Define um limite (em segundos) para coletar rastreamento de pilha de uma chamada SQL. Quando as instruções SQL excederem esse limite, o agente capturará o stack trace atual. Isso é útil para identificar a origem das longas chamadas SQL.

Use esta configuração para controlar a variedade do seu rastreamento de transação. top_n é um número inteiro que representa o número de transações lentas e exclusivas para as quais o rastreamento será criado.

• Se você quiser que o rastreamento da transação reflita com mais precisão as transações reais mais lentas no seu aplicativo, defina esse valor lower.

• Se você deseja amostrar um conjunto mais diversificado de transações, defina o valor higher.

  Um valor 0 significaria que only a transação mais lenta é sempre rastreada. No entanto, isso não é considerado o ideal, porque você pode ter uma ou duas transações que são sempre as mais lentas e ver repetidamente o mesmo rastreamento da transação provavelmente não lhe dará muito valor.

  Se a mesma transação for frequentemente a mais lenta, a configuração top_n permitirá que o agente Java (ao longo do tempo) obtenha amostras das transações n mais lentas. Isso oferece maior variedade e mais insights sobre seu aplicativo.

O limite de tempo usado para determinar quando uma transação está qualificada para ser rastreada. Quando o tempo de resposta da transação ultrapassar esse limite, um trace da transação será registrado e enviado à New Relic.

O padrão é apdex_f (padrão), que define o limite como o nível de Apdex "Frustrated" (quatro vezes o apdex_t valor ). Você também pode definir um limite de tempo específico inserindo um valor float que representa um número de segundos.

Por padrão, o modo de alta segurança não permite que o agente colete consulta lenta. Habilite esta opção para coletar consultas Cassandra do driver DataStax, mesmo com alta segurança habilitada. Caso não utilize alta segurança, o agente coleta a consulta lenta automaticamente.

Para o driver DataStax 2.1.2, adicione esta regra à sua lista de permissões:

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para o driver DataStax 3.0.0, adicione esta regra à sua lista de permissões:

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Por padrão, o modo de alta segurança não permite que o agente colete consulta lenta. Habilite esta opção para coletar consultas Cassandra do driver DataStax, mesmo com alta segurança habilitada. Caso não utilize alta segurança, o agente coleta a consulta lenta automaticamente.

Para o driver DataStax 2.1.2, adicione esta regra à sua lista de permissões:

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Para o driver DataStax 3.0.0, adicione esta regra à sua lista de permissões:

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Esta configuração pode ser usada para ativar ou desativar todos os atributos de rastreamento da transação. Se attributes.enabled no nível raiz for false, nenhum atributo será enviado para o rastreamento da transação, independentemente de como esta propriedade (transaction_tracer.attributes.enabled) estiver definida.

Se os atributo estiverem habilitados para rastreamento da transação, todas as chaves de atributo encontradas nesta lista serão enviadas para a New Relic no rastreamento da transação. Para mais informações, consulte as regras de atribuição de agentes.

Todas as chaves de atributo encontradas nesta lista não serão enviadas à New Relic no rastreamento da transação. Para mais informações, consulte as regras de atribuição de agentes.

Limita o número de tokens que podem ser criados por transação. 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.

Limita o número de segmentos que podem ser criados por transação. 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.