日志和跟踪分析器的记录首选项
“记录首选项”窗口(窗口 > 首选项 > 记录)使您能够指定日志文件
CommonBaseEvents.xml(位于 workspace/.metadata 目录)中记录的消息级别,这些消息由产品插件写入该日志文件。它还使您能够设置在删除已归档的日志文件之前要经过的天数。
插件开发者通常会对此日志文件感兴趣。每次启动工作台时,将创建新的 CommonBaseEvents.xml 文件,并将对以前的 CommonBaseEvents.xml 文件进行归档。
记录首选项页包含以下选项卡:常规和记录器。
常规记录首选项选项卡
此选项卡显示工作台缺省记录选项,并且包含下列字段:
- 缺省记录级别
-
这是应用于所有记录器的缺省记录级别(除非已经在记录器选项卡上设置了特定的记录级别;请参阅下面的内容)。缺省级别由 com.ibm.etools.common.logging.commonLoggingDefaultOptions 扩展点指定,并且初始
设置为 NONE。
只有记录级别等于或高于所选记录级别的消息才会记录到 CommonBaseEvents.xml 文件中。如果选择 NONE,则不记录任何消息。有关更多详细信息,
请参阅记录级别设置的记录级别信息的顺序。
- 已归档文件的天数
- 设置在删除已归档日志文件前要经过的天数。缺省值为 7 天。如果指定天数为 0,则不会删除已归档文件。每次启动
工作台时,将创建已归档日志文件以存储来自上一会话的记录信息。
已归档文件名称的格式为 CommonBaseEventstimestamp.xml,其中,timestamp 是标准 JavaTM 时间戳记(对文件进行归档时的准确时间与全球标准时间(UTC)1970 年 1 月 1 日午夜之间的时间间隔,以毫秒计)。例如,2002 年 6 月 6 日美国东部时间上午 11 点 30 分 20 秒归档的文件的名称为 CommonBaseEvents1023377420784.xml。
记录器记录首选项选项卡
记录器选项卡显示实现由 com.ibm.etools.common.logging 插件定义的 com.ibm.etools.common.logging.commonLoggingOptions 扩展点的插件。
该表包含以下各列:
- 记录器名称
- 由 commonLoggingOptions 扩展点指定的记录器名称。如果未指定任何名称,则将使用 com.ibm.etools.common.logging.commonLoggingDefault 扩展点定义的缺省记录名称。
- 记录级别
- 由 commonLoggingOptions 扩展点指定的记录级别。在记录级别上,详细程度等于或低于指定级别的消息将被记录在
日志文件中。也就是说,记录级别越高,记录的信息量就越少。只有记录级别等于或高于所选记录级别(即,由
loggingOptions 扩展点指定的记录级别)的消息才会记录在 CommonBaseEvents.xml
文件中。如果所选级别为 NONE,则不记录任何消息。
要更改记录级别设置,请单击单元格并从下拉列表中选择新值,或者选择要更改的行并单击编辑。
记录级别的顺序如下所示:
- ALL(记录所有信息)
ALL 指示应该记录所有消息。
- FINEST(最低级别:记录大部分信息)
FINEST 指示记录高度详细的跟踪消息。
- FINER
FINER 指示记录相当详细的跟踪消息。
- FINE
FINE 是一种提供跟踪信息的消息级别。
- CONFIG
CONFIG 是一种用于静态配置消息的消息级别。
- INFO
INFO 是一种用于参考消息的消息级别。
- WARNING
WARNING 是一种指示潜在问题的消息级别。
- SEVERE(最高级别:记录最少的信息)
SEVERE 是一种指示严重故障的消息级别。
- NONE(不进行记录)
NONE 是一种可用于关闭记录的特殊级别。
例如,如果选择 WARNING,则将包括 SEVERE 消息,但不包括 INFO 消息。
- 注意:
- 则将使用由 com.ibm.etools.common.logging.commonLoggingDefault 的缺省记录级别并且该缺省记录级别与常规选项卡上设置的相同。
- 如果在以前的工作台会话中为插件设置了记录级别,则将使用该级别。
相关任务
使用记录首选项窗口配置插件记录
使用 plugin.xml 文件配置插件记录
(C) Copyright IBM Corporation 2000, 2006. All Rights
Reserved.