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

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

注意

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

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

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

启用订阅日志记录

重要

TFS 2018 Update 2 和 TFS 2018 Update 3 中存在已知问题,其中为默认 globe 订阅启用订阅日志记录可能会导致通知传递出现问题。 如果使用的是这两个版本之一,建议不要为默认订阅启用订阅日志记录。

完成以下步骤以启用订阅日志记录:

  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 格式的日志记录信息。