Instalar Agente AppDynamics Node.js

Introdução

Este documento descreve como instalar e configurar o Agente AppDynamics Node.js para monitorar um aplicativo Node.js para métricas de desempenho.

Pré-requisitos

Requisitos

Para continuar com a configuração, verifique se:

• Familiaridade com Node.js e estrutura Express

• Um aplicativo em funcionamento ou use o aplicativo presente no link GitHub da seção Informações Relacionadas

• Noções básicas sobre variáveis de ambiente e estrutura de aplicativos

• Acesso ao SaaS do AppDynamics ou ao controlador local

• Credenciais de acesso à API (nome da conta, chave de acesso, host/porta do controlador)

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software:

• Node.js v18.x 

• Agente 24.x do AppDynamics Node.js

• AppDynamics Controller (no local ou SaaS)

• Há um link GitHub na seção Informações relacionadas que tem o aplicativo completo

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

O Agente AppDynamics Node.js permite que você instrumente e monitore seus aplicativos Node.js. Ele captura dados de transações comerciais, tempos de resposta de back-end, uso de memória e métricas de CPU e os envia para o AppDynamics Controller.

Para coletar métricas adequadamente, o agente deve ser inicializado antes que qualquer outro módulo de aplicação do usuário seja carregado. O agente se comunica por HTTP(S) com o Controlador e requer detalhes de host, porta e chave de acesso do controlador para funcionar corretamente.

Configurar

Tip: Certifique-se de substituir todas as variáveis pelos detalhes reais do AppDynamics Controller no trecho de configuração.

Passo 1: Instalar o agente

Instale o Agente AppDynamics Node.js usando o NPM:

npm install appdynamics --save

Passo 2: Inserir configuração no código

Adicione o código na parte superior do arquivo principal (app.js ou index.js), antes de qualquer outro módulo:

require("appdynamics").profile({
    controllerHostName: 'ControllerURL',
    controllerPort: ControllerPort, 
    controllerSslEnabled: true,  // Set to true if controllerPort is SSL
    accountName: 'accountName',
    accountAccessKey: 'accountAccessKey', // required
    applicationName: 'Hello_World_NodeJS', // Change the name of application
    tierName: 'Hello_World_NodeJS_Tier', // Change the name of tier
    nodeName: 'Hello_World_NodeJS_Node', //// Change the name of node

});

Passo 3: Adicionar a Lógica do Aplicativo

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Example app listening on port ${port}`);
});

Verificar

Passo 1: Inicie seu aplicativo

node app.js

• Aplicar carga no aplicativo

Passo 2: Ir para o Painel do AppDynamics

• Faça logon no AppDynamics Controller

• Navegue até Aplicativos > Hello_World_NodeJS

• Procure métricas e mapas de fluxo em 5 minutos

Troubleshooting

Informações Relacionadas

Documentação do AppDynamics

Instalar o agente Node.js

Demonstração do AppDynamics Node.js do GitHub

Precisa de mais assistência?

Se você tiver alguma dúvida ou estiver tendo problemas, crie um tíquete de suporte com estes detalhes:

• Detalhes do erro ou Captura de tela:forneça uma mensagem de erro específica ou uma captura de tela do problema.
• Comando usado:especifique o comando exato que você estava executando quando o problema ocorreu.
• Logs de agentes de nós :Forneça os logs de agentes de /tmp/appd/*/logs/, se gerados.