O agente Java New Relic lê sua configuração do arquivo newrelic.yml . Por padrão, o agente procura esse arquivo no diretório que contém newrelic.jar. Você pode substituir o local do arquivo de configuração definindo a propriedade de sistema newrelic.config.file com um nome de arquivo completo.
Você poderá configurar nosso agente Java para se adequar ao seu ambiente depois de criar uma conta no New Relic (é grátis para sempre) e instalar o agente Java.
Estrutura do arquivo de configuração
O arquivo newrelic.yml possui seções separadas para ambientes diferentes:
- Teste
- Desenvolvimento
- Preparação
- Produção (padrão)
A New Relic aplica as configurações da seção common a cada um desses ambientes. Você pode selecionar outros ambientes como padrão configurando a propriedade de sistema newrelic.environment como o nome do ambiente.
Dica
Um modelonewrelic.yml está disponível.
Se você editar newrelic.yml, tome cuidado para estar em conformidade com o 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:
Java agent newrelic.yml | Requirements |
|---|---|
Formatar | Os arquivos YML diferenciam maiúsculas de minúsculas. |
Recuos | Todos os recuos devem estar em incrementos de dois caracteres. Outros recuos resultarão em um erro
|
Mudanças no arquivo | Você deve reiniciar o processo do host JVM para que as alterações entrem em vigor. Exception: As alterações de propriedade em |
Precedência das definições de configuração
Para substituir qualquer configuração no arquivo de configuração, use uma substituição de propriedade do sistema. Em determinados ambientes, as variáveis de ambiente também podem ser usadas para substituir o arquivo de configuração e as propriedades do sistema. As variáveis de ambiente existem principalmente para oferecer suporte ao Heroku. Quando usada, Configuração no lado do servidor substitui todas as outras definições de configuração.
Com o agente Java, a configuração no lado do servidor substitui todas as outras configurações. Variáveis de ambiente substituem propriedades do sistema Java. As propriedades Java substituem as definições de configuração do usuário no arquivo newrelic.yml . As configurações do usuário substituem as configurações padrão newrelic.yml .
Configurando o diretório de extensões Java
O agente Java lê os arquivos de configuração na inicialização do processo. Para identificar o diretório onde os arquivos estão localizados, crie um novo diretório ou especifique um diretório de extensões existente:
Índice de configurações
As páginas a seguir contêm a referência completa de configurações para cada área de configuração:
| Página de configurações | Descrição |
|---|---|
| Configurações Gerais | Configurações principais: chave de licença, nome do aplicativo, proxy, alta segurança, extensões |
| Configurações do tracer de transação | Rastreamento de transação, captura de SQL, eventos de transação, segmentos, tracer de mensagens |
| Configurações do coletor de erros | Coleta de erros, classes ignoradas/esperadas e códigos de status, Errors Inbox |
| Configurações distributed tracing | Distributed tracing, Infinite Tracing, eventos de span, tracer multiaplicativo |
| Configurações de logs contextualizados | Encaminhamento de logs, métricas de log, decoração local, configuração de logging |
| Configurações de atributo | Filtragem de atributos, listas de inclusão/exclusão, modo de atributo HTTP |
| Configurações de segurança | Agente de segurança IAST, configurações de detecção de vulnerabilidades |
| Configurações de AI Monitoring | AI Monitoring e gravação de conteúdo de LLM |
| Monitoramento de configurações do browser | Instrumentação automática e configuração de atributo do agente do browser |
| Configurações de instrumentação assíncrona | Configuração de token assíncrono e tempo limite de segmento |
| Configurações do OpenTelemetry | Configuração de sinais de traces, métricas e logs do OpenTelemetry |
| Configurações do JFR | Profiling em tempo real do Java Flight Recorder |
| Configurações do transformador de classe | Nomenclatura de transação do Spring, anotações de trace, tracing de lambda |
| Configurações de JMX | Monitoramento JMX e vinculação de metadados |
| Outras configurações | Circuit breaker, configuração de cloud, utilização, eventos personalizados, coletor de jar, ofuscação de JVM, profiler de thread e muito mais |
Importante
As duas configurações que você deve configurar são o nome do seu aplicativo e a chave de licença — definidas via app_name e license_key em newrelic.yml (ou pelas variáveis de ambiente NEW_RELIC_APP_NAME e NEW_RELIC_LICENSE_KEY). Todas as outras configurações são opcionais.