test

Sun Java System Portal Server 7.1 管理指南

第 8 章 管理 Portal Server 日志记录

本章说明如何获得 Sun JavaTM System Portal Server 日志信息。

本章包含以下部分：

了解 Portal Server 日志记录

Portal Server 支持在所有组件间进行日志记录。不同门户组件的日志和日志配置是统一的。有七种标准日志级别，范围从严重到轻微。日志可被发送至不同的文件或数据接收装置，并可包括单个或多个文件，即每个组件对应一个文件。

可为每个模块和子模块设置日志级别，并可针对每个组件内的每个模块和子模块，将日志发送到各自的文件。

管理 Portal Server 日志记录

您可以使用以下组件设置和管理 Portal Server 日志记录：

您可以通过门户管理控制台管理门户日志记录。

Procedure管理日志查看器

  1. 登录到 Portal Server 管理控制台。

  2. 选择 "Portal" 选项卡。

  3. 在 "Portal" 下选择一个门户服务器。

  4. 单击“记录”，然后单击子菜单中的“日志查看器”。

  5. 从“实例名称”下拉菜单，选择一个门户实例。

    将显示日志查看器的“搜索条件”和“搜索结果”页面。

  6. 输入“搜索条件”的值，然后单击“搜索”。

    可用的搜索选项如下：

    日志文件名

    有日志内容的文件名。

    日志级别

    选定级别或更高级别的消息会在日志中显示。可用的级别有 SEVERE、WARNING、INFO、CONFIG、FINE、FINER 和 FINEST。默认的级别为 INFO，因此日志将包含 INFO、WARNING 和 SEVERE 级别的消息。

    要确保您想要查看的消息在日志中显示，请首先在“特定记录器设置”页面设置相应的日志级别。

    时间戳

    显示特定时间段的日志消息。

    您可以查看最近 100 条日志条目，或在“从”和“到”文本框中键入时间段。

    如果您选择了“特定范围”：

    • “起始日期”和“终止日期”均为必填值

    • “起始日期”不能迟于“终止日期”

    • “终止日期”不能迟于当天日期

    • “起始时间”和“终止时间”值为可选。如果已指定“起始时间”值，则必须指定“终止时间”值。“时间”值的语法格式必须为 hh:mm:ss.SSS。SSS 表示毫秒。例如，18:20:10.000

等同的 psadmin 命令

psadmin set-logger

Procedure自定义日志显示

您可以使用以下步骤自定义“搜索结果”页面：

  1. 登录到 Portal Server 管理控制台。

  2. 选择 "Portal" 选项卡。

  3. 在 "Portal" 下选择一个 Portal Server。

  4. 单击“记录”，然后从“实例名称”下拉菜单选择一个门户服务器。

  5. 在“日志查看器结果”表格中，单击“时间戳”列标题以排序消息。

  6. 单击详细信息链接以在新窗口查看格式化的日志消息。

Procedure管理通用记录器设置

  1. 登录到 Portal Server 管理控制台。

  2. 选择 "Portal" 选项卡。

  3. 在 "Portal" 下选择一个 Portal Server。

  4. 单击“记录”，然后单击子菜单中的“通用记录器设置”。

  5. 从“实例名称”下拉菜单，选择一个门户实例。

  6. 根据需要修改配置属性。

    可用的选项如下：

    常规

    日志级别 — 通过选择日志级别设置，选择要在日志文件中查看的信息内容。

    可供选择的日志级别包括：

    • Severe - 用户可看见的错误

    • Warning - 用户警告

    • Info - 为用户提供的信息

    • Config - 为开发者提供的静态设置信息

    • Fine - 基本跟踪信息

    • Finer - 详细跟踪信息

    • Finest - 完整跟踪信息

    • Off - 可用于关闭日志记录

    • All - 表示应记录所有消息

    文件处理器属性

    • 限制 — 指定日志文件的大小（字节）。如果日志文件大小超过此值，则将根据文件计数轮转日志文件。默认值为 5 兆字节。

    • 文件计数 — 当日志达到指定的大小（字节）时，创建一个新的空文件，其生成编号（“文件模式”中的 %g）每次加 1。默认值为 2。要关闭日志文件轮转，可将该值设置为 0。

    • 附加 — 指定是否将新消息附加到现有文件。默认值为 true。

    • 过滤器 — 您可以插入自定义日志过滤器，以过滤发送到目标（例如门户日志或自定义日志处理器指定的目标）的日志记录。自定义过滤器必须实现接口 java.util.logging.Filter。在该字段中键入过滤器的绝对类名称。还要将过滤器类置于 Application Server 类路径中，以便在服务器启动过程中安装该过滤器。

    其它

    • 自定义处理器 — 您可以插入自定义日志处理器，以将日志发送到门户日志以外的目标。自定义处理器必须扩展类 java.util.logging.Handler（JSR 047 兼容 API）。在该字段中键入处理器的绝对类名称。还要将处理器类置于 Application Server 类路径中，以便在服务器启动过程中安装该处理器。您可以指定多个处理器。使用逗号分隔多个名称。

    • 使用 Web 容器日志文件 — 若要禁用门户日志记录管理并将所有日志传送到 Web 容器日志文件，选择“是”，否则选择“否”。默认值为“否”。

  7. 单击“应用到选定的实例”或“应用到所有实例”以记录更改。

等同的 psadmin 命令

psadmin set-logger

Procedure管理特定记录器设置

  1. 登录到 Portal Server 管理控制台。

  2. 选择 "Portal" 选项卡。

  3. 从 "Portal" 选择一个 Portal Server。

  4. 单击“记录”，然后单击子菜单中的“特定记录器设置”。

  5. 从“实例名称”下拉菜单，选择一个门户实例。

  6. 根据需要修改配置属性。

    可用的选项如下：

    记录器设置

    • 记录器名称 – 单击记录器名称获取记录器的配置详细信息。

    • 日志级别 – 您可以通过选择日志级别设置或从父记录器继承日志级别来选择查看记录器的日志文件中的信息内容。例如，如果 debug.com.sun.portal 的日志级别为 INFO，而 debug.com.sun.portal.desktop 的设置是“继承父记录器级别”，则其值也为 INFO。

    • 日志文件合并策略 – 对于记录器，您可以选择是要日志消息记录到与父记录器相同的日志文件（记录到父日志文件），还是日志应记录到单独的文件（记录到单独的日志文件）。

    • 父处理器 – 对于记录器，如果“日志文件合并策略”设为“记录到单独的日志文件”，则您可以选择是将消息同时记录到单独的日志文件和父日志文件（继承父处理器）或只记录到单独的文件（不继承父处理器）。

    • 堆栈跟踪 – 对于记录器，您可以选择是想要记录所有级别的堆栈跟踪（打印所有级别的堆栈跟踪）还是只记录到 WARNING 日志级别（打印堆栈跟踪，直到警告级别）。

      注 –

      如果“日志文件合并策略”值为“记录到父日志文件”，则忽略“父处理器”和堆栈跟踪的值。如果“日志文件合并策略”的值为“记录到单独的日志文件”，并且“父处理器”的值为“继承父处理器”，则“堆栈跟踪”的值“打印所有级别的堆栈跟踪”无效。

  7. 单击“应用到选定的实例”或“应用到所有实例”以记录更改。

等同的 psadmin 命令

psadmin set-logger