日志和跟踪分析器的记录首选项

“记录首选项”窗口(窗口 > 首选项 > 记录)使您能够指定日志文件 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,则不记录任何消息。

要更改记录级别设置,请单击单元格并从下拉列表中选择新值,或者选择要更改的行并单击编辑

记录级别的顺序如下所示:

  1. ALL(记录所有信息)
        ALL 指示应该记录所有消息。
  2. FINEST(最低级别:记录大部分信息)
        FINEST 指示记录高度详细的跟踪消息。
  3. FINER
        FINER 指示记录相当详细的跟踪消息。
  4. FINE
        FINE 是一种提供跟踪信息的消息级别。
  5. CONFIG
        CONFIG 是一种用于静态配置消息的消息级别。
  6. INFO
        INFO 是一种用于参考消息的消息级别。
  7. WARNING
        WARNING 是一种指示潜在问题的消息级别。
  8. SEVERE(最高级别:记录最少的信息)
        SEVERE 是一种指示严重故障的消息级别。
  9. NONE(不进行记录)
        NONE 是一种可用于关闭记录的特殊级别。

例如,如果选择 WARNING,则将包括 SEVERE 消息,但不包括 INFO 消息。

注意:

相关任务
使用记录首选项窗口配置插件记录
使用 plugin.xml 文件配置插件记录