appdynamics/nodejs-agent

Node.js应用监控代理镜像

镜像概述

本镜像是一个轻量级代理工具，专为监控Node.js应用程序设计。通过在容器中部署该代理，可无缝集成到Node.js应用环境，实时收集应用运行时的关键指标和状态数据，为应用性能优化、故障排查和健康管理提供支持。

核心功能与特性

性能指标收集

• 实时采集应用级性能指标：响应时间、请求吞吐量、并发连接数
• 系统资源监控：CPU使用率、内存占用、磁盘I/O、网络流量
• 事件循环延迟追踪：检测Node.js事件循环阻塞情况

错误与异常监控

• 自动捕获未处理异常和Promise拒绝
• 记录错误堆栈信息和发生上下文
• 异常频率统计与告警触发支持

运行状态追踪

• 应用启动时间、正常运行时长监控
• 进程状态（启动/停止/重启）记录
• 依赖包版本与加载状态检测

兼容性与集成

• 支持Node.js v12+版本
• 兼容主流监控平台（如Prometheus、Grafana）
• 支持日志输出至标准输出流或外部日志系统

使用场景

• 生产环境监控：实时监控线上Node.js应用健康状态，及时发现性能瓶颈和异常
• 开发调试：在开发阶段收集应用运行数据，辅助排查代码性能问题
• 性能优化：通过历史指标分析，识别应用性能优化方向
• 故障排查：结合错误追踪和性能数据，快速定位生产环境故障根源

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name nodejs-monitor-agent \
  -e APP_URL=http://nodejs-app:3000 \
  -e MONITOR_SERVER=http://prometheus:9090 \
  -e SAMPLING_RATE=100 \
  -e LOG_LEVEL=info \
  --network app-network \
  nodejs-monitor-agent:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  nodejs-app:
    image: node:16-alpine
    ports:
      - "3000:3000"
    networks:
      - app-network

  monitor-agent:
    image: nodejs-monitor-agent:latest
    environment:
      - APP_URL=http://nodejs-app:3000
      - MONITOR_SERVER=http://prometheus:9090
      - SAMPLING_RATE=100
      - LOG_LEVEL=info
      - METRICS_INTERVAL=5s
    depends_on:
      - nodejs-app
    networks:
      - app-network

networks:
  app-network:

配置参数（环境变量）

数据输出格式

默认采用Prometheus兼容格式输出指标，示例：

nodejs_app_cpu_usage{app="my-node-app"} 0.35
nodejs_app_memory_usage{app="my-node-app"} 128000000
nodejs_app_response_time{app="my-node-app"} 45
nodejs_app_errors_total{app="my-node-app"} 2

注意事项

1. 确保代理容器与被监控Node.js应用在同一网络，可通过--network参数指定
2. 生产环境建议设置LOG_LEVEL=warn以减少日志输出量
3. 高流量应用可适当降低SAMPLING_RATE（如50%）以减少性能开销
4. 若需持久化监控数据，需配置MONITOR_SERVER指向外部监控系统