Instalar el agente AppDynamics Node.js

Introducción

Este documento describe cómo instalar y configurar el agente AppDynamics Node.js para monitorear una aplicación Node.js para las métricas de rendimiento.

Prerequisites

Requirements

Para continuar con la configuración, asegúrese de que cumple los siguientes requisitos:

• Familiaridad con Node.js y el marco Express

• Una aplicación en funcionamiento o utilizar la aplicación presente en el enlace de GitHub de la sección Información Relacionada

• Comprensión básica de las variables de entorno y la estructura de aplicaciones

• Acceso a AppDynamics SaaS o al controlador en las instalaciones

• Credenciales de acceso a la API (nombre de cuenta, clave de acceso, host/puerto del controlador)

Componentes Utilizados

La información que contiene este documento se basa en estas versiones de software:

• Node.js v18.x 

• Agente AppDynamics Node.js 24.x

• AppDynamics Controller (in situ o SaaS)

• Hay un enlace GitHub en la sección de información relacionada que tiene la aplicación completa

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

El agente AppDynamics Node.js permite instrumentar y supervisar las aplicaciones Node.js. Captura datos de transacciones comerciales, tiempos de respuesta de backend, uso de memoria y métricas de CPU, y los envía a AppDynamics Controller.

Para recopilar las métricas correctamente, el agente se debe inicializar antes de cargar cualquier otro módulo de aplicación de usuario. El agente se comunica a través de HTTP(S) con el controlador y requiere que el host del controlador, el puerto y los detalles de la clave de acceso funcionen correctamente.

Configurar

Consejo: Asegúrese de reemplazar todas las variables con los detalles reales de AppDynamics Controller en el fragmento de configuración.

Paso 1: Instalación del agente

Instale el agente AppDynamics Node.js mediante NPM:

npm install appdynamics --save

Paso 2: Incrustar configuración en el código

Agregue el código que se encuentra en la parte superior del archivo principal (app.js o index.js), antes de cualquier otro 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

});

Paso 3: Agregar la lógica de aplicación

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}`);
});

Verificación

Paso 1: Iniciar la aplicación

node app.js

• Aplicar carga en la aplicación

Paso 2: Ir al panel de AppDynamics

• Inicie sesión en AppDynamics Controller

• Vaya a Aplicaciones > Hello_World_NodeJS

• Busque métricas y mapas de flujo en 5 minutos

Troubleshoot

Información Relacionada

Documentación de AppDynamics

Instale el agente Node.js

Demostración de AppDynamics de GitHub Node.js

¿Necesita más asistencia?

Si tiene alguna pregunta o experimenta algún problema, cree un ticket de soporte con estos datos:

• Detalles del error o captura de pantalla:proporcione un mensaje de error específico o una captura de pantalla del problema.
• Comando utilizado: especifique el comando exacto que estaba ejecutando cuando se produjo el problema.
• Registros del agente de nodo:Proporcione los registros del agente de /tmp/appd/*/logs/ si se generan.