跟踪和事件日志安全级别
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
使用统一日志记录系统 (ULS) API 定义事件或跟踪日志时,必须提供的一个值是 ULS 级别。级别是指示事件或跟踪严重性的设置,还用于限制以防止日志文件中出现大量重复信息。使用下列指南可以确定适当的级别以用于您的方案。
事件级别指南
在 Manifest.xml 文件中定义事件时,选择适当的严重性级别非常重要。事件的严重性级别显示在 Windows 事件日志中,由管理员使用并由监视工具注册以指示事件的严重或重要程度。选择适当的级别是您的组件或系统的运行状况和监视设计的重要部分。
有关事件清单架构的详细信息,请参阅事件架构
ULS 级别名称 |
级别 ID |
在事件日志中的显示名称 |
说明 |
严重错误 |
30 |
关键 |
要求系统管理员立即关注的事件。这些事件通常在全局(系统范围)级别(如系统或应用程序)发出。它们还可用于指示应用程序或系统已失败或停止响应。 |
错误 |
40 |
错误 |
指示问题的事件,但是所属类别不需要立即关注。 |
警告 |
50 |
警告 |
预先说明潜在问题的事件;尽管不是对实际错误做出的响应,但是警告指示组件或应用程序未处于理想状态并且一些进一步操作可能会导致关键错误。 |
信息 |
80 |
信息 |
向管理员传达非关键信息的事件,类似于"供您参考"之类的注释。 |
详细 |
100 |
信息 |
详细状态,如进度或成功消息。 |
跟踪级别指南
使用 ULS API 编写跟踪日志时,必须指定严重性级别。严重性级别显示在 ULS 跟踪日志中并且通常由报告或筛选工具使用。因此,选择适当的级别非常重要。
ULS 级别名称 |
级别 ID |
说明 |
意外 |
10 |
与 Assert(代码中对特定时间点条件为 true 的假设)类似,此消息指示逻辑检查失败(这是非典型情况),或者消息返回异常错误代码。这些通常表示应该调查并修复的代码错误。 |
可监控 |
15 |
指示问题的跟踪,但是不需要立即调查。目的是收集数据并在一段时间内进行分析,以了解问题趋势。 |
高 |
20 |
常规功能性详细信息,环境中发生的高优先级事件。示例包括全局配置修改、服务启动和停止、计时器作业完成等。 |
中 |
50 |
用于帮助支持或测试团队调试客户或环境问题。这些可能包括指示单个功能已成功或失败的消息,如创建新列表、修改页面等。 |
详细 |
100 |
主要用于帮助开发人员调试较低级别的代码故障。对无权访问源代码或符号的用户通常没有用。大多数不需要一直启用的事件跟踪都应该在详细级别进行设置。 |
VerboseEx |
200 |
用于可能包含大量信息(特别是并非所有调试方案都需要的信息)的跟踪。应该使用 VerboseEx 设置的情形示例为方法进入和退出事件、循环跟踪或中继对您的团队之外的开发人员无用的信息。 |