为 Azure 云服务（外延支持）和虚拟机设置诊断

注意

本文适用于 Azure Azure 云服务（外延支持）。 云服务（经典）将于 2024 年 8 月 31 日停用。 有关详细信息，请参阅云服务（经典）部署模型将于 2024 年 8 月 31 日停用。 对于新开发，我们建议使用专为特定目的设计的较新服务类型，例如 Azure 应用服务、Azure Functions 或 Azure 容器应用。 有关可用服务的最新列表，请参阅 Azure 产品的目录。

需要对 Azure 云服务（外延支持）服务或虚拟机进行故障排除时，可使用 Visual Studio 更轻松地设置 Azure 诊断。 诊断可以在运行云服务的虚拟机和虚拟机实例上捕获系统数据和日志记录数据。 诊断数据传输到所选的存储帐户。 有关 Azure 中诊断日志记录的详细信息，请参阅为 Azure 应用服务中的 Web 应用启用诊断日志记录。

在本文中，我们将介绍如何使用 Visual Studio 打开和设置 Azure 诊断。 了解如何在 Azure 虚拟机上设置诊断、如何选择要收集的诊断信息的类型，以及如何在收集信息后查看这些信息。

要设置 Azure Diagnostics，请在 Visual Studio 的诊断配置对话框中更改诊断设置。 这些设置会保存在名为 diagnostics.wadcfgx 的文件中。 还可直接修改配置文件。 如果手动更新文件，则配置更改在下次将云服务部署到 Azure 或在模拟器中运行该服务时生效。

警告

在 Visual Studio 2022 中，调试云服务项目时，弃用的Azure 存储模拟器已替换为 Azurite 模拟器。 此 Azurite 模拟器不与 Azure 诊断插件一起使用，后者将在进行本地运行和测试时为 Azure 诊断提供支持。 如果需要用于本地运行和测试方案的插件，可以将本地服务配置 (.cscfg) 中的连接字符串更新为 Azure 存储帐户（请参阅管理存储帐户的连接字符串），或下载以前的 Azure 存储模拟器。 在 Visual Studio 17.10 版本中，本地 Azure 诊断插件即将弃用并将默认禁用（但带有启用选项）。 该插件已在 Visual Studio 17.11 中删除。 此插件仅可与本地 Azure 计算模拟器一起使用，其禁用不会影响采用了 Azure 中的 Azure 诊断扩展的已部署云服务。 若要在 Visual Studio 17.10 中启用诊断插件，请将以下属性设置添加到 <EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin> 项目文件中的任意 PropertyGroup 内。

Visual Studio 如何确定诊断存储帐户

• 如果在 .cscfg 文件中指定了诊断连接字符串，Visual Studio 会在发布时以及在打包过程中生成公共配置 XML 文件时使用它来设置诊断扩展。
• 如果未在 .cscfg 文件中指定诊断连接字符串，Visual Studio 会在发布时以及在打包过程中生成公共配置 XML 文件时回退到使用 .wadcfgx 文件中指定的存储帐户来设置诊断扩展。
• .cscfg 文件中的诊断连接字符串优先于 .wadcfgx 文件中的存储帐户。 如果在 .cscfg 文件中指定了诊断连接字符串，Visual Studio 会使用该连接字符串，而忽略 .wadcfgx 中的存储帐户。

“更新开发存储连接字符串...”复选框的作用是什么？

有了在发布到 Microsoft Azure 时使用 Microsoft Azure 存储帐户凭据更新诊断和缓存的开发存储连接字符串复选框，就可以方便地使用发布过程中指定的 Azure 存储帐户更新任何开发存储帐户连接字符串。 将项目发布到 Azure 时，Visual Studio 将自动使用发布向导中指定的存储帐户更新诊断连接字符串。 但是，如果已将实际的存储帐户指定为诊断连接字符串，则会改用该帐户。

设置诊断数据源

