Outras configurações do agente Java

Essas configurações abrangem opções adicionais de configuração do agente Java, incluindo detecção de plataforma cloud, controles de desempenho e configurações de ciclo de vida do agente.

Dica

Voltar ao índice completo de configurações: configuração do agente Java

Circuit breaker

Essas configurações personalizam o comportamento do circuit breakerJava. Essas configurações não estão incluídas em newrelic.yml por padrão. Você não precisa reiniciar sua JVM após alterá-las.

Se desejar personalizar o circuit breaker, adicione-o na seção common:

common: &default_settings
  OTHER_CONFIG_SETTINGS
  circuitbreaker:
    enabled: true
    memory_threshold: 20
    gc_cpu_threshold: 10

Tipo	Boleano
Padrão	`true`

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

Tipo	Inteiro (0 a 100)
Padrão	`20`

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.

Tipo	Inteiro (0 a 100)
Padrão	`10`

Personalize a porcentagem de tempo de CPU da coleta de lixo acima 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 desarma. 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.

Configuração de cloud

Defina opções relacionadas à nuvem na seção cloud do YAML do agente. Você pode substituir essas configurações com uma propriedade de sistema prefixada newrelic.config.cloud ou uma variável de ambiente prefixada NEW_RELIC_CLOUD_ .

Um exemplo de configuração:

cloud:
  aws:
    account_id: 123456789012
  metadata_bypass_proxy: false

Tipo	Corda
Padrão	(nenhum)

Esta configuração é lida por alguns serviços na instrumentação em nuvem para que o atributo cloud.resource_id possa ser definido nos respectivos spans.

AWS DynamoDB e Kinesis são serviços que exigem esse valor para preencher o atributo cloud.resource_id . Da mesma forma, o AWS Lambda exige esse valor quando o ID da conta não faz parte do nome da função.

A chamada a seguir substituirá esta configuração:

NewRelic.getAgent().getCloud().setAccountInfo(CloudAccountInfo.AWS_ACCOUNT_ID, "...");

Utilização da plataforma em nuvem

Defina as configurações de utilização da plataforma de nuvem na seção utilization e podem ser substituídas pela propriedade de sistema prefixada newrelic.config.utilization .

O agente coleta informações de utilização e as envia para o serviço New Relic. O agente pode coletar informações da instância Amazon Web Services (AWS), Azure, Google Cloud Platform e Pivotal Cloud Foundry. Também coletará informações relacionadas aos serviços Docker contêiner e Kubernetes.

Métrica al nível do código

O nível do código métrico fornece insights detalhados sobre o desempenho do seu código no nível do método. Você verá a métrica para cada método que foi instrumentado automaticamente ou que foi instrumentado pela anotação @Trace.

Defina as opções de métricas de nível do código na seção code_level_metrics. Elas podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.code_level_metrics.

Tipo	Boleano
Padrão	`true`

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.

Evento personalizado

Defina as configurações de eventos personalizados na seção custom_insights_events. É possível substituir essas configurações por uma propriedade de sistema com prefixo newrelic.config.custom_insights_events.

O APM permite registrar dados personalizados de eventos através do agente de idiomas da API New Relic, que você pode consultar.

Importante

Para versões do agente Java anteriores a 4.1.0, a seguinte configuração YAML é reconhecida:

custom_insights_events.enabled: true
  custom_insights_events.max_samples_stored: 5000

Para versões de agente 4.1.0 e acima, a configuração YAML usa a formatação de seção aninhada:

custom_insights_events:
  enabled: false
  max_samples_stored: 5000

Tipo	Inteiro
Padrão	`255`

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+.

Tipo	Inteiro
Padrão	`30000`

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.

Tracer externo

Defina as opções de rastreamento externo na seção external_tracer. Essas opções podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.external_tracer.

Tipo	Boleano
Padrão	`false`

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.

Nome do host configuração

Defina as opções de configuração de nome do host na seção process_host. Essas opções podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.process_host.

Use estas propriedades para configurar o nome do host exibido na interface:

Coletor de jar

O agente Java coleta informações sobre jars e suas versões no classpath do aplicativo.

Defina a configuração de coleta de jar na seção jar_collector. Essas opções de configuração podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.jar_collector. As opções incluem:

Propriedades JVM ofuscação

O agente Java envia propriedades da JVM para o New Relic para exibição na interface do usuário. A partir da versão 8.16.0 do agente Java, os valores da maioria das propriedades serão ofuscados. Por exemplo: -Dprop=12345 agora será enviado como -Dprop=obfuscated.

Defina opções relacionadas à ofuscação na seção obfuscate_jvm_props do YAML do agente. Você pode substituir essas configurações com uma propriedade de sistema prefixada newrelic.config.obfuscate_jvm_props ou uma variável de ambiente prefixada NEW_RELIC_OBFUSCATE_JVM_PROPS_ .

Por padrão, os valores das propriedades que começam com -X não serão ofuscados.

Tipo	Lista de strings
Padrão	(nenhum)

Se a ofuscação estiver habilitada, quando a chave de propriedade corresponder a um valor nesta lista, o valor não será ofuscado.

Os itens nesta lista podem ter curingas, * como o último caractere. Conflitos com a lista de blocos são resolvidos seguindo regras de atributo, onde allow funciona como include.

Tipo	Lista de strings
Padrão	(nenhum)

Se a ofuscação estiver habilitada, quando a chave de propriedade corresponder a um valor nesta lista, o valor será ofuscado.

Os itens nesta lista podem ter curingas, * como o último caractere. Conflitos com a lista de permissões são resolvidos seguindo regras de atributo, onde block funciona como exclude.

Kafka fila de mensagens

Informações detalhadas sobre a configuração da instrumentação Kafka podem ser encontradas na página do instrumento Kafka fila de mensagens .

