Azure Pipelines Tasks项目中Azure PowerShell任务遥测数据问题分析

问题背景

在Azure DevOps的CI/CD流程中，Azure PowerShell任务是常用的任务类型之一，用于执行Azure资源管理操作。近期发现该任务的遥测数据收集存在异常，导致无法通过ADO查询到相关使用数据。

问题现象

当使用Azure PowerShell任务(版本12.2.0)时，系统无法正确记录任务的遥测数据。经排查发现，这是由于Azure PowerShell模块依赖的环境变量AZUREPS_HOST_ENVIRONMENT未被正确设置所致。

技术分析

Azure PowerShell模块通过特定的环境变量来识别运行环境并收集遥测数据。在Azure DevOps环境中，需要设置以下两个关键环境变量：

1. AZURE_HTTP_USER_AGENT
2. AZUREPS_HOST_ENVIRONMENT

这些变量用于标识任务运行环境，以便Azure PowerShell模块能够正确分类和上报遥测数据。当前实现中，Azure PowerShell任务未能正确设置AZUREPS_HOST_ENVIRONMENT变量，导致数据收集链路中断。

影响范围

该问题影响所有使用Azure PowerShell任务的环境，包括：

• 自托管代理
• Microsoft托管代理
• VMSS池
• 容器环境

解决方案

开发团队已针对此问题进行了修复，主要变更包括：

1. 在任务执行前正确设置AZUREPS_HOST_ENVIRONMENT环境变量
2. 确保AZURE_HTTP_USER_AGENT变量也被正确设置
3. 优化了环境变量设置的时机和逻辑

修复后的版本会在任务日志中显示类似以下内容，表明遥测数据已正确上报：

AzurePowershell/Az0.0.0 ADO_AzurePowerShell_v5_Windows_NT_Agent3-WEUP-VSTSB01_DevOps - ServiceBus Notifications_430126__

验证与确认

用户可以通过以下方式验证修复效果：

1. 检查任务执行日志中是否包含环境变量设置的相关信息
2. 确认ADO中能够查询到Azure PowerShell任务的遥测数据
3. 观察任务执行过程中是否出现与遥测相关的错误信息

总结

遥测数据对于理解任务使用情况和优化产品体验至关重要。此次修复确保了Azure PowerShell任务在Azure DevOps环境中的遥测数据能够被正确收集和上报。建议用户及时更新到包含此修复的任务版本，以获得完整的功能体验和数据可见性。