您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.
使用 Azure 诊断跟踪云服务(经典)应用程序的流
10/14/2020
本文内容
重要
Azure 云服务(外延支持)是 Azure 云服务产品基于 Azure 资源管理器的新型部署模型。 进行此更改后,在基于 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 提供的,则会自动添加侦听器的配置。
添加跟踪侦听器
打开针对角色的 web.config 或 app.config 文件。
将以下代码添加到文件。 更改 Version 属性,以使用引用的程序集的版本号。 除非有所更新,否则程序集的版本不一定随着每个 Azure SDK 发行版发生变化。
name="AzureDiagnostics">
重要
确保与 Microsoft.WindowsAzure.Diagnostics 程序集建立项目引用。 更新上述 xml 中的版本号,以便与引用的 Microsoft.WindowsAzure.Diagnostics 程序集的版本匹配。
保存 config 文件。
有关侦听器的详细信息,请参阅跟踪侦听器。
完成添加侦听器的步骤后,即可将 Trace 语句添加到代码中。
将 Trace 语句添加到代码中
打开应用程序的源文件。 例如用于辅助角色或 Web 角色的 .cs 文件。
添加以下 using 指令(如果尚未添加):
using System.Diagnostics;
添加 Trace 语句,以便捕获有关应用程序状态的信息。 可以使用多种方法来来格式化 Trace 语句的输出。 有关详细信息,请参阅如何:向应用程序代码添加 Trace 语句。
保存源文件。