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 :
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
É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
|
Problème
|
Cause possible
|
Résolution
|
|
L'application n'apparaît pas dans le tableau de bord
|
Agent non initialisé avant le code de l'application
|
Assurez-vous que require('appdynamics') est en première ligne
|
|
L'installation des agents échoue
|
Autorisations manquantes ou absence d'Internet ou de système d'exploitation incompatible
|
Exécuter avec des autorisations élevées ou s'assurer que les plates-formes prises en charge
|
|
Erreur d'accès 401
|
AccountAccessKey ou accountName incorrect
|
Vérifiez deux fois les informations d'identification d'AppDynamics Controller
|
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.