log_format
log_format 指令指定由 NGINX SRT 模块生成的日志格式。
Nginx SRT Module
语法log_format name string;
默认值none
上下文
参数2+
说明
log_format 指令允许你自定义 NGINX SRT 模块使用的日志格式。通过设置该指令,你可以定义记录 SRT 会话、连接和数据传输信息的日志条目的内容和结构。你可以包含预定义变量来捕获特定细节,例如远程地址、用户代理和自定义 SRT 参数,从而使日志满足你的监控和调试需求。
每个日志格式由一个名称和一个或多个参数定义,这些参数决定日志中存储哪些数据。参数可以包含标准的 NGINX 变量,例如 $remote_addr,你也可以包含模块特定的变量,以便对与 SRT 操作相关的日志进行更细粒度的记录。这些变量的组合使得在不硬编码任何值的情况下更容易一致地格式化日志,从而增强了 SRT 场景下日志功能的灵活性。
在使用 log_format 指令定义日志格式后,你必须使用 access_log 指令将其关联到一个具体的日志文件,日志条目将写入该文件。这种有效的分离便于在 NGINX 中为不同服务或上下文维护多种日志配置。
配置示例
log_format srt_format '$remote_addr - $remote_user [$time_local] "$request" $status $bytes_sent'; access_log /var/log/nginx/srt_access.log srt_format;
⚠
确保日志格式名称唯一,以避免与在您的 NGINX 配置中定义的其他日志格式发生冲突。
⚠
请记得设置 access_log 指令,将您的自定义日志格式与日志文件关联,否则该格式将不会被使用。