启用了诊断数据收集后，可以准确地选择要收集的数据源以及收集哪些信息。 后续部分介绍“诊断配置”对话框中的选项卡，以及每个配置选项的含义。

应用程序日志

应用程序日志包含由 Web 应用程序生成的诊断信息。 如果要捕获应用程序日志，请选中启用应用程序日志的传输复选框。 若要增加或减少将应用程序日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。 还可以更改日志中捕获的信息量，方法是设置“日志级别”值。 例如，选择“详细”以获取更多信息，或选择“关键”以仅捕获关键错误。 如果使用特定诊断提供程序来传输应用程序日志，则可通过将提供程序的全局唯一标识符 (GUID) 添加到“提供程序 GUID”框中来捕获这些日志。

有关应用程序日志的详细信息，请参阅在 Azure 应用服务中启用 Web 应用的诊断日志记录。

Windows 事件日志

若要捕获 Windows 事件日志，请选中启用 Windows 事件日志的传输复选框。 若要增加或减少将事件日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。 选中与要跟踪的事件类型对应的复选框。

如果要指定自定义数据源，请在<数据源名称>文本框中输入它，然后选择添加。 该数据源将添加到 diagnostics.cfcfg 文件中。

性能计数器

性能计数器信息可以帮助找到系统瓶颈，并优化系统和应用程序性能。 有关详细信息，请参阅在 Azure 应用程序中创建和使用性能计数器。 若要捕获性能计数器，请选中启用性能计数器的传输复选框。 若要增加或减少将事件日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。 选中与要跟踪的性能计数器对应的复选框。

若要跟踪未列出的性能计数器，请使用建议的语法输入该性能计数器， 然后选择添加。 虚拟机上的操作系统确定可以跟踪哪些性能计数器。有关语法详细信息，请参阅指定计数器路径。

基础结构日志

基础结构日志包含的信息涉及 Azure 诊断基础结构、RemoteAccess 模块和 RemoteForwarder 模块。 若要收集有关基础结构日志的信息，请选中启用基础结构日志的传输复选框。 若要增加或减少将基础结构将日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。

有关详细信息，请参阅使用 Azure 诊断收集日志记录数据。

日志目录

日志目录包含从 Internet Information Services (IIS) 请求、失败的请求或所选文件夹的日志目录收集的数据。 若要捕获日志目录，请选中启用日志目录的传输复选框。 若要增加或减少将日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。

选中要收集的日志（如 IIS 日志和失败的请求日志）对应的复选框。 虽然系统提供了默认的存储容器名称，但是可以更改这些名称。

可以从任何文件夹捕获日志。 在“从绝对目录记录”部分指定路径，然后选择“添加目录”。 这些日志将捕获到指定的容器中。

ETW 日志

如果使用 Windows 事件跟踪 (ETW) (ETW)，并要捕获 ETW 日志，请选中启用 ETW 日志的传输复选框。 若要增加或减少将日志传输到存储帐户的时间间隔，请更改“传输周期(分钟)”值。

将从指定的事件源和事件清单捕获事件。 若要指定事件源，请在“事件源”部分输入名称，然后选择“添加事件源”。 同样，可以在“事件清单”部分指定事件清单，然后选择“添加事件清单”。

ASP.NET 通过 System.Diagnostics.aspx 命名空间中的类支持 ETW 框架。 Microsoft.WindowsAzure.Diagnostics 命名空间继承自标准 System.Diagnostics.aspx 类并对其进行了扩展，在 Azure 环境中，可以通过该命名空间将 System.Diagnostics.aspx 用作日志记录框架。 有关详细信息，请参阅在 Microsoft Azure 中控制日志记录和跟踪以及在 Azure 云服务（外延支持）和虚拟机中启用诊断。

故障转储

若要捕获有关角色实例何时崩溃的信息，请选中启用崩溃转储的传输复选框。 （由于 ASP.NET 处理大多数异常，因此这通常仅适用于辅助角色。）若要增加或减少专用于故障转储的存储空间百分比，请更改目录配额(%)) 值。 可以更改将故障转储存储到其中的存储容器，然后选择要捕获“完整”转储还是“微型”转储。

