为 Azure 云服务和虚拟机设置诊断

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

本文介绍如何在部署前和部署后使用 Visual Studio 来启用和设置 Azure 诊断。 了解如何在 Azure 虚拟机上设置诊断、如何选择要收集的诊断信息的类型，以及如何在收集信息后查看这些信息。

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

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

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

有了在发布到 Microsoft Azure 时使用 Microsoft Azure 存储帐户凭据更新诊断和缓存的开发存储连接字符串复选框，就可以方便地使用发布过程中指定的 Azure 存储帐户更新任何开发存储帐户连接字符串。

例如，如果选择此复选框且诊断连接字符串指定了 UseDevelopmentStorage=true，则在将项目发布到 Azure 时，Visual Studio 会通过发布向导中的指定存储帐户自动更新诊断连接字符串。 但是，如果已将实际的存储帐户指定为诊断连接字符串，则会改用该帐户。

部署前在云服务项目中启用诊断

在 Visual Studio 中，可以为运行在 Azure 中的角色收集诊断数据，前提是部署前在模拟器中运行了服务。 在 Visual Studio 中对诊断设置所做的任何更改都将保存在配置文件 diagnostics.cscfg 中。 这些设置指定一个存储帐户，方便你在部署云服务时将诊断数据保存到该帐户。

部署前在 Visual Studio 中启用诊断

1. 在角色的快捷菜单中，选择“属性”。 在角色的属性对话框中，选择配置选项卡。

2. 在诊断部分中，确保选中启用诊断复选框。

   

3. 若要为诊断数据指定存储帐户，请选择省略号 (…) 按钮。

   

4. 在“创建存储连接字符串”对话框中，指定在需要进行连接时，是使用 Azure 存储模拟器、Azure 订阅还是手动输入的凭据。

   

   • 如果选择“Microsoft Azure 存储模拟器”，则连接字符串设置为 UseDevelopmentStorage=true。
   • 如果选择“你的订阅”，则可选择要使用的 Azure 订阅，然后输入帐户名称。 若要管理 Azure 订阅，请选择“管理帐户”。
   • 如果选择“手动输入的凭据”选项，则请输入要使用的 Azure 帐户的名称和密钥。

5. 若要查看“诊断配置”对话框，请选择“配置”。 每个选项卡（“常规”和“日志目录”除外）都表示可以收集的诊断数据源。 默认的“常规”选项卡提供以下诊断数据收集选项：“仅限错误”、“所有信息”和“自定义计划”。 默认的仅限错误选项占用最少量的存储，因为该选项不传输警告或跟踪消息。 “所有信息”选项传输的信息最多，占用最多的存储，因此是成本最高的选项。

   注意

   “磁盘配额 (MB)”支持的最小大小为 50 MB，默认大小为 4 GB。 但是，如果要收集内存转储，请将此限制提高到更高值（如 10 GB）。

   

6. 对于此示例，请选择“自定义计划”选项，以便自定义所收集的数据。

7. 在“磁盘配额(MB)”框中，可以设置需要在存储帐户中为诊断数据分配的空间量。 可以更改或接受默认值。

8. 在要收集的诊断数据的每个选项卡上，选中启用<日志类型>的传输复选框。 例如，如果要收集应用程序日志，请在应用程序日志选项卡上选中启用应用程序日志的传输复选框。 另外，请指定每种诊断数据类型所需的其他任何信息。 有关每个选项卡的配置信息，请参阅本文后面的“设置诊断数据源”部分。

9. 启用收集所需的所有诊断数据后，请选择确定。

10. 照常在 Visual Studio 中运行 Azure 云服务项目。 当使用应用程序时，启用的日志信息将保存到指定的 Azure 存储帐户中。

设置诊断数据源

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

应用程序日志

应用程序日志包含由 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 应用的诊断日志记录。