Configurando o Coletor de dados Node.js para aplicativos no local

Se você instalou o aplicativo Node.js em um ambiente local, será necessário configurar o Coletor de dados Node.js para coletar informações sobre o aplicativo Node.js.

Antes de Iniciar

  1. Certifique-se de que o aplicativo Node.js possa ser executado localmente com sucesso. O Coletor de dados Node.js independente pode monitorar os fix packs Node.js V8.0.0 e futuros, fix packs V10.0.0 e futuros e fix packs V12.0.0 e futuros.
  2. Faça download do pacote coletor de dados no website do IBM® Marketplace. Para obter instruções detalhadas, consulte Fazendo download de seus agentes e coletores de dados.

Procedimento

  1. Extraia os arquivos do pacote do coletor de dados. O pacote nodejs_datacollector_8.1.4.0.6.tgz é incluído no diretório extraído.
  2. Determine o diretório inicial de seu aplicativo.
    • Para aplicativos Node.js típicos, se você usar o comando node app.js para iniciar o aplicativo Node.js e o arquivo principal app.js estiver no diretório /root/nodejs_app, /root/nodejs_app será o diretório inicial de seu aplicativo.
    • Para membros coletivos no ambiente do IBM API Connect, execute o comando wlpn-server list para exibir a lista de todos seus membros coletivos na mesma máquina. O diretório inicial de seu membro coletivo está no seguinte formato:
      user_directory/collective-member_name/package
      Por exemplo, se você receber /root/wlpn/rock-8345a96-148538-1/package como uma saída de comando, /root/wlpn será o diretório do usuário e rock-8345a96-148538-1 será o nome do membro coletivo.
    • Para aplicativos do Portal do Desenvolvedor no ambiente do IBM API Connect, é possível executar o comando ps -ef | grep node para localizar o diretório inicial. Se você receber a seguinte saída de comando, por exemplo, o diretório inicial será /home/admin/bgsync e o arquivo principal de seu aplicativo será rest_server.js:
      admin 19085 1 0 Jun25?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  3. No diretório inicial de seu aplicativo, execute o seguinte comando para extrair arquivos do pacote do coletor de dados:
    tar -zxf nodejs_datacollector_8.1.4.0.6.tgz
  4. Extraia o arquivo ibmapm.tgz na pasta nodejs_dc executando o comando a seguir:
    tar -zxf nodejs_dc/ibmapm.tgz
    Você obterá uma pasta ibmapm.
  5. Execute o seguinte comando para instalar o coletor de dados em seu aplicativo:
    npm install ./ibmapm
  6. Inclua a linha a seguir no início do arquivo principal de seu aplicativo Node.js:
    require('ibmapm');
    • Se você iniciar seu aplicativo executando o comando node app.js, app.js será o arquivo principal de seu aplicativo.
    • Para membros coletivos no ambiente do IBM API Connect, o arquivo principal é definido no arquivo package.json no diretório inicial ou em suas subpastas. Por padrão, o arquivo principal é home_directory/server/server.js, em que home_directory é o diretório inicial para seu membro coletivo.
    • Para aplicativos do Portal do Desenvolvedor no ambiente do IBM API Connect, é possível executar o comando ps -ef | grep node para localizar o arquivo principal. Se você receber a seguinte saída de comando, o arquivo principal de seu aplicativo será rest_server.js.
      admin 19085 1 0 Jun25?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js
  7. Reinicie a aplicação.
    Dica:
    • Para reiniciar o membro coletivo, execute o comando wlpn-server stop collective_member_name. O membro coletivo é reiniciado automaticamente após a execução desse comando. Se ele não iniciar, execute o comando wlpn-server start collective_member_name para reiniciá-lo manualmente.
    • Para reiniciar seus aplicativos do Portal do Desenvolvedor, primeiro execute o comando /etc/init.d/restservice stop para parar o aplicativo e, em seguida, execute o comando /etc/init.d/restservice start para iniciá-lo.

Resultados

O coletor de dados é configurado e está conectado ao Servidor Cloud APM.

O que Fazer Depois

Lembre-se: Para incluir o aplicativo no Console do Cloud APM, escolha Tempo de Execução de Node.js no editor de aplicativos.