Sun Java System Instant Messaging 7.2 管理指南

管理 XMPP/HTTP 网关的日志记录

您可以配置 XMPP/HTTP 网关的日志记录级别、完全启用或禁用日志记录以及更改网关日志文件或网关日志配置文件的位置,如以下各节所述:

有关 Instant Messaging 所支持的 log4j 格式的详细信息,参见Apache Logging Services 网站中的相关说明。

Procedure启用或禁用 XMPP/HTTP 网关的日志记录

您可以通过两种方式启用或禁用网关的日志记录:

在大多数情况下,您应该修改 httpbind_log4j.conf 文件本身中的配置,而保留将 httpbind.log4j.config 参数设为 httpbind_log4j.conf 文件的位置。以下过程说明如何修改 httpbind_log4j.conf 文件中的配置。

  1. 打开 httpbind_log4j.conf 文件。

    此文件的存储位置是您在 httpbind.conf 文件中指定作为 httpbind.log4j.config 参数的值。默认情况下,文件存储于默认 Instant Messaging 实例的以下目录中:


    im-cfg-base/httpbind_log4j.conf
  2. 要禁用网关的日志记录,请将 log4j.logger.gateway 参数设置如下:


    log4j.logger.gateway=OFF
    
  3. 要启用日志记录,请将 log4j.logger.gateway 参数设为所需的日志记录级别。

    例如:


    log4j.logger.gateway=ERROR
    

    有关您可以使用的有效日志记录级别列表,参见表 13–1

  4. 保存并关闭 httpbind_log4j.conf

Procedure更改 XMPP/HTTP 网关日志配置文件的位置

  1. 打开 httpbind.conf

    有关查找此文件的信息,参见httpbind.conf 文件位置

  2. httpbind.log4j.config 参数的值设为 XMPP/HTTP 网关日志配置文件的位置。

  3. 保存并关闭 httpbind.conf

  4. 使用 Web 或应用服务器提供的工具重新启动网关。

ProcedureLinux: 安装或升级后设置 XMPP/HTTP 网关日志文件的位置

在 Linux 中,安装和配置 XMPP/HTTP 网关后,您需要修改 httpbind_log4j.conf 中 XMPP/HTTP 网关默认日志文件的位置。

  1. 打开 httpbind_log4j.conf 文件。

    此文件的存储位置是您在 httpbind.conf 文件中指定作为 httpbind.log4j.config 参数的值。默认情况下,文件存储于默认 Instant Messaging 实例的以下目录中:


    im-cfg-base/httpbind_log4j.conf
  2. log4.appender.appender_ID.file 参数的值设为日志文件的存储位置。

Procedure更改 XMPP/HTTP 网关日志文件的位置

开始之前

确保您熟悉如 Apache Logging Services 网站中所述的 log4j 语法和一般的实现方法。

  1. 打开 httpbind_log4j.conf

    此文件的存储位置是您在 httpbind.conf 文件中指定作为 httpbind.log4j.config 参数的值。默认情况下,文件存储于默认 Instant Messaging 实例的以下目录中:


    im-cfg-base/httpbind_log4j.conf
  2. log4j.appender.appender-ID 参数的值设为您想要存储日志文件的位置。

  3. 保存并关闭 httpbind_log4j.conf

  4. 重新启动 Web 容器。

Procedure使用 XMPP/HTTP 网关的非默认日志文件位置

如果您选择使用非默认的日志文件位置,则您需要修改 httpbind_log4j.conf 中 XMPP/HTTP 网关默认日志文件的位置。

  1. 打开 httpbind_log4j.conf 文件。

    此文件的存储位置是您在 httpbind.conf 文件中指定作为 httpbind.log4j.config 参数的值。默认情况下,文件存储于默认 Instant Messaging 实例的以下目录中:


    im-cfg-base/httpbind_log4j.conf
  2. log4.appender.appender_ID.file 参数的值设为日志文件的存储位置。

Procedure设置 XMPP/HTTP 网关日志记录级别

开始之前

确保您熟悉如 Apache Logging Services 网站中所述的 log4j 语法和一般的实现。

  1. 打开 httpbind_log4j.conf

    此文件的存储位置是您在 httpbind.conf 文件中指定作为 httpbind.log4j.config 参数的值。默认情况下,文件存储于默认 Instant Messaging 实例的以下目录中:


    im-cfg-base/httpbind_log4j.conf
  2. log4j.logger.gateway 参数设为所需的日志记录级别。

    例如:


    log4j.logger.gateway=ERROR
    

    有关您可以使用的有效日志记录级别列表,参见表 13–1

XMPP/HTTP 网关 log4j 日志配置文件语法

有关 log4j 语法和一般实现的详细信息,参见Apache Logging Services 网站。网关日志配置文件语法如下。


log4j.logger.gateway=logging-level, Appender-ID
# DEFAULT TO RollingFileAppender
log4j.appender.Appender-ID=org.apache.log4j.RollingFileAppender
log4j.appender.Appender-ID.file=log-dir/httpbind.log
log4j.appender.Appender-ID.append=true|false
log4j.appender.Appender-ID.maxBackupIndex=7
log4j.appender.Appender-ID.maxFileSize=max-log-file-size
log4j.appender.Appender-ID.layout=org.apache.log4j.PatternLayout
log4j.appender.Appender-ID.layout.ConversionPattern=log-entry-syntax

示例 10–1 XMPP/HTTP 网关日志配置文件 (httpbind_log4j.conf)


log4j.logger.gateway=ERROR, A1
# DEFAULT TO RollingFileAppender
log4j.appender.A1=org.apache.log4j.RollingFileAppender
# log4j.appender.A1.file=$(logdir)/gateway.log
log4j.appender.A1.file=/tmp/gatewaylog
log4j.appender.A1.append=true
log4j.appender.A1.maxBackupIndex=7
log4j.appender.A1.maxFileSize=5mb
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n