把 Nginx 日志变成 JSON 格式，只需几行 Map 指令！

2023-04-13 21:30:03

使用 Map 指令轻松转换 Nginx 日志为 JSON 格式

在当今高度互联的世界中，日志分析已成为运营和维护复杂 IT 基础设施的关键方面。Nginx 是一款流行的 Web 服务器，以其高性能和稳定性而闻名。然而，将其日志转换为 JSON 格式以进行进一步分析可能是一项艰巨的任务。借助强大的 Map 指令，我们可以轻松实现这一目标。

Map 指令：强大的转换工具

Map 指令是 Nginx 的内置功能，可将一个值映射到另一个值。它的语法简单而强大，可用于各种转换场景。例如，我们可以将字符串映射到字符串，数字映射到数字，或根据正则表达式匹配执行复杂的转换。

转换 Nginx 日志到 JSON 格式

使用 Map 指令将 Nginx 日志转换为 JSON 格式是一个两步过程。首先，我们需要创建映射规则以将日志字段映射到 JSON 属性。其次，我们将使用 log_format 指令定义一个新的日志格式，使用这些映射规则将日志数据转换为 JSON。

以下是将时间戳、请求方法、请求 URI 和用户代理映射到 JSON 属性的示例映射规则：

map $time "$time_iso8601" {
    ~ ^[0-9]+$ "$time_local"
}

map $request_method "$request_method" {
    GET "get"
    POST "post"
    PUT "put"
    DELETE "delete"
}

map $request_uri "$request_uri" {
    ~ ^/api/v1/users/(.*)$ "/api/v1/users/$1"
}

map $http_user_agent "$http_user_agent" {
    ~ ^Mozilla/5\.0 $
}

这些映射规则确保将时间戳转换为 ISO 8601 格式，将请求方法标准化为小写，将请求 URI 标准化为 /api/v1/users/{id} 格式，并将用户代理转换为一个简单标志，指示是否存在 Mozilla/5.0 字符串。

有了这些映射规则，我们可以使用 log_format 指令定义新的日志格式：

log_format json '{
    "time": "$time",
    "request_method": "$request_method",
    "request_uri": "$request_uri",
    "http_user_agent": "$http_user_agent"
}'