Installer AppDynamics Node.js Agent

Introduction

Ce document décrit comment installer et configurer l'agent AppDynamics Node.js pour surveiller une application Node.js pour les mesures de performances.

Conditions préalables

Exigences

Pour poursuivre la configuration, assurez-vous que vous respectez les conditions suivantes :

• Connaissance de Node.js et du framework Express

• Une application opérationnelle ou utilisez l'application présente dans le lien GitHub de la section Informations connexes

• Compréhension de base des variables d'environnement et de la structure des applications

• Accès à AppDynamics SaaS ou au contrôleur sur site

• Identifiants d'accès à l'API (nom du compte, clé d'accès, hôte/port du contrôleur)

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions logicielles suivantes :

• Noeud.js v18.x 

• AppDynamics Node.js Agent 24.x

• AppDynamics Controller (sur site ou SaaS)

• Un lien GitHub dans la section Informations connexes présente une application complète

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

L'agent AppDynamics Node.js vous permet d'instrumenter et de surveiller vos applications Node.js. Il capture les données de transaction commerciale, les temps de réponse du back-end, l'utilisation de la mémoire et les mesures du CPU, et les envoie au contrôleur AppDynamics.

Pour collecter correctement les mesures, l'agent doit être initialisé avant le chargement d'autres modules d'application utilisateur. L'agent communique via HTTP(S) avec le contrôleur et a besoin des détails de l'hôte, du port et de la clé d'accès du contrôleur pour fonctionner correctement.

Configurer

Conseil : Assurez-vous de remplacer toutes les variables par les détails réels de votre AppDynamics Controller dans l'extrait de configuration.

Étape 1: Installer l'agent

Installez l'agent AppDynamics Node.js à l'aide de NPM :

npm install appdynamics --save

Étape 2: Incorporer la configuration dans le code

Ajoutez le code en haut de votre fichier principal (app.js ou index.js), avant tout autre module :

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

});

Étape 3: Ajouter votre logique d'application

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

Vérifier

Étape 1: Démarrez votre application

node app.js

• Appliquer la charge à l'application

Étape 2: Accéder au tableau de bord AppDynamics

• Connectez-vous à votre AppDynamics Controller

• Accédez à Applications > Hello_World_NodeJS

• Recherchez des mesures et des cartes de flux dans un délai de 5 minutes

Dépannage

Informations connexes

Documentation AppDynamics

Installation de l'agent Node.js

Démo AppDynamics GitHub Node.js

Besoin d'aide supplémentaire ?

Si vous avez une question ou rencontrez des problèmes, veuillez créer un ticket d'assistance avec ces détails :

• Error Details or Screenshot : fournissez un message d'erreur spécifique ou une capture d'écran du problème.
• Commande utilisée : spécifiez la commande exacte que vous étiez en train d'exécuter lorsque le problème s'est produit.
• Journaux d'agent de noeud : fournissez les journaux d'agent à partir de /tmp/appd/*/logs/ s'ils sont générés.