Essas configurações abrangem opções adicionais de configuração do agente Node.js, incluindo variáveis de provedor de cloud, configuração de API, amostragem de eventos, parâmetros personalizados, ofuscação de URL, segurança, serviços de hospedagem e muito mais.
O ID da conta AWS AWS associada a este aplicativo.
Registro de auditoria
Esta seção define as variáveis do agente Node.js na ordem em que normalmente aparecem na seção audit_log: { do arquivo de configuração newrelic.js do seu aplicativo.
Quando habilitado, o agente registra a carga que envia ao coletor. Esses dados são incluídos no arquivo de log principal mesmo quando o nível de log está definido para o nível mais baixo.
O agente envia vários tipos diferentes de dados ao coletor em cargas separadas. Por padrão, todos eles estão incluídos no arquivo de log. Esta opção permite limitar o registo apenas a tipos específicos de dados.
Os valores válidos incluem:
agent_settings
analytic_event_data
connect
custom_event_data
error_data
error_event_data
metric_data
preconnect
shutdown
span_event_data
sql_trace_data
transaction_sample_data
Configuração de API
Esta seção permite que você escolha quais métodos de API estão habilitados. Cada opção de configuração permite habilitar modularmente métodos de API responsáveis pelo envio de informações personalizadas para o New Relic.
Importante
Todos eles são definidos como false quando o agente está no modo de alta segurança.
Esta seção define as variáveis do agente Node.js na ordem em que normalmente aparecem na seção rules: { do arquivo de configuração newrelic.js do seu aplicativo.
Uma lista de regras delimitadas por vírgulas para corresponder aos URLs de solicitação recebida e nomear a transação New Relic associada. Usa o formato:
name:[
{pattern:'STRING_OR_REGEX',name:'NAME'},
{pattern:'STRING_OR_REGEX',name:'NAME'}
]
Ambos os parâmetros são obrigatórios. Para strings, você deve escapar dos caracteres de controle. Você não precisa escapar dos caracteres de controle em expressões regulares. Atributos adicionais são ignorados.
As expressões regulares suportam grupos de captura no estilo JavaScript e os nomes usam strings de substituição no estilo $1 . As expressões regulares encontram apenas o primeiro resultado correspondente; as correspondências subsequentes são ignoradas. Para obter mais informações, consulte API de nomenclatura de transação do Node.js.
Para a variável de ambiente NEW_RELIC_NAMING_RULES , transmita as regras como literais de objeto JSON delimitados por vírgula:
Defina uma lista de URLs de solicitação que você deseja que o agente ignore. Especifique a lista como padrões, que podem ser strings ou expressões regulares. O valor padrão é uma expressão regular para corresponder às solicitações de pesquisa longa do socket.io
Quando ativado, o agente renomeia transações que não são afetadas por outra lógica de nomenclatura (como API, regras ou regras de normalização de métricas) para NormalizedUri/*. Se você definir isso como false, o agente definirá os nomes de transação como Uri/path/to/resource.
Variáveis de evento de transação
Esta seção define as variáveis do agente Node.js na ordem em que normalmente aparecem na seção transaction_events: { do arquivo de configuração newrelic.js do seu aplicativo.
Quando habilitado, o agente envia evento de transação para New Relic. Esses dados do evento incluem o tempo da transação, o nome da transação e qualquer atributo personalizado. Se estiver desabilitado, o agente não coleta esses dados nem os envia para a New Relic.
Define o número máximo de eventos que o agente coleta por minuto. Se houver mais que esse número, o agente coleta uma amostragem estatística.
Não recomendamos configurar além de 10.000. O servidor limitará os dados a 10.000 por minuto.
Importante
Esta configuração teve comportamento diferente nas versões do agente inferiores à 6.0.0. Consulte max_samples_stored (DEPRECATED) para versões de agente 5.x ou anteriores.
Tipo
Inteiro
Padrão
20000
Define o número máximo de eventos que o agente armazena caso não consiga se comunicar com o coletor New Relic. Os valores do ciclo de coleta anterior serão mesclados no próximo, limitando esta opção o número máximo. Certifique-se de que este número seja maior que max_samples_per_minute; por exemplo, defina-o para o dobro. Considere a sobrecarga de memória antes de aumentar esse valor.
Cuidado
Esta configuração tem um comportamento diferente a partir da versão 6.0.0 do agente e um novo máximo recomendado. Consulte max_samples_stored para versões do agente 6.x ou superior.
Tipo
Inteiro
Padrão
10000
Define o número máximo de eventos que o agente coleta por minuto. Se houver mais que esse número, o agente coleta uma amostragem estatística.
Cuidado
Esta configuração foi substituída por max_samples_stored a partir da versão 6.0.0 do agente. Consulte max_samples_stored para agente 6.x ou posterior.
Prefixo do atributo a ser incluído no evento da transação. Permite * como curinga no final.
Variáveis personalizadas do evento
Esta seção define as variáveis do agente Node.js na ordem em que normalmente aparecem na seção custom_insights_events: { do arquivo de configuração newrelic.js do seu aplicativo.
Quando habilitado, o agente envia evento personalizado gravado com recordCustomEvent() para New Relic. Se estiver desabilitado, o agente não coleta esses dados nem os envia para a New Relic.
Define o número máximo de eventos personalizados que o agente coleta por minuto. Caso o número de eventos personalizados ultrapasse esse limite, o agente coleta uma amostragem estatística.
Ao configurar o agente para AI Monitoring, defina o valor máximo 100000. Garante que a quantidade máxima de eventos LLM seja capturada.
Importante
Aumentar esse limite pode aumentar o uso de memória.
Nome personalizado das variáveis de host
Esta seção define as variáveis do agente Node.js na ordem em que normalmente aparecem na seção process_host: { do arquivo de configuração newrelic.js do seu aplicativo. Essas opções controlam o comportamento em relação ao nome de exibição do host na interface do APM.
Especifique um nome do host personalizado para exibição no New Relic. Se você não definir este campo, o New Relic continuará usando o nome do host padrão encontrado chamando os.hostname().
Se você usar as configurações padrão de nome do host, o New Relic encontrará o nome do host por meio de os.hostname().
Se esta chamada falhar, o New Relic usará o IP do host como nome.
Se você definir ipv_preference: 4 ou ipv_preference: 6, poderá selecionar o tipo de endereço IP (IPv4 ou IPv6) que aparece na interface do New Relic.
As variáveis do agente Node.js que controlam a redação da mensagem de erro aparecem na seção strip_exception_messages do arquivo de configuração newrelic.js do seu aplicativo:
Alterna a captura de atributos adicionais em spans de middleware para todos os frameworks web do Node.js que ajudam a gerar métricas de nível do código. Os atributos adicionais são: code.filepath, code.function, code.lineno e code.column.
Configuração Errors Inbox
Definir uma das tags a seguir ajudará você a identificar quais versões do seu software estão produzindo erros.
NEW_RELIC_METADATA_SERVICE_VERSION irá criar tag.service.version nos dados do evento contendo a versão do seu código que está implantada, em muitos casos uma versão semântica como 1.2.3, mas nem sempre.
NEW_RELIC_METADATA_RELEASE_TAG criará tags.releaseTag nos dados do evento contendo a tag de lançamento (como v0.1.209 ou release-209).
NEW_RELIC_METADATA_COMMIT criará tag.commit nos dados do evento contendo o commit sha. O sha inteiro pode ser usado ou apenas os primeiros sete caracteres (por exemplo, 734713b).
Especifica os sinalizadores regex a serem usados para correspondência de padrão de ofuscação de URL, por exemplo g para correspondência global, i para correspondência sem distinção entre maiúsculas e minúsculas, etc. Vários sinalizadores podem ser especificados como uma string, por exemplo gi. Se isso não for definido, nenhum sinalizador será usado.
Especifica a cadeia de caracteres de substituição a ser usada para ofuscação de URL. Pode conter referências para capturar grupos no padrão, por exemplo $1. Se não for definido, tudo será substituído por uma única string vazia.
Alterna se os dados do agente de segurança da New Relic são enviados para a New Relic ou não. Quando estiver desabilitado e security.agente.enabled for verdadeiro, o agente de segurança será cadastrado mas os dados não serão enviados.
Modo fornecido pela 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 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 Node.js.
Se for verdade, o agente usa nomes dyno Heroku como nome do host.
Threads de trabalho
Nas versões do agente anteriores à 11.0.0, o agente era executado nos threads principal e de trabalho. Na versão 11.0.0 o agente parou de funcionar em threads de trabalho devido à sua incompatibilidade com nossa propagação de contexto assíncrono. A capacidade de execução em encadeamentos de trabalho foi restaurada na versão 11.3.0, mas você deve configurar worker_threads.enabled como true. O comportamento de execução nos threads de trabalho varia e não oferecemos suporte oficial para isso. Algumas coisas como geração de métricas e rastreamento de transação independente podem funcionar, mas isso é um uso por sua conta e risco.
Se for verdade, o agente será carregado quando estiver em um thread de trabalho, se especificado.
Utilização
Configure como o agente detecta as informações de ambiente de host e cloud para calcular com precisão o seu preço baseado na utilização. Essas configurações aparecem na seção utilization do arquivo de configuração newrelic.js do seu aplicativo.
Se true, o agente adiciona o nome da revisão do Cloud Run como prefixo ao ID da instância do GCP para formar o nome do host ({revision}-{instance id}) no Google Cloud Run. O nome da revisão vem de K_REVISION em um Serviço do Cloud Run, CLOUD_RUN_REVISION em um Worker Pool do Cloud Run e CLOUD_RUN_EXECUTION em um Job do Cloud Run. Não tem efeito a menos que utilization.gcp_cloud_run.use_instance_as_host também seja true.
Quando habilitado, ele usará o ID de metadados do GCP para definir o nome do host do aplicativo em execução (Serviços, Worker Pools e Jobs).
OpenTelemetry
Essas configurações controlam os vários recursos baseados no OpenTelemetry fornecidos pelo agente. Elas aparecem na seção opentelemetry do arquivo de configuração newrelic.js do seu aplicativo.
Importante
Essa configuração está sujeita a alterações enquanto o conjunto de recursos do OpenTelemetry estiver em desenvolvimento.
Chave global para todo o recurso OpenTelemetry. Se definido como false, nenhum outro sub-recurso do OpenTelemetry (como traces, logs ou metrics) será ativado, independentemente da própria configuração desse sub-recurso.
Quando true, o agente configura automaticamente a API de logs do OpenTelemetry para enviar logs emitidos por meio da API específica do OTel para o New Relic.
Quando true, o agente configura automaticamente a API de métricas do OpenTelemetry para enviar métricas para o New Relic, anexadas à entidade do aplicativo instrumentado pelo agente.
O número de milissegundos entre cada tentativa de enviar métricas do OpenTelemetry para o New Relic. Deve ser maior ou igual a opentelemetry.metrics.export_timeout.
O número de milissegundos permitidos para uma operação de exportação de métricas do OpenTelemetry antes que ela precise ser concluída com sucesso. Se o tempo limite for excedido, isso é relatado por meio da API de diagnóstico do OpenTelemetry.
Instrumentação do Apollo Server
Essas configurações personalizam o comportamento da instrumentação do Apollo Server (GraphQL) do agente. Elas aparecem na seção apollo_server do arquivo de configuração newrelic.js do seu aplicativo.
Habilita a captura de tempo para campos resolvidos com o tipo de retorno GraphQLScalarType. Isso pode ser desejado ao realizar cálculos demorados para retornar um valor escalar. Não recomendado para consultas que retornam um grande número de campos escalares pré-calculados.
Dica
Os resolvedores de consulta/mutação são sempre capturados, mesmo quando retornam um tipo escalar.
Ativa a captura de métricas para cada campo e argumento de resolvedor visto para uma consulta do Apollo. Destinado a identificar campos não utilizados em seu esquema do GraphQL.
Substituições de variáveis de ambiente
Esta seção define duas opções de configuração disponíveis apenas com variáveis de ambiente. Essas substituições não são usadas na maioria das configurações.
Caminho para o diretório que contém newrelic.js. Isso está disponível apenas como uma variável de ambiente. Você não pode configurá-lo em seu arquivo de configuração.
Tipo
Corda
Padrão
(nenhum)
Usado para definir um nome de arquivo de configuração diferente do padrão newrelic.js. Isto está disponível apenas como uma variável de ambiente. Você não pode defini-lo no seu arquivo de configuração.
Tipo
Corda
Padrão
(nenhum)
Se usado, evita que o agente leia as definições de configuração de newrelic.js. Os valores padrão e os valores das variáveis de ambiente ainda serão definidos.
Isso está disponível apenas como uma variável de ambiente. Você não pode configurá-lo em seu arquivo de configuração.
Tipo
Boleano
Padrão
false
Guia de referência de tipo de variável de ambiente
Esta seção descreve como formatar corretamente os tipos de dados complexos.
Tipos de matriz são definidos como strings delimitadas por vírgula.