• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Atualizar o agente Node.js

Para aproveitar ao máximo os recursos, melhorias e patches de segurança importantes do New Relic, recomendamos que você atualize seu agente Node.js para a versão mais recente. Para obter informações adicionais sobre atualizações específicas do agente, consulte as notas de versão do agente Node.js. As notas de versão incluem um link para download quando aplicável, além de instruções para baixar e instalar a versão mais recente.

  • Se o módulo newrelic estiver listado em package.json, execute npm install.
  • Se você deseja destinar apenas o módulo newrelic , execute npm update newrelic.

Recommendation: Teste sua versão atualizada antes de colocá-la em produção. Se você tiver problemas, siga os procedimentos de resolução de problemas do agente Node.js.

Atualize para o agente Node.js versão 11

Antes de atualizar para o Node.js versão 11, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v11

Comments

Adicionado suporte de paridade oficial para Node.js 20.

BREAKING: Suporte ao Node.js 14 eliminado.

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.

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

Suporte à versão Node.js.

Node.js 16 é a versão mais antiga suportada pelo agente New Relic Node.js v11. Node.js 14 e 15 não são suportados pela v11. Os clientes que executam o Node.js 15 e versões anteriores têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v11.
  • Permanecer no agente New Relic Node.js v10 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 16.

Atualizar para o agente Node.js versão 10

Antes de atualizar para o Node.js versão 10, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v11

Comments

  • 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

Suporte à versão Node.js.

Node.js 14 é a versão mais antiga compatível com o agente New Relic Node.js v10. Node.js 12 e 13 não são suportados pela v10. Os clientes que executam o Node.js 13 e versões anteriores têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v10.
  • Permanecer no agente New Relic Node.js v8 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 14.

Atualizar para o agente Node.js versão 9

Antes de atualizar para o Node.js versão 9, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v9

Comments

Adicionado suporte de paridade oficial para Node.js 18.

BREAKING: Suporte ao Node.js 12 eliminado.

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.

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

Suporte à versão Node.js.

Node.js 14 é a versão mais antiga suportada pelo agente New Relic Node.js v9. Node.js 12 e 13 não são suportados pela v9. Os clientes que executam o Node.js 13 e versões anteriores têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v9.
  • Permanecer no agente New Relic Node.js v8 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 14.

Atualize para o agente Node.js versão 8

Antes de atualizar para o Node.js versão 8, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v8

Comments

Adicionado suporte de paridade oficial para Node.js 16.

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

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

Suporte à versão Node.js.

Node.js v12 é a versão mais antiga compatível com o agente New Relic Node.js v8. Node.js 10 e 11 não são suportados pela v8. Os clientes que executam o Node.js 11 e versões anteriores têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v8.
  • Permanecer no agente New Relic Node.js v7 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 12.

Atualize para o agente Node.js versão 7

Antes de atualizar para o Node.js versão 7, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v7

Comments

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.

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

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

Suporte à versão Node.js.

Node.js v10 é a versão mais antiga suportada pelo agente New Relic Node.js v7. Node.js 8 e 9 não são suportados pela v7. Os clientes que executam o Node.js 9 e versões anteriores têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v7.
  • Permanecer no agente New Relic Node.js v6 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

O Node.js 10 não recebe atualizações. Atualize para uma versão mais recente do Node.js o mais rápido possível. O suporte para Node.js 10 foi descontinuado com o agente New Relic Node.js v8.

Atualizar para o agente Node.js versão 6

Antes de atualizar para o agente Node.js versão 6, revise estas informações para obter alterações importantes.

Major changes with Node.js agent v6

Comments

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.

Suporte à versão Node.js.

Node.js 8 é a versão mais antiga suportada pelo agente New Relic Node.js v6. Node.js 6, 7 e 9 não são suportados pela v6. Os clientes que executam o Node.js 6, 7 e 9 têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v6.
  • Permanecer no agente New Relic Node.js v5 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

O Node.js 8 não recebe mais atualizações, mas a New Relic continuará a oferecer suporte a essas versões do Node.js por enquanto.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 8.

Atualize para o agente Node.js versão 5

Antes de atualizar para o agente Node.js v5, revise estas informações para obter alterações importantes. Consulte também o guia de migração Node.js v5 da New Relic no GitHub.

Major changes with Node.js v5 agent

Comments

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.

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.

Suporte à versão Node.js.

Node.js 6 é a versão mais antiga suportada pelo agente New Relic Node.js v5. Node.js 4 e 5 não são suportados pela v5. Os clientes que executam o Node.js 4 ou 5 têm duas opções:

  • Atualize para uma versão compatível do Node.js e aproveite o novo recurso do agente New Relic Node.js v5.
  • Permanecer no agente New Relic Node.js v4 sem a capacidade de usar o novo recurso disponível apenas com versões do agente de atualização.

O Node.js 7 e 9 não recebem mais atualizações, mas a New Relic continuará a oferecer suporte a essas versões do Node.js por enquanto.

Dica

Atualize para uma versão mais recente do Node.js o mais rápido possível. A próxima versão principal do agente New Relic Node.js provavelmente removerá o suporte para Node.js 6 e 7.

Sinalizadores de recurso a partir da v5

A partir do New Relic para Node.js v5:

  • custom_instrumentation: esse recurso não é mais configurável.
  • custom_metrics: esse recurso não é mais configurável.
  • synthetics: esse recurso não é mais configurável.
  • native_metrics: esse recurso agora é controlado pelo valor de configuração plugins.native_metrics.enabled .

Atualize para o agente Node.js versão 4

Antes de atualizar para o agente Node.js v4, revise estas informações para obter alterações importantes. Consulte também o guia de migração Node.js v4 da New Relic no GitHub.

Atualizar para o agente Node.js versão 3

Antes de atualizar para o Node.js agente agente v3, revise estas informações para obter alterações importantes. Consulte também o guia de migração Node.js v3 da New Relic no GitHub.

Atualizar para o agente Node.js versão 2

Antes de atualizar para o agente Node.js v2, revise estas informações para obter alterações importantes. Consulte também o guia de migração Node.js v2 da New Relic no GitHub.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.