文件日志

基本介绍

日志是用来暴露系统内部状态的一种手段，好的日志可以帮助开发人员快速定位问题所在，然后找到合适的方式解决掉问题。该插件支持将节点访问日志输出到文件中。

功能特性

文件日志：将请求信息输出到日志文件中，具备以下特性：

自定义文件的存放目录及文件名称
按照一定周期分割日志文件，避免单个文件过大不好查看的问题
定时删除过期文件，降低硬盘空间开销

可配合控制台日志检索插件使用，在控制台中追踪节点请求日志，并且可以下载历史日志。

功能演示

新建文件日志配置

1、点击左侧导航栏文件日志，进入文件日志列表页面，点击新建文件日志

2、填写文件日志配置

配置说明：

字段名称	说明
文件名称	存放的文件名称，实际存放的名称会加上 `.log` 后缀，即为：{文件名称}.log
存放目录	文件存放目录，支持相对路径和绝对路径
日志分割周期	按照一定周期创建新日志文件，旧日志文件将会重命名，可选项：小时、天
过期时间	文件保存时间，单位：天，超过保存时间的，将定时清理删除
输出格式	输出日志内容格式，支持单行、Json格式输出
格式化配置	输出格式模版，配置教程点此进行跳转

文件生命周期演示

示例格式化配置

{
   "fields": [
      "$time_iso8601",
      "$request_id",
      "@request",
      "@proxy",
      "@response",
      "@status_code",
      "@time"
   ],
   "request": [
      "$request_method",
      "$scheme",
      "$request_uri",
      "$host",
      "$header",
      "$remote_addr"
   ],
   "proxy": [
      "$proxy_method",
      "$proxy_scheme",
      "$proxy_uri",
      "$proxy_host",
      "$proxy_header",
      "$proxy_addr"
   ],
   "response": [
      "$response_header"
   ],
   "status_code": [
      "$status",
      "$proxy_status"
   ],
   "time": [
      "$request_time",
      "$response_time"
   ]
}

3、点击确定后，日志输出添加完成