【App Service】排查App Service中发送Application Insights日志数据问题的神级脚本: Test-AppInsightsTelemetryFlow.ps1

简介: 本文介绍 Azure 中国区 Application Insights 日志无数据问题的排查利器——微软官方诊断脚本 `Test-AppInsightsTelemetryFlow.ps1`。该脚本可逐层验证 SDK、网络、TLS、ingestion endpoint 等遥测链路,精准定位日志丢失环节,支持 PowerShell(Windows)和 Bash(Linux),大幅提升故障排查效率。(239字)

问题描述

在 Azure Application Insights 故障排查过程中,经常会遇到这样一类典型问题:

  • SDK 已经部署
  • Connection String 已配置
  • 应用运行正常
  • 但 App Insights Portal 中完全没有任何日志数据(指标,请求记录,应用中输出的日志)

我们通常会问一个问题:“我的代码到底有没有成功把日志数据发到 Application Insights?”

遗憾的是,而我们几乎无法确定,且没有有效的工具来帮助定位问题,到底这个问题发生在那里呢?

  • 日志数据是在 SDK 层丢失?
  • 还是被网络拦截?
  • 还是 ingestion endpoint (https://chinanorth3-0.in.applicationinsights.azure.cn/v2/track) 不通?
  • .... ....

 

问题解答

非常好的消息是,微软Application Insights团队提供了一个神级脚本 (Test-AppInsightsTelemetryFlow.ps1) , 可以在你的应用环境中通过执行PowerShell脚本来监测日志收集过程中的全部环节。

它的官方介绍:https://github.com/microsoft/appinsights-telemetry-flow

适用于 Azure Application Insights 的自助诊断脚本。

直接在运行您的应用程序的机器上,验证连接性、TLS、AMPLS/Private Link、数据引入、采样、工作区健康状况以及代理安装。

支持 PowerShell(Windows)和 Bash(Linux)。

遥测流程概览

从宏观层面来看,遥测数据从您的应用程序(或此诊断脚本)出发,依次流经以下阶段:

每个方框代表一个层,该层可能会独立发生故障、性能下降或静默丢失数据。脚本会从上到下测试每一层。

要详细了解每一层的功能、故障原因以及脚本如何检测故障,请参阅官方文档中的架构介绍部分: https://github.com/microsoft/appinsights-telemetry-flow/blob/main/docs/architecture.md , 本文主要是通过在中国区Azure的App Service上演示如何使用这个神级脚本:Test-AppInsightsTelemetryFlow.ps1

 

实际演示

第一步:登录App Service的Kudu站点( https://<your app service name>.scm.chinacloudsites.cn ),进入Debug Console Powershell

使用脚本尝试下载脚本Test-AppInsightsTelemetryFlow.ps1

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/microsoft/appinsights-telemetry-flow/main/powershell/Test-AppInsightsTelemetryFlow.ps1" -OutFile "Test-AppInsightsTelemetryFlow.ps1"

因为中国区Azure App Service的所在的环境访问github会出现连不上的情况,所以可以在一个稳定访问github的环境中下载这个脚本文件后,直接拖拽到App Service上或通过新建文件把脚本内容复制上去也可。


PS: 也可以从这里下载脚本文件:https://files.cnblogs.com/files/lulight/Test-AppInsightsTelemetryFlow.zip?t=1776861726&download=true


 

第二步:直接运行 .\Test-AppInsightsTelemetryFlow.ps1 并检查运行结果

执行  .\Test-AppInsightsTelemetryFlow.ps1  或者  .\Test-AppInsightsTelemetryFlow.ps1 -AutoApprove

然后进入Application Insights中查看 availabilityResults 中是否有数据

 

演示动画

 

 

参考资料

Application Insights Telemetry Flow Troubleshooters :https://github.com/microsoft/appinsights-telemetry-flow

 



当在复杂的环境中面临问题,格物之道需:浊而静之徐清,安以动之徐生。 云中,恰是如此!

相关文章
|
20天前
|
人工智能 数据可视化 安全
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
本文详解如何用阿里云Lighthouse一键部署OpenClaw,结合飞书CLI等工具,让AI真正“动手”——自动群发、生成科研日报、整理知识库。核心理念:未来软件应为AI而生,CLI即AI的“手脚”,实现高效、安全、可控的智能自动化。
34893 53
王炸组合!阿里云 OpenClaw X 飞书 CLI,开启 Agent 基建狂潮!(附带免费使用6个月服务器)
|
14天前
|
人工智能 自然语言处理 安全
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
本文介绍了Claude Code终端AI助手的使用指南,主要内容包括:1)常用命令如版本查看、项目启动和更新;2)三种工作模式切换及界面说明;3)核心功能指令速查表,包含初始化、压缩对话、清除历史等操作;4)详细解析了/init、/help、/clear、/compact、/memory等关键命令的使用场景和语法。文章通过丰富的界面截图和场景示例,帮助开发者快速掌握如何通过命令行和交互界面高效使用Claude Code进行项目开发,特别强调了CLAUDE.md文件作为项目知识库的核心作用。
13625 42
Claude Code 全攻略:命令大全 + 实战工作流(建议收藏)
|
10天前
|
人工智能 JavaScript Ubuntu
低成本搭建AIP自动化写作系统:Hermes保姆级使用教程,长文和逐步实操贴图
我带着怀疑的态度,深度使用了几天,聚焦微信公众号AIP自动化写作场景,写出来的几篇文章,几乎没有什么修改,至少合乎我本人的意愿,而且排版风格,也越来越完善,同样是起码过得了我自己这一关。 这个其实OpenClaw早可以实现了,但是目前我觉得最大的区别是,Hermes会自主总结提炼,并更新你的写作技能。 相信就冲这一点,就值得一试。 这篇帖子主要就Hermes部署使用,作一个非常详细的介绍,几乎一步一贴图。 关于Hermes,无论你赞成哪种声音,我希望都是你自己动手行动过,发自内心的选择!
2765 28
|
2天前
|
缓存 人工智能 自然语言处理
我对比了8个Claude API中转站,踩了不少坑,总结给你
本文是个人开发者耗时1周实测的8大Claude中转平台横向评测,聚焦Claude Code真实体验:以加权均价(¥/M token)、内部汇率、缓存支持、模型真实性及稳定性为核心指标。
|
1月前
|
人工智能 JSON 机器人
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
本文带你零成本玩转OpenClaw:学生认证白嫖6个月阿里云服务器,手把手配置飞书机器人、接入免费/高性价比AI模型(NVIDIA/通义),并打造微信公众号“全自动分身”——实时抓热榜、AI选题拆解、一键发布草稿,5分钟完成热点→文章全流程!
45807 158
让龙虾成为你的“公众号分身” | 阿里云服务器玩Openclaw
|
5天前
|
弹性计算 人工智能 自然语言处理
阿里云Qwen3.6全新开源,三步完成专有版部署!
Qwen3.6是阿里云全新MoE架构大模型系列,稀疏激活显著降低推理成本,兼顾顶尖性能与高性价比;支持多规格、FP8量化、原生Agent及100+语言,开箱即用。
|
8天前
|
人工智能 弹性计算 安全
Hermes Agent是什么?怎么部署?超详细实操教程
Hermes Agent 是 Nous Research 于2026年2月开源的自进化AI智能体,支持跨会话持久记忆、自动提炼可复用技能、多平台接入与200+模型切换,真正实现“越用越懂你”。MIT协议,部署灵活,隐私可控。
2086 4