ricc/nginx-jsonlog

Nginx JSON日志镜像

镜像概述

本镜像基于Nginx构建，提供了将访问日志以JSON格式输出的功能，帮助用户更高效地进行日志的结构化解析、监控与分析。

核心功能

• 支持访问日志的JSON格式输出
• 可通过$application变量指定应用名称，便于日志分类
• 内置健康检查接口/healthcheck

使用场景

• 需要对Nginx访问日志进行结构化分析的业务场景
• 日志监控系统对接（如ELK Stack等日志分析平台）
• 应用性能监控与故障排查

配置说明

1. 设置$application变量为你的应用名称
2. 在server指令中指定access_log类型为json

配置示例（default.conf）

server {
    listen  80;
    set $application 'your-app-name';
    access_log /var/log/nginx/access.log json;
    error_log  /var/log/nginx/error.log error;

    location / {
        return 200 'hello world';
        add_header Content-Type text/plain;
    }

    location /healthcheck {
        return 200 'healthy';
        add_header Content-Type text/plain;
    }
}

部署示例

Docker Run命令

bash
docker run -d -p 80:80 -v $(pwd)/default.conf:/etc/nginx/conf.d/default.conf ricc/nginx-jsonlog

Docker Compose示例

yaml
version: '3'
services:
  nginx-jsonlog:
    image: ricc/nginx-jsonlog
    ports:
      - "80:80"
    volumes:
      - ./default.conf:/etc/nginx/conf.d/default.conf