Application Insights 中的工作项集成使你可以直接从遥测数据创建和链接工作项。 如果此功能未按预期工作,以下指南可帮助你诊断和解决常见问题。
“创建工作项”选项不会显示在事务详细信息中
如果未看到创建工作项的选项,则可能未启用集成,或者资源未链接到 Azure DevOps 或 GitHub。
怎么办:
- 在 Application Insights 中,导航到 “工作项”,并验证是否已配置集成设置。
- 从 “创建工作项 流”启动该过程,或使用工作簿模板。
本地 Azure DevOps URL 被拒绝
如果 URL 格式不符合验证要求,则会出现此问题。
怎么办:
- 确保 URL 使用 HTTPS 协议,并匹配工作簿参数中的验证规则。
- 如果使用自承载的 Azure DevOps 实例,请确保可从 Azure 门户访问它。
授权提示未显示或链接失败
如果未看到授权提示,或者链接失败,原因可能是弹出阻止程序或缓存令牌。
怎么办:
- 禁用弹出窗口阻止程序,并允许浏览器中的第三方 Cookie。
- 清除浏览器缓存,然后重试链接。
- 如果使用 OAuth,请验证是否授予了必要的权限范围。
工作项创建失败并返回权限错误
权限错误通常表示帐户在 Azure DevOps 或 GitHub 中没有足够的权限。
怎么办:
- 对于 Azure DevOps,请确保你具有 “参与” 权限。
- 对于 GitHub,请确认你对存储库具有 写入 访问权限。
- 如果使用个人访问令牌(PAT),请确保它包含 工作项(读/写权限) 范围。
模板不会加载或保存
此问题通常因区域限制或缺少权限而发生。
怎么办:
- 验证区域是否支持 Microsoft.Insights/workbooks 资源类型。
- 检查资源提供程序是否已在订阅中注册。
- 分配 Microsoft.Insights/workbooks/write 角色,或尝试在受支持的区域中保存模板。
创建的工作项缺少上下文数据
如果工作项不包含预期数据,Kusto 查询语言 (KQL) 查询可能不会返回正确的架构。
怎么办:
- 在 日志 中运行查询以验证输出字段。
- 更新查询或绑定以匹配预期的架构。
模板对其他用户不可见
如果模板保存为专用,或者基于角色的访问控制(RBAC)权限不足,则通常会出现此问题。
怎么办:
- 确保模板存储在共享资源组中,而不是另存为 “我的报表”。
- 至少授予其他用户对资源的 阅读者 访问权限。
删除模板不会删除现有链接
删除工作簿不会自动清除缓存的配置。
怎么办:
- 刷新 Application Insights 中的 “工作项 ”窗格或清除浏览器缓存。
- 如果链接仍然存在,请在资源设置中手动取消链接它们。
GitHub 问题或 Azure DevOps 项在错误的存储库或项目中打开
如果默认存储库或组织 URL 不正确或多个模板替代设置,则会出现此问题。
怎么办:
- 打开工作簿,并验证默认存储库或组织 URL 参数。
- 删除或更新冲突的模板。
联系我们以获得帮助
如果有疑问,可以询问 Azure 社区支持。 您还可以向Azure反馈社区提交产品反馈。
第三方联系人免责声明
Microsoft 会提供第三方联系信息来帮助你查找有关本主题的其他信息。 该联系信息可能会在不通知的情况下更改。 Microsoft 不保证第三方联系信息的准确性。