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:
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
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
|
Problema
|
Possível causa
|
Resolução
|
|
O aplicativo não aparece no painel
|
Agente não inicializado antes do código do aplicativo
|
Assegurar que require('appdynamics') é a primeira linha
|
|
Falha na instalação do agente
|
Permissões ausentes, sem Internet ou SO incompatível
|
Execute com permissões elevadas ou assegure-se de usar plataformas suportadas
|
|
erro de acesso 401
|
AccountAccessKey ou accountName incorreto
|
Verifique novamente as credenciais do AppDynamics Controller
|
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.