用户手册
Version 1.9 — Rev. 3

# 服务器日志

### 文件名

#### 描述

指定日志文件的路径。

#### 语法

文件路径

#### 提示

[性能建议] 将日志文件放置在一个单独的磁盘上。

### 日志级别

#### 描述

指定日志文件中记录的日志级别。 可用级别（由高到低）为: ERROR、 WARNING、NOTICE、INFO和DEBUG。 只有级别与当前设置相同或更高的消息将被记录（级别越低记录越详细）。

#### 语法

从下拉列表选择

#### 提示

[性能] 使用DEBUG日志级别本身不会影响性能， 除非调试级别设置为NONE以外的级别。建议将日志级别设置为DEBUG， 并将调试级别设置为NONE。这样不会让调试日志填满磁盘， 但仍可使用切换调试日志控制调试输出。此操作可以实时启用或关闭调试记录， 对于调试繁忙的生产服务器非常有用。

#### 另请参阅

调试级别

### 调试级别

#### 描述

指定调试日志级别。 要使用此功能，日志级别必须设置为DEBUG。 当“调试级别”设置为NONE时，即使日志级别 设置为DEBUG，调试日志也会被禁用。 切换调试日志可用于在运行中的服务器上 控制调试级别而无需重启。

#### 语法

从下拉列表选择

#### 提示

[性能] 重要！如果你不需要详细的调试日志记录， 应始终将其设置为NONE。启用调试日志记录将严重降低服务性能 ，且可能在很短时间内耗尽磁盘空间。 调试日志记录包括每个请求和响应的详细信息。
我们推荐将日志级别设置为DEBUG，调试级别设置为NONE。 这些设置意味着调试日志不会塞满磁盘， 但仍可使用切换调试日志 控制调试输出。此操作可以实时启用或关闭调试记录， 对于调试繁忙的生产服务器非常有用。

#### 另请参阅

日志级别, 切换调试日志

### 轮转大小（字节）

#### 描述

指定当前日志文件何时需要轮转，也称为日志轮转。 当文件大小超过轮转限制后，活动日志文件会在同一目录中重命名 为log_name.mm_dd_yyyy(.sequence)，并创建新的活动日志文件。 轮转后的日志文件实际大小有时会略大于此限制。 设置为0可禁用日志轮转。

#### 语法

整数

#### 提示

Information 可在数字后附加"K"、"M"、"G"分别表示千字节、兆字节和千兆字节。

### 保留天数

#### 描述

指定访问日志文件将被保存在磁盘上多少天。 只有早于指定天数的轮转日志文件会被删除。 当前的日志文件不会被删除，无论它包含了多少天的数据。 如果你不想自动删除过时的、很旧的日志文件， 将该值设置为0。

#### 语法

整数

### 压缩存档

#### 描述

指定是否压缩轮转日志文件以节省磁盘空间。

#### 语法

布尔值

#### 提示

Information 日志文件压缩率很高，建议启用此功能以减少旧日志的磁盘占用。

### 启用标准错误日志（stderr）

#### 描述

指定接收到服务器启动的进程输出的stderr时，是否写入日志。 如果启用，stderr消息会记录到服务器日志所在目录中固定名为"stderr.log"的文件。如果禁用，所有stderr输出都会被丢弃。
PHP的error_log()等不会直接写入stderr（文件句柄2）的函数不受此设置影响。它们会写入PHP ini指令'error_log'设置的文件；如果未设置该指令，则写入服务器的"error.log"文件，并带有"[STDERR]"标签。

#### 语法

布尔值

#### 提示

Information 如果您需要调试配置的外部应用程序，如PHP、Ruby、Java、Python、Perl，请开启该功能。

### 文件名

#### 描述

指定访问日志文件的文件名。

#### 语法

文件路径

#### 提示

[性能] 将访问日志文件放置在单独的磁盘上。

### 管道日志记录

#### 描述

指定一个外部应用程序，用来通过其STDIN流上的管道（文件句柄为0）接收LiteSpeed发送的访问日志数据。 指定此字段后，访问日志将仅发送到记录器应用程序，而不发送到上一个条目中指定的访问日志文件。
必须先在外部应用部分定义记录器应用程序。服务器级别的访问日志只能使用在服务器级别定义的外部记录器应用程序。虚拟主机级别的访问日志只能使用在虚拟主机级别定义的记录器应用程序。
记录器进程的启动方式与其他外部（CGI/FastCGI/LSAPI）进程相同。 这意味着它会以虚拟主机外部应用程序设置UID模式设置中指定的用户ID运行， 绝不会代表特权用户运行。
如果配置了记录器应用程序的多个实例，LiteSpeed Web服务器会在多个记录器应用程序之间执行简单的负载均衡。LiteSpeed服务器始终尽量将记录器应用程序数量保持在最低。只有当某个记录器应用程序无法及时处理访问日志条目时，服务器才会尝试启动该记录器应用程序的另一个实例。
如果记录器崩溃，Web服务器会启动另一个实例，但流缓冲区中的日志数据将会丢失。如果外部记录器无法跟上日志流的速度和数量，也可能丢失日志数据。

#### 语法

从下拉列表选择

### 日志格式

#### 描述

指定访问日志的格式。 设置之后，它将覆盖日志头部 的设定。

#### 语法

字符串。日志格式语法与Apache 2.0的自定义 日志格式兼容。

#### 示例

一般日志格式（CLF）
"%h %l %u %t \"%r\" %>s %b"
支持虚拟主机的一般日志格式
"%v %h %l %u %t \"%r\" %>s %b"
NCSA扩展/组合日志格式
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"
记录Foobar的cookie值
"%{Foobar}C"

#### 另请参阅

日志头部

### 日志头部

#### 描述

指定是否记录HTTP请求头：Referer、 UserAgent和Host。

#### 语法

从复选框选择

#### 提示

[性能] 如果不需要在访问日志中记录这些头部信息，请关闭此功能。

#### 另请参阅

日志格式