Atualizar o agente Node.js

Adicionado suporte de paridade oficial para Node.js 20.

BREAKING: Suporte ao Node.js 14 eliminado.

• Para mais informações consulte nossa política de suporte.

BREAKING: carregador ESM atualizado para oferecer suporte ao Node.js 20.

• Agora você deve usar os argumentos --experimental-loader e -r ao executar um aplicativo.
• node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js

BREAKING: o gerenciador de contexto padrão foi atualizado para AsyncLocalContextManager.

• O LegacyContextManager padrão anterior pode ser restaurado definindo o sinalizador de recurso de config.feature_flag.legacy_context_manager como true.
• Se preferir variáveis de ambiente, você pode definir NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGER como true.
• Observe que este gerenciador de contexto será removido em versões futuras. Se você achar que precisa voltar a usar esse gerenciador de contexto legado, levante a questão com o suporte da New Relic ou com um problema do GitHub.

BREAKING: renomeado shim.handleCATHeaders para shim.handleMqTracingHeaders.

Atualize a dependência do New Relic para versões com suporte de versão Node.js atualizado

• @newrelic/AWS-sdk v7.0.0
• @newrelic/koa v8.0.0
• @newrelic/native-métrica v10.0.0
• @newrelic/superagente v7.0.0
• @newrelic/test-utilities v8.0.0

• Adicionada a capacidade de registrar vários ganchos de instrumentação (onRequire, onResolved) para o mesmo moduleName resolvido.

• Esta tem sido uma limitação do agente desde o início.
• Se você usasse a API para o instrumento api.instrument, api.instrumentDatastore, api.instrumentWebframework, api.instrumentMessages, ou api.instrumentConglomerate, ela substituiria os ganchos de instrumentação existentes.
• O efeito foi que o agente Node.js não funcionaria conforme planejado.

BREAKING: o padrão config.transaction_tracer.record_sql foi atualizado de desativado para ofuscado. Isso significa que as instruções SQL serão capturadas, mas ofuscadas.

BREAKING: Os parâmetros Route (URL) agora são armazenados como request.parameters.route.* atributo na transação, segmentos raiz e spans.

• O parâmetro de consulta estará disponível como atributo prefixado com request.parameters.* sobre transação e Spans.
• O parâmetro Route estará disponível como atributo prefixado com request.parameters.route.* sobre transação e Spans.
• Os parâmetros de rota (também conhecidos como parâmetros de url) são um recurso comum de vários frameworks da web, onde você pode criar um espaço reservado como parte de uma definição de rota de API.

BREAKING: CaptureUrlParams removido da classe WebFrameworkShim.

DEPRECATION NOTICE: shim.unwrap e shim.unwrapOnce não funcionarão mais se você tentar desembrulhar um item que foi empacotado diversas vezes.

• Isso ocorre porque como agora permitimos instrumentar o mesmo módulo mais de uma vez, você não pode desembrulhar com segurança sem quebrar toda a instrumentação registrada. Planejamos remover shim.unwrap e shim.unwrapOnce na próxima versão principal.

Atualize a dependência do New Relic para versões com suporte de versão Node.js atualizado

• @newrelic/AWS-sdk v7.0.0
• @newrelic/koa v8.0.0
• @newrelic/native-métrica v10.0.0
• @newrelic/superagente v7.0.0
• @newrelic/test-utilities v8.0.0

Adicionado suporte de paridade oficial para Node.js 18.

BREAKING: Suporte ao Node.js 12 eliminado.

• Para mais informações consulte nossa política de suporte.

BREAKING: o agente não inclui mais o pacote de certificados New Relic automaticamente ao usar a configuração de 'certificados' (geralmente com proxies).

• O agente não inclui mais o pacote de certificados New Relic ao usar a configuração de 'certificados' (geralmente com proxies). Se você achar que isso prejudica seu ambiente atual, recomendamos obter um pacote CA como o da Mozilla.

BREAKING: O agente agora exclui a porta ao fazer solicitações HTTPS externas para a porta 443 para estar em conformidade com a especificação e outros agentes

• Os segmentos externos anteriores seriam nomeados External/example.com:443 ao usar a porta HTTPS padrão.
• O segmento externo agora será denominado External/example.com.

