Nginx日志是运维网站的重要信息，日志服务支持通过Nginx模式快速采集Nginx日志并进行多维度分析。本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置采集日志。
前提条件
- 已创建Project和Logstore。更多信息，请参见创建Project和创建Logstore。
- 已开通服务器的80端口和443端口。
操作步骤
- 创建Logtail配置，单击下一步。
参数 说明 配置名称 Logtail配置的名称，在其所属Project内必须唯一。创建Logtail配置成功后，无法修改其名称。 您也可以单击导入其他配置，导入其他已创建的Logtail配置。
日志路径 指定日志的目录和文件名。 日志文件名支持完整文件名和通配符两种模式，文件名规则请参见Wildcard matching。日志文件查找模式为多层目录匹配，即指定目录（包含所有层级的目录）下所有符合条件的文件都会被查找到。例如：- /apsara/nuwa/…/*.log表示/apsara/nuwa目录（包含该目录的递归子目录）中后缀名为.log的文件。
- /var/logs/app_*/*.log表示/var/logs目录下所有符合app_*模式的目录（包含该目录的递归子目录）中包含.log的文件。
说明- 默认情况下，一个文件只能被一个Logtail配置采集。
- 如果一个文件需要被采集多份，建议软链接文件所在的目录。例如/home/log/nginx/log/log.log文件需要被采集两份，则执行如下命令创建该文件所在目录的软链接。在一个Logtail配置中使用原路径，在另一个Logtail配置中使用软链接路径。
ln -s /home/log/nginx/log /home/log/nginx/link_log - 目录通配符只支持星号（*）和问号（?）。
设置采集黑名单 打开设置采集黑名单开关后，可进行黑名单配置，即可在采集时忽略指定的目录或文件。支持完整匹配和通配符模式匹配目录和文件名。例如： - 选择按目录路径，路径为/tmp/mydir，则在采集时过滤掉该目录下的所有文件。
- 选择按文件路径，路径为/tmp/mydir/file，则在采集时过滤掉该文件。
是否为Docker文件 如果是Docker文件，可打开是否为Docker文件开关，直接配置内部路径与容器Tag。Logtail会自动监测容器创建和销毁，并根据Tag进行过滤采集指定容器的日志。关于容器文本日志采集请参见通过DaemonSet-控制台方式采集Kubernetes文件。 模式 默认为NGINX配置模式，可修改为其它模式。 NGINX日志配置 Nginx配置文件中的日志配置部分，以log_format开头。例如： log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$request_time $request_length ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent"';更多信息，请参见附录：日志格式和样例。
正则表达式 日志服务根据NGINX日志配置中的内容自动生成正则表达式。 日志样例 请根据实际场景，输入Nginx日志样例。例如： 192.168.1.2 - - [10/Jul/2020:15:51:09 +0800] "GET /ubuntu.iso HTTP/1.0" 0.000 129 404 168 "-" "Wget/1.11.4 Red Hat modified"日志服务通过日志样例验证您的NGINX日志配置是否匹配自动生成的正则表达式。输入日志样例后，单击验证。如果校验成功，自动将日志样例提取为NGINX键名称参数中NGINX键对应的值。
NGINX键名称 根据NGINX日志配置和日志样例自动生成NGINX键名称和对应的值。 丢弃解析失败日志 - 打开丢弃解析失败日志开关，解析失败的日志不上传到日志服务。
- 关闭丢弃解析失败日志开关，日志解析失败时上传原始日志到日志服务。
最大监控目录深度 设置日志目录被监控的最大深度。最大深度范围：0~1000，0代表只监控本层目录。 请根据您的需求选择高级配置。如果没有特殊需求，建议保持默认配置。参数 描述 启用插件处理 打开启用插件处理开关后，您可以设置Logtail插件处理日志。更多信息，请参见概述。 说明 打开启用插件处理开关后，上传原始日志、时区属性、丢弃解析失败日志、过滤器配置、接受部分字段（分隔符模式）等功能不可用。上传原始日志 打开上传原始日志开关后，原始日志将作为__raw__字段的值与解析过的日志一起上传到日志服务。 Topic生成方式 设置Topic生成方式。更多信息，请参见日志主题。 - 空-不生成Topic：默认选项，表示设置Topic为空字符串，在查询日志时不需要输入Topic即可查询。
- 机器组Topic属性：设置为机器组Topic属性，用于明确区分不同服务器产生的日志数据。
- 文件路径正则：设置为文件路径正则，则需要设置自定义正则，用正则表达式从路径里提取一部分内容作为Topic。用于区分不同用户或实例产生的日志数据。
日志文件编码 设置日志文件编码格式，取值为utf8、gbk。 时区属性 采集日志时，日志时间的时区属性。 - 机器时区：默认为机器所在时区。
- 自定义时区：手动选择时区。
超时属性 如果一个日志文件在指定时间内没有任何更新，则认为该文件已超时。 - 永不超时：持续监控所有日志文件，永不超时。
- 30分钟超时：如果日志文件在30分钟内没有更新，则认为已超时，并不再监控该文件。
选择30分钟超时时，还需设置最大超时目录深度，范围为1~3。
过滤器配置 只采集完全符合过滤器条件的日志。例如： - 满足条件即采集，例如设置Key为level，Regex为WARNING|ERROR，表示只采集level为WARNING或ERROR类型的日志。
- 过滤不符合条件的日志。更多信息，请参见Regular-Expressions.info。
- 设置Key为level，Regex为^(?!.*(INFO|DEBUG)).*，表示不采集level为INFO或DEBUG类型的日志。
- 设置Key为url，Regex为.*^(?!.*(healthcheck)).*，表示不采集URL中带有healthcheck的日志。例如Key为url，Value为/inner/healthcheck/jiankong.html的日志将不会被采集。
更多信息，请参见regex-exclude-word、regex-exclude-pattern。
单击下一步即表示完成Logtail采集配置，日志服务开始采集日志。说明- Logtail配置生效时间最长需要3分钟，请耐心等待。
- 如果遇到Logtail采集报错，请参见诊断采集错误。
附录：日志格式和样例
Nginx访问日志相关指令主要有两条：log_format和access_log，通常在配置文件/etc/nginx/nginx.conf中配置。log_format用来定义日志格式；access_log用来指定日志文件的存放路径。
- 日志格式
log_format和access_log的默认值如下所示。
log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$request_time $request_length ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent"'; access_log /var/logs/nginx/access.log main日志字段说明如下所示。
字段名称 说明 remote_addr 客户端IP地址。 remote_user 客户端用户名。 time_local 服务器时间，前后必须加上中括号。 request 请求的URI和HTTP协议。 request_time 整个请求的总时间，单位为秒。 request_length 请求的长度，包括请求行、请求头和请求正文。 status 请求状态。 body_bytes_sent 发送给客户端的字节数，不包括响应头的大小。 http_referer URL跳转来源。 http_user_agent 客户端浏览器等信息。 - 日志样例
192.168.1.2 - - [10/Jul/2020:15:51:09 +0800] "GET /ubuntu.iso HTTP/1.0" 0.000 129 404 168 "-" "Wget/1.11.4 Red Hat modified"
在文档使用中是否遇到以下问题
更多建议
匿名提交