添加Telemetry Initializer后Azure App Insights调用量激增求助

为什么会出现调用量暴增/控制台输出过多？ #

核心原因1：Telemetry Initializer的执行逻辑 #

Telemetry Initializer会在每一条遥测数据发送前被触发一次，而你的配置开启了多个自动捕获功能：

• enableAutoRouteTracking: true：自动追踪所有路由变化
• ClickAnalyticsPlugin的autoCapture: true：自动捕获页面上所有点击事件、交互行为
• ReactPlugin：自动追踪React组件的挂载、卸载及性能数据

这些功能本身就会产生大量遥测（页面视图、点击事件、性能指标、组件生命周期事件等），原本这些遥测是静默发送的，你添加的console.log只是让这些原本就存在的遥测变得可见，看起来像“调用量激增”。

核心原因2：错误修改遥测结构 #

你直接给envelope.data.username赋值的方式不符合App Insights的遥测结构规范：

• 大部分遥测的自定义属性应该放在envelope.baseData.properties中，而非envelope.data
• 强行修改不存在的data字段可能触发异常，导致App Insights捕获到异常遥测，而异常遥测又会经过初始化器，形成循环，进一步增加遥测数量。

解决办法 #

1. 正确添加自定义用户属性 #

修改Telemetry Initializer，将用户名添加到标准的自定义属性字段中，避免破坏遥测结构：

const telemetryInitializer = (envelope) => {
  // 确保baseData和properties字段存在，避免报错
  if (!envelope.baseData) {
    return;
  }
  if (!envelope.baseData.properties) {
    envelope.baseData.properties = {};
  }
  // 将用户名添加到自定义属性
  envelope.baseData.properties.username = username;
  
  // 调试时仅输出特定类型的遥测，避免控制台刷屏
  const targetTypes = ["PageViewData", "ExceptionData", "ClickEventData"];
  if (targetTypes.includes(envelope.baseType)) {
    console.log("test", envelope.baseType);
    console.log("envelope", envelope);
  }
};

2. 减少不必要的自动捕获 #

根据实际需求调整自动捕获范围，降低遥测总量：

• 调整ClickAnalyticsPlugin配置，仅捕获需要的点击事件：

  const clickPluginConfig = {
    autoCapture: true,
    // 只捕获带有data-ai-click属性的元素
    captureOnlyElementsWithAttribute: true,
    // 或者排除某些元素
    excludeElements: ["button.no-track"]
  };
  

• 关闭不需要的自动追踪，比如不需要路由追踪时设置enableAutoRouteTracking: false

3. 排查循环遥测 #

如果确实存在调用量异常激增（而非仅控制台输出多），检查初始化器代码是否会触发新的遥测：

• 确保修改envelope的代码不会抛出错误（比如先判断字段是否存在）
• 暂时注释掉初始化器中的console.log，观察App Insights的调用量是否恢复正常，确认是否是log本身导致的问题（虽然可能性极低）

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