• 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

Medições de VM Node.js

O agente Node.js da New Relic coleta dados principais de métricas de fração de tempo da máquina virtual Node.js (V8). Essas métricas fornecem insights sobre o comportamento da VM Node.js e ajudam a melhorar o desempenho do seu aplicativo. O agente também coleta métricas de CPU, que muitas vezes são analisadas em conjunto com métricas de coleta de lixo (GC).

O que você precisa

O New Relic requer um módulo nativo adicional para coletar dados métricos de fração de tempo da VM Node.js relacionados à coleta de lixo, memória e CPU. A partir do Node.js v6.1.0 o módulo nativo não é necessário para coletar métricas de CPU, pois o agente New Relic Node.js as coleta com process.cpuUsage().

O módulo nativo pode ser usado com:

  • New Relic Node.js versão 1.35.1 ou superior
  • Node.js v4 ou superior
  • npm v2.0.0 ou superior

Para compilar o módulo nativo em sua plataforma de implantação, siga os procedimentos do pacotenode-gyp . Os pré-requisitos para instalar módulos nativos do Node.js incluem:

Plataforma

Pré-requisitos

Unix/Linux

Python (v2.7 recomendado, v3.xx não suportado), make, compilador C/C++ (como GCC)

Mac OS

Python (v2.7 recomendado, v3.xx não compatível), Xcode

Windows

Python (v2.7 recomendado, v3.xx não compatível), Visual C++ Build Environment

Se você tiver problemas ao instalar nosso agente Node.js, siga os procedimentos de instalação de resolução de problemas .

Instale o módulo nativo

A partir da versão 2.0.0 do agente New Relic Node.js, o módulo nativo tornou-se uma dependência opcional que tenta ser instalada automaticamente.

Durante a instalação, o módulo nativo primeiro tenta compilar a partir da origem na máquina de destino. Se a compilação falhar, o Node.js gera um stack trace para o console que você normalmente pode ignorar. Para ambientes Linux que executam versões suportadas do Node, o agente tenta baixar e instalar um binário pré-construído.

É possível evitar que o agente tente baixar e instalar um binário pré-construído. Em vez disso, ele tentará apenas construir o módulo nativo. Faça isso definindo a variável de ambiente NR_NATIVE_METRICS_NO_DOWNLOAD como true antes da instalação com npm ou Yarn.

bash
$
export NR_NATIVE_METRICS_NO_DOWNLOAD=true
bash
$
npm install @newrelic/native-metrics
bash
$
yarn add @newrelic/native-metrics

Como alternativa, use a sinalização --no-download que funciona com npm.

bash
$
npm install @newrelic/native-metrics --no-download

Se a compilação falhar com NR_NATIVE_METRICS_NO_DOWNLOAD=true ou o sinalizador --no-download definido, o módulo nativo opcional não será instalado.

Se ambas as variáveis de ambiente forem definidas, NR_NATIVE_METRICS_NO_BUILD substituirá NR_NATIVE_METRICS_NO_DOWNLOAD.

Se você estiver usando uma versão mais antiga, atualize para a versão mais recente do agente ou instale o módulo nativo manualmente:

  1. Certifique-se de que uma versão compatível do Node.js esteja instalada. Recommendation: Use a versão LTS mais recente. Não use versões inferiores à versão mínima suportada para o módulo @newrelic/native-metrics (v4 ou superior).

  2. Para obter todas as métricas disponíveis atualmente, verifique se você está executando o módulo newrelic para o agente 1.37.0 ou superior.

  3. Windows users: Execute o seguinte comando:

    bash
    $
    npm install --global windows-build-tools

    Se esta etapa não funcionar, siga a Opção 2 no módulo node-gyp no GitHub para obter instruções de instalação manual.

  4. Para instalar o módulo métrica nativo, use um destes métodos:

    • Execute o comando npm install @newrelic/native-metrics --save .

      OU

    • Adicione o módulo ao arquivo package.json do seu aplicativo.

  5. Reinicie seu aplicativo.

O agente Node.js detecta automaticamente se o módulo métrica nativo está instalado e começa a utilizá-lo. Se quiser evitar completamente a instalação do módulo nativo, você pode usar os seguintes argumentos npm ou Yarn.

bash
$
npm install newrelic --no-optional
bash
$
yarn add newrelic --ignore-optional

Binários pré-construídos

Para ignorar a etapa de compilação e tentar fazer download apenas de um binário pré-compilado e para evitar erros de compilação no console, defina a variável de ambiente NR_NATIVE_METRICS_NO_BUILD como true antes da instalação.

bash
$
export NR_NATIVE_METRICS_NO_BUILD=true

Se estiver trabalhando atrás de um firewall, você poderá armazenar em cache binários pré-criados definindo as variáveis de ambiente NR_NATIVE_METRICS_DOWNLOAD_HOST e NR_NATIVE_METRICS_REMOTE_PATH antes da instalação.

bash
$
export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/
bash
$
export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/

Depois de definir as variáveis de ambiente, a instalação poderá prosseguir.

bash
$
npm install @newrelic/native-metrics
bash
$
yarn add @newrelic/native-metrics

Ver dados da VM Node.js

Para visualizar gráficos selecionados com dados de VM Node.js, acesse one.newrelic.com > All capabilities > APM & services > (select an app) > Node VMs. Para obter mais informações, consulte a página de estatísticas de VM do Node.js.

Os dados também estão disponíveis em métricas e eventos.

Detalhes de medição

Dica

Nem todos os dados podem ser coletados em todas as versões do Node.js. Em geral, você obterá os dados mais completos se estiver usando a versão LTS mais recente do Node.

Copyright © 2024 New Relic Inc.

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