BREAKING: capacidade de desativar o rastreamento de contexto de promessa baseado em ganchos assíncronos por meio da sinalização de recurso await_support foi removida. Isso também remove a instrumentação herdada do Promise.

• Lançada a sinalização do recurso await_support . O agente agora depende de async_hooks para rastrear a propagação de promessas assíncronas. O resultado líquido é que se você tivesse feature_flag.await_support definido como falso, a instrumentação herdada rastrearia cada função em uma cadeia de promessas como um segmento separado.

BREAKING: instrumentação removida para o pacote obsoleto oracle npm.

BREAKING: atualização da versão mínima de pg para 8.2.x. Esta é a versão de suporte mais antiga executada em Node.js 14+.

BREAKING: Atualizada a versão mínima suportada do hapi para v20.0.0.

• Todas as versões anteriores à v20.0.0 foram descontinuadas pelo hapi por motivos de segurança. Veja a política de suporte deles.

Atualize a dependência do New Relic para versões com suporte de versão Node.js atualizado

• @newrelic/AWS-sdk v5.0.0
• @newrelic/koa v7.0.0
• @newrelic/native-métrica v9.0.0
• @newrelic/superagente v6.0.0
• @newrelic/test-utilities v7.0.0

Adicionado suporte de paridade oficial para Node.js 16.

BREAKING: Suporte ao Node.js v10.x eliminado.

• Para mais informações consulte nossa política de suporte.

BREAKING: serverless_mode foi removido como sinalizador de recurso.

• A configuração padrão serverless_mode ainda existe.

BREAKING: o agente não inclui mais o pacote de certificados New Relic automaticamente ao usar a configuração de 'certificados' (geralmente com proxies).

• Se você achar que isso prejudica seu ambiente atual, poderá aproveitar um sinalizador de recurso para restaurar temporariamente essa funcionalidade. Exemplo de configuração: feature_flag: { certificate_bundle: true }. Neste caso, recomendamos obter um pacote de certificados para o seu ambiente, como o da Mozilla. O pacote New Relic e o sinalizador de recurso serão totalmente removidos na próxima versão principal.
• config.feature_flags.certificate_bundle padrãopara falso.

Atualize a dependência do New Relic para versões com suporte de versão Node.js atualizado

• @newrelic/AWS-sdk v4.0.1
• @newrelic/koa v6.0.1
• @newrelic/native-métrica v7.0.1
• @newrelic/superagente v5.0.1
• @newrelic/test-utilities v6.0.0

BREAKING Removido o atributo de resposta http obsoleto httpResponseCode, response.status e httpResponseMessage

• v6.4.2-v6.14.0:

  A partir do agente v6.4.2, esses atributo foram marcados como obsoletos, mas deixados para dar um período de transição para o novo atributo.

• v7:

  Quando o relatório de atributo de resposta http estiver ativado, http.statusCode e http.statusText serão relatados.

BREAKING Método de API setIgnoreTransaction obsoleto removido

• v5 - v6:

  A partir do agente v5.0.0, esse método foi marcado como obsoleto, mas deixado para fornecer um período de transição para os novos métodos.

• v7:

  Aplicativo deve usar o método API transactionHandle.ignore().

BREAKING O item de configuração api.custom_parameters_enabled e a variável de ambiente associada NEW_RELIC_API_CUSTOM_PARAMETERS foram removidos.

• O aplicativo deve usar a configuração api.custom_attributes_enabled ou a variável de ambiente associada NEW_RELIC_API_CUSTOM_ATTRIBUTES para ativar newrelic.addCustomAttribute e newrelic.addCustomAttributes.

BREAKING Métodos de API distributed tracing obsoletos foram removidos, createDistributedTracePayload() e acceptDistributedTracePayload()

• v6.4.0-v6.14.0:

  A partir do agente v6.4.0, esses métodos foram marcados como obsoletos, mas deixados para fornecer um período de transição para os novos métodos.

