如何启用订阅日志记录进行故障排除

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

注意

对于本地Azure DevOps Server,请为团队成员配置 SMTP 服务器,以便从其组织或用户配置文件菜单中查看“通知”选项并接收通知。

对于某些活动,在按角色选择“团队成员”时,可以选择让启动活动的用户收到通知。 此通知由 “跳过发起程序 ”复选框控制。 默认情况下,此框处于选中状态,这意味着启动更改的用户不会收到有关更改的通知。

订阅日志记录是进行故障排除的有用工具。 该工具会提供来自通知管道的诊断信息,且默认情况下处于禁用状态。 启用后,最多可为订阅收集 25 个日志或 1 小时的日志。

先决条件

类别 要求
项目访问权限 项目成员.

启用订阅日志记录

若要启用订阅日志记录,请完成以下步骤:

  1. 通过在浏览器中输入以下 URL 为组织启用诊断:

    https://dev.azure.com/{organization}/_notifications?diagnostics=true

  2. “启用诊断”选项显示在订阅上下文菜单中。

屏幕截图显示了已启用的订阅日志记录。

查看用于事件匹配的订阅诊断日志

通过在浏览器中输入以下 URL 获取所有订阅事件日志:

https://dev.azure.com/{organization}/_apis/notification/DiagnosticLogs/{event ID}/entries?startTime={date}&endTime={date}

  • 组织 是组织(例如,dev.azure.com/fabrikam-fiber)
  • date 是日期时间规范(例如, 2018-06-292018-06-29 02:00
  • 事件 ID915f48f2-1b64-40d9-a43f-fe2528b4f296 ,或
  • 事件 ID9a688110-9e33-4cdc-affd-75d16303e7f1 ,或
  • 事件 ID任何其他事件类型的 a4804dcf-4bb6-4109-b61c-e59c2e8a9ff7

结果是 JSON 格式的日志记录信息。

查看通知传递的订阅诊断日志

通过在浏览器中输入 URL,检索给定时间范围内的所有通知传送日志。

https://dev.azure.com/{organization}/_apis/notification/DiagnosticLogs/{event ID}/entries?startTime={date}&endTime={date}

  • 组织 是组织(例如,dev.azure.com/fabrikam-fiber)
  • date 是日期时间规范(例如, 2018-06-292018-06-29 02:00
  • 事件 ID631f49b3-46e1-42ec-8fff-081bd176c18a ,或
  • 事件 ID8833fc71-42ca-441b-ab12-253148777772d,
  • 事件 ID任何其他事件类型的 a96d6177-beef-477a-a2ee-2c31433214d0

结果是 JSON 格式的日志记录信息。