如何在Azure DevOps槽交换前实时检测运行中的Azure Functions

环境说明 #

• Azure Function App：启用公网访问但仅允许Azure DevOps流量，配置私有端点
• Application Insights：与Function App同VNet，配置私有端点且禁用公网访问
• 权限：拥有订阅级Reader权限的服务主体

已尝试方案及问题 #

• KUDU API（进程管理器）：专用计划下始终存在运行进程，但无法区分对应活跃Function执行的进程
• Application Insights API：使用GET请求（仅Reader权限）时触发权限错误，不符合预期权限范围
• Azure Monitor Metrics：查询FunctionExecutionCount指标始终返回0，与实际运行状态不符
• 调用日志：存在约5分钟延迟，无法满足实时检测需求

可行解决方案建议 #

1. 调用Azure Functions管理API查询实例状态 #

使用Azure资源管理API查询指定Function的运行实例：

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{functionAppName}/functions/{functionName}/instances?api-version=2023-01-01

通过服务主体进行身份验证，API会返回该Function的所有运行实例信息，包括实例是否处于活跃执行状态。需确认服务主体拥有Microsoft.Web/sites/functions/instances/read权限（订阅级Reader权限通常包含该权限，若缺失需补充）。

2. 自定义健康检查端点 #

在Function App中添加一个HTTP触发的健康检查函数，自定义逻辑返回当前Function的执行状态（例如检查正在处理的请求数、绑定的队列长度等）。由于Function App允许Azure DevOps流量，流水线可直接调用该端点获取实时状态，延迟极低且灵活性强。

3. Azure Monitor实时日志查询 #

利用Log Analytics的实时查询能力，针对Function的FunctionAppLogs或AppServiceHTTPLogs查询最近1分钟内的执行记录。确保服务主体拥有对应Log Analytics工作区的Reader权限，将查询时间范围设为最近1分钟，可大幅降低延迟。

4. Azure CLI实时状态与日志检查 #

• 使用Azure CLI命令查看Function App的基础状态与请求队列：

  az functionapp show --name <functionAppName> --resource-group <resourceGroupName>
  az functionapp config show --name <functionAppName> --resource-group <resourceGroupName>
  

  若请求队列存在待处理项，说明Function正在运行或即将执行。
• 实时查看日志输出：

  az webapp log tail --name <functionAppName> --resource-group <resourceGroupName>
  

  日志延迟远低于5分钟，可辅助判断实时执行状态。

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