当前位置：首页 > news >正文

什么是 NGINX 日志？

news 2026/6/27 5:25:36

开源技术小栈
NGINX 提供两种类型的日志：访问日志和错误日志

这些日志分别提供了对用户交互和系统运行状况的不同见解。了解并有效利用这些日志类型对于维护强大和安全的数字环境至关重要。

以下是 Nginx 访问日志条目可能是什么样子的简单示例：

127.0.0.1 - - [04/Jan/2025:12:34:56 +0000] "GET /example-page HTTP/1.1" 200 1234 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.88 Safari/537.36"

这只是一个基本示例，Nginx 允许您使用配置文件中的log_format指令自定义日志格式。您可以根据需要包含或排除特定信息。例如

log_format custom_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent"'; access_log /path/to/access.log custom_log;

在这种自定义日志格式中，您可以准确定义要包含在日志中的信息。根据您的特定要求调整格式。

NGINX 访问日志

NGINX 访问日志是用户与 Web 服务器交互时的事件记录。它存储 IP 地址、请求的文件和服务器响应等详细信息。

将其视为日记，帮助管理员通过分析用户交互来跟踪网站活动、解决问题和优化性能。

配置指令：`access_log`

案例

127.0.0.1 - - [04/Jan/2025:12:34:56 +0000] "GET /example-page HTTP/1.1" 200 1234 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/79.0.3945.88 Safari/537.36"

每次 NGINX 管理请求时，无论是提供网页、处理 API 调用还是任何其他与 Web 相关的任务，服务器都会在处理后立即系统地将详细信息记录在其访问日志中。

这些日志条目包含关键信息，例如客户端的 IP 地址、请求的资源和方法、服务器响应代码、计时细节和其他相关数据。

这些日志对于故障排除、性能监控和深入了解用户与服务器的交互非常宝贵。

因此，NGINX 访问日志字段捕获有关向 NGINX Web 服务器发出的每个请求的特定详细信息。这些字段的目的是提供客户端和服务器之间交互的全面记录。例如

$remote_addr：表示客户端的 IP 地址，标识请求的来源。
$time_local：表示服务器在请求时的本地时间，有助于进行基于时间的分析。
$request_method：表示请求中使用的 HTTP 方法，例如 GET、POST 等。
$request_uri：捕获请求的 URI 以及查询字符串，从而深入了解所请求的特定资源。
$status：反映服务端返回给客户端的 HTTP 状态码，表示请求成功或失败。
$body_bytes_sent：测量响应正文的大小（以字节为单位），指示发送到客户端的数据量。
$http_referer：记录引用页面的 URL，显示请求的来源。
$http_user_agent：包含客户端浏览器发送的 User-Agent 字符串，提供有关客户端设备和浏览器的信息。
$http_x_forwarded_for：与代理设置相关，当 NGINX 位于代理或负载均衡器后面时，它会显示原始客户端的 IP 地址。
$request_time：表示处理请求所花费的时间，提供对服务器响应能力的见解。

这些字段以及其他字段共同提供了对请求性质、服务器响应和时间的见解，帮助管理员分析和优化 NGINX Web 服务器的性能、安全性和功能。

访问日志位置

NGINX 访问日志的默认位置因操作系统和 NGINX 配置而异。您可以在 NGINX 配置文件（通常位于/etc/nginx/nginx.conf或/etc/nginx/sites-available/default）中找到访问日志配置。

access_log /path/to/access.log;

如何启用 NGINX 访问日志？

NGINX 访问日志通常默认处于激活状态，但如果您需要手动启用它们，则可以在 NGINX 配置中使用access_log指令。此指令需要两个参数：第一个参数指定日志文件的路径，第二个参数确定日志格式。

access_log /var/log/nginx/access.log combined;

文件位置参数（/var/log/nginx/access.log）：指定访问日志的存储位置。
日志格式参数（组合）：此参数定义记录日志条目的格式。在提供的示例中，使用组合日志格式。此格式包括客户端的 IP 地址、时间戳、请求详细信息、状态代码和响应大小等常见字段。combined格式用途广泛，适用于一般日志记录用途。

如何禁用 NGINX 访问日志？

要禁用访问日志，您可以注释掉现有的access_log指令或将其设置为off。如果没有 access_log 指令，您可以添加一个 off 作为参数的指令。

http { # ... other configurations ... # Disable access logs access_log off; # ... other configurations ... }

NGINX 错误日志

NGINX 错误日志通过记录有关服务器错误、异常和请求处理过程中可能发生的问题的信息来补充访问日志。这些日志对于识别和排查服务器中的问题至关重要。与访问日志类似，NGINX 错误日志遵循特定模式，捕获有关错误性质及其对服务器操作的影响的详细信息。

配置指令：error_log

案例

2025/01/04 12:34:56 [error] 1234#0: *5678 open() "/path/to/nonexistent-file" failed (2: No such file or directory), client: 127.0.0.1, server: example.com, request: "GET /nonexistent-file HTTP/1.1", host: "example.com"

以下是 NGINX 错误日志中常见的一些关键字段：