# Log format

默认配置使用自定义日志记录格式来添加有关上游，响应时间和状态的其他信息.

```
log_format upstreaminfo
    '$remote_addr - $remote_user [$time_local] "$request" '
    '$status $body_bytes_sent "$http_referer" "$http_user_agent" '
    '$request_length $request_time [$proxy_upstream_name] [$proxy_alternative_upstream_name] $upstream_addr '
    '$upstream_response_length $upstream_response_time $upstream_status $req_id';
```

| 占位符                                | 描述                                                                               |
| ---------------------------------- | -------------------------------------------------------------------------------- |
| `$proxy_protocol_addr`             | 远程地址(如果启用了代理协议)                                                                  |
| `$remote_addr`                     | 客户端的源IP地址                                                                        |
| `$remote_user`                     | 基本身份验证随附的用户名                                                                     |
| `$time_local`                      | 通用日志格式的本地时间                                                                      |
| `$request`                         | 完整的原始请求行                                                                         |
| `$status`                          | 相应状态                                                                             |
| `$body_bytes_sent`                 | 发送给客户端的字节数，不计算响应头                                                                |
| `$http_referer`                    | Referer标头的值                                                                      |
| `$http_user_agent`                 | User-Agent 头的值                                                                   |
| `$request_length`                  | 请求长度 (包括请求行，标头和请求正文)                                                             |
| `$request_time`                    | 从客户端读取第一个字节以来经过的时间                                                               |
| `$proxy_upstream_name`             | upstream名称. 格式为 `upstream-<namespace>-<service name>-<service port>`             |
| `$proxy_alternative_upstream_name` | alternative upstream名称. 格式为 `upstream-<namespace>-<service name>-<service port>` |
| `$upstream_addr`                   | 上游服务器的IP地址和端口(或域套接字的路径). 如果在请求处理过程中联系了多个服务器，则其地址之间用逗号分隔.                         |
| `$upstream_response_length`        | 从上游服务器获得的响应的长度                                                                   |
| `$upstream_response_time`          | 从上游服务器接收响应所花费的时间(以毫秒为单位)                                                         |
| `$upstream_status`                 | 从上游服务器获得的响应的状态码                                                                  |
| `$req_id`                          | 随机生成的请求ID                                                                        |

其他可用变量:

| 占位符             | 描述             |
| --------------- | -------------- |
| `$namespace`    | ingress所在的命名空间 |
| `$ingress_name` | ingress的名称     |
| `$service_name` | service名称      |
| `$service_port` | service端口      |

参考:

* [Upstream variables](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#variables)
* [Embedded variables](http://nginx.org/en/docs/http/ngx_http_core_module.html#variables)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rocdu.gitbook.io/ingress-nginx-docs-cn/docs/user-guide/nginx-configuration/log-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.