Node.js应用接入APM

Node.js应用接入APM

1. 登录APM控制台。
2. 在左侧导航栏中选择“应用监控 > 应用列表”。
3. 进入“接入应用”页面。
   • 首次接入应用时，单击“点击接入应用”，进入“接入应用”页面。
   • 已有探针接入时，在页面右上角，单击“接入应用”，进入“接入应用”页面。

4. 选择“区域”和“应用”。若未有应用，可单击“创建应用”，弹出“创建应用”弹窗，具体操作请参见创建应用。
5. “接入方式”选择“增强型探针”。
6. “服务端语言”选择Node.js。
7. 数据接入。
   • 无修改接入。
     1. 请到“系统管理 > 访问密钥”界面，获取Java Agent所需的AK、SK。获取“访问密钥”的方法，请参见管理APM访问密钥。
     2. 使用SSH远程登录工具，登录待安装Java Agent的Linux操作系统主机，并以root或service权限执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致。
     3. 接入命令如下：

        npm install -S apm-nodejs-agent && APM_APP_NAME=apm-nodejs-demo APM_AK=APM访问密钥 ID APM_SK=APM秘密访问密钥 APM_MASTER_ADDRESS=APM探针的接入地址 node -r apm-nodejs-agent/tracing app.js; history -cw; history -r

        表1 无修改接入参数

        环境变量	入参	描述	选项
        APM_APP_NAME	appName	组件名称，一个组件可以包含多个环境。不能重复，如果要重复，使用APM_INSTANCE_NAME区分。	必填
        APM_AK	AK	APM访问密钥ID（AK）。获取APM_AK方法参见管理APM访问密钥。	必填
        APM_SK	SK	APM秘密访问密钥（SK）。获取APM_AK方法参见管理APM访问密钥。	必填
        APM_MASTER_ADDRESS	masterAddress	APM探针的接入地址。请参见探针接入地址。	必填

   • 自定义接入。
     1. 使用SSH远程登录工具，登录待安装Java Agent的Linux操作系统主机，并以root或service权限执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致。
     2. 安装apm-nodejs-agent，命令如下：

        npm install -S apm-nodejs-agent

     3. 添加Java Agent启动和配置项，示例如下：

            const process = require('process');
            const agent = require('apm-nodejs-agent');
        
            agent.start({
              appName: 'apm-nodejs-demo',
              masterAddress: 'APM探针的接入地址',
              AK: 'APM访问密钥',
              SK: 'APM秘密访问密钥'
            }).then(()=>{
              console.log('Agent trace start');
            }).catch((error)=>{
              console.log('Error agent trace',error);
            })
        
            process.on('SIGTERM',()=>{
              agent.stop();
            })

        表2 自定义接入参数

        环境变量	入参	描述	选项
        APM_APP_NAME	appName	组件名称，一个组件可以包含多个环境。不能重复，如果要重复，使用APM_INSTANCE_NAME区分。	必填
        APM_AK	AK	APM访问密钥ID（AK）。获取APM_AK方法参见管理APM访问密钥。	必填
        APM_SK	SK	APM秘密访问密钥（SK）。获取APM_AK方法参见管理APM访问密钥。	必填
        APM_MASTER_ADDRESS	masterAddress	APM探针的接入地址。请参见探针接入地址。	必填