Pular aplicativo

O agente pode ser habilitado ou desabilitado seletivamente com base na classe principal de inicialização ou no arquivo jar executável que é extraído da linha de comando. Isso é útil em situações em que a variável de ambiente "JAVA_TOOL_OPTIONS" está presente e contém a flag -javaagent, mas não queremos aplicar a instrumentação a todos os aplicativos java no ambiente - por exemplo, em um contêiner Kubernetes.

Importante

A configuração de skip é suportada apenas por meio de uma propriedade do sistema e uma variável de ambiente por causa de quão cedo no ciclo de vida do agente a configuração de skip precisa ser verificada.

Para fins de diagnóstico, se alguma das variáveis de configuração de exclusão ou inclusão for definida, o agente imprimirá a linha de comando extraída e os tokens de skip analisados para stdout:

New Relic Agent: New Relic Agent: Configured startup Java artifacts [include|skip] string: keytool,Main
New Relic Agent: Retrieved current startup command line / main artifact name: /Users/bob/.sdkman/candidates/java/11.0.17-amzn/bin/keytool

Se o agente estiver desabilitado com base em uma variável de configuração de inclusão ou exclusão, o seguinte será despejado no stdout:

----------
New Relic Agent is disabled by startup class/jar skip or include configuration.
----------

Tipo	Lista de strings
Padrão	(nenhum)

Uma lista separada por vírgulas de classes principais, arquivos jar executáveis ou ferramentas/aplicativos baseados em Java que o agente NÃO deve instrumentar. Por exemplo: NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS=keytool,myapp.jar,IgnoreThisClass. A propriedade do sistema correspondente é newrelic.config.startup_java_artifact_skips.

Tipo	Lista de strings
Padrão	(nenhum)

Uma lista separada por vírgulas de classes principais, arquivos jar executáveis ou ferramentas/aplicativos baseados em Java que o agente DEVE instrumentar. Por exemplo: NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES=myapp.jar. A propriedade do sistema correspondente é newrelic.config.startup_java_artifact_includes.

Detecção de transação lenta

O agente agora pode detectar transações lentas via evento SlowTransaction desde a versão do Agente Java 8.7.0. Esses eventos são registrados quando a duração da transação excede um determinado limite. Por padrão, o limite é 600.000 milissegundos (10 minutos).

A detecção de transação lenta é definida em slow_transactions e pode ser substituída usando uma propriedade de sistema com prefixo newrelic.config.slow_transactions. As opções incluem:

Tipo	Boleano
Padrão	`true`

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.

Tirar exceções

Defina as opções de remoção de exceções na seção strip_exception_messages. Essas opções podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.strip_exception_messages. Ative esta configuração para controlar se as mensagens de exceção do Java são relatadas ao New Relic.

Tipo	Boleano
Padrão	`false`

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.

Tipo	Corda
Padrão	(nenhum)

Importante

Esta configuração foi descontinuada a partir da versão 5.10.0 do agente e será removida em uma versão futura do agente. Em vez disso, use allowed_classes.

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.

Remoção temporária do arquivo Jar

Em alguns ambientes de clientes, os jars temporários do agente não são limpos corretamente, embora esses jars estejam marcados para serem excluídos na terminação da JVM. Isso provavelmente se deve à terminação anormal da JVM. Essa configuração direciona o agente a excluir quaisquer arquivos jar temporários do agente mais antigos que o valor especificado na inicialização.

Importante

Esta configuração é suportada apenas por meio de uma propriedade do sistema ou uma variável de ambiente devido a quão cedo no ciclo de vida do agente a exclusão do arquivo deve ocorrer.

Para fins de diagnóstico, se este recurso estiver habilitado, o seguinte será escrito no console:

New Relic Agent: Removing stale temporary agent file jars from [temporaryFolder] older than [X] hour(s)

Se algum arquivo for excluído, o seguinte será escrito no console:

New Relic Agent: Deleted [count] stale temporary jar files freeing up [totalBytes] bytes

Tipo	Inteiro
Padrão	0

O valor é o número de horas que um jar temporário precisa ter para ser excluído (somente números inteiros). O valor padrão é 0, o que desabilita a verificação de exclusão de arquivos. A propriedade do sistema correspondente é newrelic.config.temp_jarfile_age_threshold_hours.

Profiler de thread

Defina as opções do profiler de thread na seção thread_profiler. Essas opções podem ser substituídas por uma propriedade de sistema com prefixo newrelic.config.thread_profiler.

O Thread profiler mede o tempo transcorrido, o tempo de CPU e a contagem de chamadas de método nos threads do seu aplicativo à medida que eles são executados.

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

Dica

Circuit breaker.css-21sua1{background:none;border:none;width:0;padding:0;}

memory_threshold

gc_cpu_threshold

Configuração de cloud

aws.account_id

metadata_bypass_proxy

Utilização da plataforma em nuvem

detect_aws

detect_azure

detect_gcp

detect_kubernetes

detect_pcf

detect_docker

Métrica al nível do código

habilitado

Evento personalizado

Importante

habilitado

max_attribute_value

max_samples_stored

Tracer externo

exclude_request_uri

Nome do host configuração

display_name

ipv_preference

Coletor de jar

habilitado

skip_temp_jars

jars_per_second

Propriedades JVM ofuscação

habilitado

permitir

bloquear

Kafka fila de mensagens

Pular aplicativo

Importante

NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS

NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES

Detecção de transação lenta

habilitado

limite

evaluate_completed_transaction

Tirar exceções

habilitado

whitelist (DESCONTINUADO)

allowed_classes

Remoção temporária do arquivo Jar

Importante

NEW_RELIC_TEMP_JARFILE_AGE_THRESHOLD_HOURS

Profiler de thread

habilitado

Circuit breaker