安装AppDynamics Node.js代理

简介

本文档介绍如何安装和配置AppDynamics Node.js代理以监视Node.js应用程序的性能度量。

先决条件

要求

要继续设置，请确保满足以下条件：

• 熟悉Node.js和Express框架

• 正在运行的应用程序或使用“相关信息”部分中GitHub链接中的应用程序

• 基本了解环境变量和应用结构

• 访问AppDynamics SaaS或内部控制器

• API访问凭证（帐户名称、访问密钥、控制器主机/端口）

使用的组件

本文档中的信息基于以下软件版本：

• Node.js v18.x 

• AppDynamics Node.js代理24.x

• AppDynamics控制器（内部部署或SaaS）

• “相关信息”部分中有一个GitHub链接，该链接具有完整的应用程序

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

AppDynamics Node.js代理允许您检测并监控Node.js应用程序。它捕获业务事务数据、后端响应时间、内存使用率和CPU指标，并将其发送到AppDynamics控制器。

要正确收集度量，必须先初始化代理，然后才能加载任何其他用户应用模块。代理通过HTTP(S)与控制器通信，需要控制器主机、端口和访问密钥详细信息才能正常工作。

配置

提示：请确保在配置代码段中将所有变量替换为实际的AppDynamics Controller详细信息。

步骤 1：安装代理

使用NPM安装AppDynamics Node.js代理：

npm install appdynamics --save

步骤 2：在代码中嵌入配置

将代码添加到主文件（app.js或index.js）的最顶部，然后添加到任何其他模块之前：

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

});

步骤 3：添加应用逻辑

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

验证

步骤 1：启动你的应用

node app.js

• 在应用程序上应用负载

步骤 2：转到AppDynamics仪表板

• 登录您的AppDynamics控制器

• 导航到应用> Hello_World_NodeJS

• 在5分钟内查找指标和流图

故障排除

相关信息

AppDynamics文档

安装Node.js代理

GitHub Node.js AppDynamics演示

需要进一步的帮助？

如果您遇到问题或遇到问题，请使用以下详细信息创建asupport票证：

• 错误详细信息或屏幕截图：提供特定错误消息或问题的屏幕截图。
• 使用的命令：指定发生问题时正在运行的确切命令。
• 节点代理日志：如果生成，请从/tmp/appd/*/logs/提供代理日志。