安装applicationinsights-native-metrics后如何查看Node.js扩展指标？

1. 确认包版本兼容性 #

• 确保applicationinsights-native-metrics与核心applicationinsights SDK版本匹配，版本差异过大可能导致扩展指标无法加载。建议安装同系列兼容版本，比如核心SDK用2.x分支，native-metrics也选2.x版本。
• 执行npm list applicationinsights applicationinsights-native-metrics查看当前版本，若不兼容，卸载后重装匹配版本：

  npm uninstall applicationinsights applicationinsights-native-metrics && npm install applicationinsights@latest applicationinsights-native-metrics@latest
  

2. 检查代码加载顺序 #

• 显式引入包时，必须在初始化Application Insights SDK之前加载native metrics，顺序错误会直接导致失效：

  // 先加载native metrics
  require('applicationinsights-native-metrics');
  // 再初始化SDK
  const appInsights = require('applicationinsights');
  appInsights.setup('<你的Instrumentation Key>').start();
  

• 启动应用后查看控制台日志，若出现Native metrics monitoring successfully started则说明加载成功；若有依赖缺失、平台不支持类报错，根据提示修复（比如Linux环境需安装libgomp1依赖）。

3. 验证资源配置与延迟问题 #

• 确认使用的Instrumentation Key/Connection String对应正确的Application Insights资源，避免指标发送到了错误资源。
• 指标存在传输延迟，安装启用后等待5-10分钟再去指标资源管理器查看，不要立即排查。

4. 排查环境限制 #

• applicationinsights-native-metrics仅支持Windows、Linux和部分macOS版本，若运行在Alpine Linux、无权限容器等特殊环境，可能无法正常加载。建议先在本地开发环境测试，确认指标能正常显示后再排查部署环境问题。
• 容器部署时，确保镜像包含必要系统依赖（比如Linux下的libstdc++、libgomp）。

5. 启用调试日志确认发送状态 #

• 开启SDK调试日志，查看是否有native metrics的发送记录：

  appInsights.setup('<你的Instrumentation Key>')
    .setInternalLogging(true, true) // 启用调试日志
    .start();
  

• 查看控制台输出中是否有Metric data sent相关日志，且包含Node.js Extended Metrics类指标项，若没有则说明指标未生成或未发送。

内容的提问来源于stack exchange，提问作者Matt Brown