Setlogginglevel:Stsadm 操作 (Office SharePoint Server)

操作名称:Setlogginglevel

说明

针对服务器场中注册的一个或多个诊断日志记录类别,设置 Windows 事件日志和跟踪日志的日志记录级别。如果出现与某个类别关联的事件或跟踪,但其严重性级别低于该类别的日志级别,则事件或跟踪将不能写入到事件日志或跟踪日志中。如果出现与某个类别关联的事件或跟踪且其严重性级别等于(或高于)该类别的日志级别,则事件或跟踪将会写入到事件日志或跟踪日志中。

语法

stsadm.exe -o setlogginglevel

   [-category < [CategoryName | Manager:CategoryName [;...]] >]

   {-default |

   -tracelevel < trace level setting>

   [-windowslogginglevel] <Windows event log level setting>}

参数

参数名 是否必需 说明

category

唯一有效的值为 CategoryName 或 Manager: CategoryName

要设置的类别名称。如果未指定 category 参数,则事件限制设置将应用于服务器场中的所有类别。例如,当您希望将日志记录级别设置仅应用于一个或两个类别时使用此参数。

当多个诊断日志记录类别管理器注册相同的类别名称时使用 Manager:CategoryName 值。

Note注意:
Windows SharePoint Services 的诊断日志记录类别管理器为“SPDiagnosticsService”。 基于 Windows SharePoint Services 3.0 的第三方产品可能有自己的一个或多个诊断日志记录类别管理器。

default

<无>

否。请参阅“示例”部分。

将指定类别的跟踪日志记录级别和 Windows 事件日志记录级别设置回默认值。

tracelevel

包含以下任一值:

  • None(跟踪日志中将不写入任何跟踪事件)

  • Unexpected

  • Monitorable

  • High

  • Medium

  • Verbose

否。但是必须指定 default 参数或 tracelevel 参数。如果指定 tracelevel 参数,则也可以选择指定 windowslogginglevel 参数。

此设置控制将哪些条目记录在跟踪日志中。跟踪日志文件是写入到跟踪日志路径的文本文件,其中路径是在 SharePoint 管理中心网站的“诊断日志记录”页上定义的。

windowslogginglevel

包含以下任一值:

  • None(不向事件日志中写入任何事件)

  • ErrorServiceUnavailable

  • ErrorSecurityBreach

  • ErrorCritical

  • Error

  • Warning

  • FailureAudit

  • SuccessAudit

  • Information

  • Success

否。但是,如果使用 windowslogginglevel 参数设置事件日志条目,则还必须用一个有效值来指定 tracelevel 参数。但是,如果只使用 tracelevel 参数,则不需要 windowslogginglevel 参数。

控制是否将事件日志条目发送到在事件查看器中可见的应用程序日志。

ErrorServiceUnavailable、ErrorSecurityBreach 和 ErrorCritical 参数值在管理中心网站的“诊断日志记录”页上不可用。但是,这些值将会作为“Error”显示在用户界面中。

如果使用 Information 或 Success 值,则这两个值将作为“Information”显示在用户界面中。但是,如果选择用户界面中的“Information”,则在使用 listlogginglevels 操作时该值将显示为“Success”。

示例

对于此示例,我们使用类别名称“IRM”。

假设 IRM 出现了问题且不能确定原因。为了帮助进行疑难解答过程,您可以降低事件日志和跟踪日志的阈值,以便在这些日志中记录更多的事件和跟踪。在找到并解决问题之后,可以将日志记录的阈值重置为默认值。

若要将事件日志记录级别从“Error”降低到“Warning”,并将跟踪日志记录级别从“Medium”降低到“Verbose”,请使用以下语法:

stsadm -o setlogginglevel -category IRM -tracelevel verbose -windowslogginglevel warning

若要将日志记录的阈值重置回默认设置,请使用以下语法:

stsadm -o setlogginglevel -category IRM -default