你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure 诊断跟踪云服务（经典）应用程序的流

  • 项目

重要

新客户的云服务（经典版）现已弃用，并将于 2024 年 8 月 31 日对所有客户停用。 新部署应使用基于 Azure 资源管理器的新型部署模型 Azure 云服务（外延支持）。

跟踪是在应用程序运行时监视其执行情况的一种方式。 可以使用 System.Diagnostics.Trace、System.Diagnostics.Debug 和 System.Diagnostics.TraceSource 类在日志、文本文件或其他设备中记录与错误及应用程序执行情况相关的信息，供以后进行分析。 有关跟踪的详细信息，请参阅跟踪和检测应用程序。

使用 Trace 语句和 Trace 开关

在云服务应用程序中实施跟踪时，可以将 DiagnosticMonitorTraceListener 添加到应用程序配置中，并在应用程序代码中调用 System.Diagnostics.Trace 或 System.Diagnostics.Debug。 对辅助角色使用配置文件 app.config，对 Web 角色使用配置文件 web.config。 使用 Visual Studio 模板创建新的托管服务时，系统会针对你所添加的角色将 Azure 诊断自动添加到项目中，并将 DiagnosticMonitorTraceListener 添加到相应的配置文件中。

有关如何放置 Trace 语句的信息，请参阅如何：向应用程序代码添加 Trace 语句。

可以将 Trace 开关放置到代码中，从而控制是否进行跟踪以及跟踪的范围。 这样即可在生产环境中监视应用程序的状态。 这在业务应用程序中特别重要，因为业务应用程序会在多个计算机中使用多个运行的组件。 有关详细信息，请参阅如何：配置 Trace 开关。

在 Azure 应用程序中配置跟踪侦听器

Trace、Debug 和 TraceSource 都要求设置“侦听器”来收集和记录已发送的消息。 侦听器将收集、存储和路由跟踪消息。 它们会将跟踪输出传输到适当的目标，如日志、窗口或文本文件。 Azure 诊断使用 DiagnosticMonitorTraceListener 类。

完成以下过程之前，必须初始化 Azure 诊断监视器。 若要执行此操作，请参阅在 Microsoft Azure 中启用诊断。

请注意，如果使用的模板是 Visual Studio 提供的，则会自动添加侦听器的配置。

添加跟踪侦听器

  1. 打开针对角色的 web.config 或 app.config 文件。

  2. 将以下代码添加到文件。 更改 Version 属性，以使用引用的程序集的版本号。 除非有所更新，否则程序集的版本不一定随着每个 Azure SDK 发行版发生变化。

    <system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>

    重要

    确保与 Microsoft.WindowsAzure.Diagnostics 程序集建立项目引用。 更新上述 xml 中的版本号，以便与引用的 Microsoft.WindowsAzure.Diagnostics 程序集的版本匹配。

  3. 保存 config 文件。

有关侦听器的详细信息，请参阅跟踪侦听器。

完成添加侦听器的步骤后，即可将 Trace 语句添加到代码中。

将 Trace 语句添加到代码中

  1. 打开应用程序的源文件。 例如，用于辅助角色或 Web 角色的 <RoleName>.cs 文件。
  2. 添加以下 using 指令（如果尚未添加）：
        using System.Diagnostics;
  3. 添加 Trace 语句，以便捕获有关应用程序状态的信息。 可以使用多种方法来来格式化 Trace 语句的输出。 有关详细信息，请参阅如何：向应用程序代码添加 Trace 语句。
  4. 保存源文件。