• v7:

  Aplicativo deve usar os métodos API transactionHandle.insertDistributedTraceHeaders(headers) e transactionHandle.acceptDistributedTraceHeaders(transportType, headers) . Com esses métodos, o agente Node.js agora aceitará os cabeçalhos traceparent e tracestate do W3C ao chamar transactionHandle.acceptDistributedTraceHeaders(headers) e incluirá os cabeçalhos W3C junto com o cabeçalho distributed tracing da New Relic ao chamar transactionHandle.insertDistributedTraceHeaders(headers), a menos que o cabeçalho da New Relic o formato de rastreamento é desabilitado usando distributed_tracing.exclude_newrelic_header:true.

Atualize a dependência do New Relic para versões com suporte de versão Node.js atualizado

• @newrelic/AWS-sdk v3.0.0
• @newrelic/koa v5.0.0
• @newrelic/native-métrica v6.0.0
• @newrelic/superagente v4.0.0
• @newrelic/test-utilities v5.0.0

Módulo de instrumentação oficial framework Koa atualizado para v3.0.0

• v6:

  Adicionado suporte para @koa/router até v8.0.2. @koa/router v8.0.3 e superior não são suportados no momento.

• v6:

  Adicionado suporte para Node.js v12 e removido suporte para Node.js v6, 7 e 9. A versão mínima suportada é Node.js v8.

• Consulte também as notas de lançamento do Koa da New Relic no Github..

Removido o parâmetro de configuração max_samples_per_minute obsoleto, que foi substituído pelo comportamento max_samples_stored

• v1 - v5:

  max_samples_per_minute definiu o número máximo de eventos que o agente coleta por minuto. Se seu aplicativo usou anteriormente max_samples_per_minute como limite superior, talvez seja necessário diminuir o limite para um máximo válido para evitar que os dados sejam descartados no servidor. Recomendamos menos de 10k.

• v5:

  No agente v5 e versões anteriores, max_samples_stored definiu o número máximo de eventos que o agente armazenará se não conseguir se comunicar com o coletor New Relic.

• v6:

  O novo comportamento de max_samples_stored 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. Este uso da configuração é consistente com o outro agente APM.

• Troubleshooting tips:

  Se faltarem dados de evento, aumente o valor de max_samples_stored ou reverta para o valor padrão. O valor de max_samples_stored não deve ser superior a 10.000.

Métodos addCustomParameter obsoletos removidos.

• v2 - v4:

  A partir do agente v2.7.0, esses métodos foram marcados como obsoletos, mas deixados para fornecer um período de transição para os novos métodos.

• v5:

  Aplicativo deve usar os métodos API newrelic.addCustomAttribute() e newrelic.addCustomAttributes(). Estes são substitutos imediatos para os métodos antigos.

Métodos create*Transaction obsoletos removidos.

• v2 - v4:

  A partir do agente v2.0.2, esses métodos foram marcados como obsoletos, mas deixados para dar um período de transição aos novos métodos.

• v5:

  O aplicativo deve ser atualizado para os métodos de API newrelic.startWebTransaction() e newrelic.startBackgroundTransaction().

• Troubleshooting tips:

  Esses novos métodos não são substitutos imediatos dos antigos. Antes de passar para esses novos métodos, revise nosso guia de instrumentação personalizada.

Método createTracer obsoleto removido.

• v3 - v4:

  A partir do agente v3.3.0, esse método foi marcado como obsoleto em favor de newrelic.startSegment().

• v5:

  O aplicativo deve ser atualizado para newrelic.startSegment().

Removida node-cassandra-cql instrumentação.

• v4:

  Aplicativo usando o pacote npm node-cassandra-cql obteria métrica de armazenamento de dados para Cassandra.

• v5:

  O aplicativo deve migrar para o pacote cassandra-driver para obter a métrica do datastore Cassandra. Este módulo é mantido ativamente pelos mesmos desenvolvedores. O pacote node-cassandra-cql foi abandonado em fevereiro de 2014 em favor do pacote cassandra-driver .

Remoção da configuração obsoleta de capture_params e ignored_params .

• v2 - v4:

  A partir do agente v2.7.0, esses parâmetros de configuração causavam o registro de um aviso e os valores eram automaticamente atualizados para as novas configurações de atributo.

• v5:

  Um aviso ainda será registrado, mas a configuração será ignorada e nenhuma atualização automática acontecerá mais.

• Troubleshooting tips:

  Se seu aplicativo tiver parâmetros listados na configuração ignored_params , você precisará movê-los para attributes.exclude.