Sun Java System Calendar Server 6.3 管理指南

22.1 打开 Calendar Server 6.3 软件的调试信息

本节介绍使用日志和调试信息来故障排除 Calendar Server 部署的问题的概念性信息和说明。

由于没有哪个 ics.conf 参数可用于将整个系统置入“调试模式”，因此，本节介绍了一些获取有用调试信息的方法：

注 –

确保在不需要的时候关闭超额的日志记录和监视，因为它将对性能产生负面影响。

22.1.1 提高日志记录级别

使用下表显示的参数来提高日志记录的详细级别：

参数	说明和默认值
`logfile.loglevel`	设置为 `DEBUG` 可以获得所有详细级别的日志，其中包括 `CRITICAL`、`ALERT`、`ERROR`、`WARNING`、 `NOTICE` 和 `INFORMATION`。此参数适用于所有日志。

要将所有访问信息记录到 LDAP 数据高速缓存并打印日志（报告），设置下表中所示的 ics.conf 参数：

参数	说明和默认值
`local.ldap.cache.stat.enable`	指定是否将访问记录到 LDAP 数据高速缓存，以及是否在日志文件中记录统计信息。默认值为 `"no"`（不记录统计信息）。设置为 `"yes"` 可以记录统计信息。为了增强性能，请仅在调试模式下使用此参数。
`local.ldap.cache.stat.interval`	以秒为单位指定每个统计报告写入日志文件的时间间隔。默认值为 `"1800"` 秒（30 分钟）。仅当启用了日志记录时，此参数才处于活动状态。减少时间间隔有助于您查明问题所在。增加时间间隔有助于降低系统负载。

参数

说明和默认值

local.ldap.cache.stat.enable

指定是否将访问记录到 LDAP 数据高速缓存，以及是否在日志文件中记录统计信息。默认值为 "no"（不记录统计信息）。设置为 "yes" 可以记录统计信息。

为了增强性能，请仅在调试模式下使用此参数。

local.ldap.cache.stat.interval

以秒为单位指定每个统计报告写入日志文件的时间间隔。默认值为 "1800" 秒（30 分钟）。

仅当启用了日志记录时，此参数才处于活动状态。减少时间间隔有助于您查明问题所在。增加时间间隔有助于降低系统负载。

目前 Calendar Server 中没有使 LDAP 高速缓存数据过期的设置。必须手动删除 ldap_cache 目录中的内容，并重新启动 Calendar Server。

两个便于调试的配置参数会启用收到的命令和 HTTP 访问的日志记录。将这两个参数中的一个或全部添加到 ics.conf 文件以激活日志记录：

service.http.commandlog = "yes" — cshttpd 进程会在日志目录中创建文件 http.commands。日志包含服务器收到的每个 .shtml 或 .wcap 命令以及每个命令的所有参数。
service.http.commandlog.all = "yes" — cshttpd 进程在日志目录中创建文件 http.access。日志包含系统收到的每个 HTTP 请求。

注意 –

日志文件可能会迅速增大，并最终占用全部的可用磁盘空间。需小心监视这些文件，以避免发生问题。选择系统活动性较低的时期来启用并运行这些命令。如果在高峰时期运行，性能会大幅度下降。完成故障排除前始终禁用这两个命令。

使用 csstats list 命令显示 counter.conf 文件中定义的计数器对象中的统计信息。