下一屏幕截图列出了当前跟踪的进程。 选中与要捕获的进程对应的复选框。 若要将另一进程添加到列表，请输入进程名称，然后选择“添加进程”。

有关详细信息，请参阅在 Microsoft Azure 中控制日志记录和跟踪。

排查 Azure 云服务（外延支持）问题

如果在处理云服务项目时遇到问题，例如陷入“繁忙”状态的某个角色反复回收或引发内部服务器错误，则可以使用一些工具和方法来诊断并解决问题。 有关常见问题和解决方案的具体示例，以及用于诊断并解决此类错误的概念和工具的概述，请参阅 Azure 平台即服务 (PaaS) 计算诊断数据。

问答

什么是缓冲区大小，应设置为多大？

在每个虚拟机实例上，“配额”限制了本地文件系统上可以存储的诊断数据量。 另外，请指定每类可用诊断数据的缓冲区大小。 此缓冲区大小的作用类似于该类数据的单独配额。 若要确定整体配额和剩余内存量，请查看对话框的底部，了解诊断数据类型。 指定的缓冲区越大、数据类型越多，便越接近整体配额。 可以通过修改 diagnostics.wadcfgx 配置文件更改整体配额。 诊断数据与应用程序的数据存储在同一文件系统上。 如果应用程序占用大量的磁盘空间，则不应增加整体诊断配额。

什么是传输周期，应设置为多长？

传输周期是两次数据捕获之间经过的时间长度。 在每个传输周期后，数据都会从虚拟机上的本地文件系统移到存储帐户的表中。 如果在传输周期结束之前，收集的数据量已经超出了配额，将放弃较早数据。 如果数据由于超出缓冲区大小或整体配额而丢失，则可能需要缩短传输周期。

时间戳使用哪个时区？

时间戳使用托管云服务的数据中心的本地时区。 使用日志表中的以下三个时间戳列：

• PreciseTimeStamp：事件的 ETW 时间戳。 即，从客户端记录事件的时间。
• TIMESTAMP：已向下舍入到上传频率边界的 PreciseTimeStamp 的值。 例如，如果上传频率为 5 分钟，事件时间为 00:17:12，则 TIMESTAMP 为 00:15:00。
• Timestamp：在 Azure 表中创建实体时的时间戳。

收集诊断信息时，如何管理开销？

默认设置（“日志级别”设置为“错误”，“传输周期”设置为“1 分钟”）设计为尽量减少开销。 收集的诊断数据越多，或者传输周期越短，计算开销便越大。 不要收集超过所需的数据，不再需要数据收集时务必禁用它。 始终可以再次启用该功能，即使在运行时也是如此，如本文前面所述。

如何从 IIS 收集失败请求的日志？

默认情况下，IIS 不收集失败请求的日志。 可以通过编辑 Web 角色的 web.config 文件，将 IIS 设置为收集失败的请求的日志。

我无法从 OnStart 等 RoleEntryPoint 方法中获取跟踪信息。 为什么会这样？

RoleEntryPoint 的方法在 WAIISHost.exe 上下文而非 IIS 中调用。 web.config 中通常会启用跟踪的配置信息在此不适用。 若要解决此问题，请向 Web 角色项目添加一个 .config 文件，并使其名称匹配包含 RoleEntryPoint 代码的输出程序集。 在默认 Web 角色项目中，.config 文件的名称应为 WAIISHost.exe.config。请将以下行添加到此文件：

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

在“属性”窗口中，将“复制到输出目录”属性设置为“始终复制”。

相关内容

若要详细了解 Azure 中的诊断日志记录，请参阅在 Azure 云服务（外延支持）和虚拟机中启用诊断和在 Azure 应用程序服务中启用 Web 应用的诊断日志记录。