2021年Azure Application Insights对PHP应用的支持情况咨询

核心问题答复 #

Azure 官方没有处于活跃维护状态的 PHP 官方 SDK，原有 2019 年停更的官方仓库确实存在构建失败、不兼容新版本 PHP 的问题，但你依然可以通过纯 PHP 代码的方式完成接入，完全满足「无法安装服务器模块、仅可使用 PHP 代码或当前目录上传文件」的限制，也不会影响现有业务功能。

可行接入方案 #

方案1：使用社区修复版本 #

原有官方 SDK 的社区 Fork 分支已经修复了构建异常、PHP 高版本兼容问题，你可以直接将代码下载后上传到应用根目录，无需安装任何扩展，通过手动引入类文件或者 Composer 本地引入即可使用。
该版本默认支持采集：

• 应用内所有入站 HTTP 请求的 URL、请求方式、耗时、状态码、用户标识等字段
• 第三方 API 调用的目标地址、请求参数、返回状态、错误信息等字段
• 可自定义埋点采集你需要的额外统计维度，所有数据会自动同步到公司现有的 Application Insights 实例中。

方案2：纯代码手动调用采集接口 #

如果你不想依赖第三方封装的 SDK，可以自己实现数据上报逻辑，零额外依赖：

• 从 Azure 控制台获取你的 Application Insights Instrumentation Key
• 封装独立的上报函数，按照 Azure 公开的采集协议组装需要上报的统计数据
• 使用 PHP 内置的curl或file_get_contents函数异步发送数据到 Azure 采集端点
  这种方式对现有业务的侵入性极低，你可以自主控制埋点范围和上报策略，完全不会修改原有业务的核心逻辑。

旧应用适配建议 #

• 埋点逻辑可以封装为公共函数，仅在原有 HTTP 请求、第三方调用的入口和出口处调用，无需修改核心业务代码
• 上线初期可以开启采样上报，比如仅上报 10% 的请求验证数据准确性，确认无异常后再全量开启，避免对现有业务性能产生影响
• 所有上报数据可以直接复用公司现有 Application Insights 的大盘、告警配置，无需额外搭建监控体系。

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