Question

在 Docker 集群 部署项目时，收集日志会是一个比较麻烦的问题，但阿里云提供了十分好用的 日志收集系统，本篇文档就是简略介绍一下阿里云日志收集的使用方法。

• Docker Swarm 集群搭建

开通日志服务

首先第一步便是在阿里云上开通 日志服务。

日志服务文档

以下的教程是一个顺序的操作方式，一步一步讲述如何使用日志服务。

安装 Logtail 容器

标准 Docker 日志采集流程文档

参数	说明
${your_region_name}	区域 ID 比如华东 1 区域是 cn-hangzhou
${your_aliyun_user_id}	用户标识，请替换为您的阿里云主账号用户 ID。
${your_machine_group_user_defined_id}	集群的机器组自定义标识 以下使用 Hyperf

docker run -d -v /:/logtail_host:ro -v /var/run/docker.sock:/var/run/docker.sock \
--env ALIYUN_LOGTAIL_CONFIG=/etc/ilogtail/conf/${your_region_name}/ilogtail_config.json \
--env ALIYUN_LOGTAIL_USER_ID=${your_aliyun_user_id} \
--env ALIYUN_LOGTAIL_USER_DEFINED_ID=${your_machine_group_user_defined_id} \
registry.cn-hangzhou.aliyuncs.com/log-service/logtail

配置日志收集

创建 Project

登录阿里云日志服务，点击 创建 Project，填写以下信息

参数	填写示例
Project 名称	hyperf
注释	用于日志系统演示
所属区域	华东 1（杭州）
开通服务	详细日志
日志存储位置	当前 Project

创建 Logstore

除以下参数，按需填写，其他都使用默认即可

参数	填写示例
Logstore 名称	hyperf-demo-api
永久保存	false
数据保存时间	60

接入数据

1. 选择 Docker 文件

2. 创建机器组

如果已经创建过机器组，可以跳过这一步

参数	填写示例
机器组名称	Hyperf
机器组标识	用户自定义标识
用户自定义标识	Hyperf

1. 配置机器组

应用刚刚创建的机器组

1. 配置 Logtail

Label 白名单，这里可以按需填写，以下按照项目名字来配置，而项目名会在 Docker 容器运行时设置。

参数	填写示例	填写示例
配置名称	hyperf-demo-api
日志路径	/opt/www/runtime/logs	*.log
Label 白名单	app.name	hyperf-demo-api
模式	完整正则模式
单行模式	false
日志样例	[2019-03-07 11:58:57] hyperf.WARNING: xxx
首行正则表达式	[\d+-\d+-\d+\s\d+:\d+:\d+]\s.*
提取字段	true
正则表达式	[(\d+-\d+-\d+\s\d+:\d+:\d+)]\s(\w+).(\w+):(.*)
日志抽取内容	time name level content

1. 查询分析配置

字段索引属性

字段名称	类型	别名	中文分词	开启统计
name	text	name	false	true
level	text	level	false	true
time	text	time	false	false
content	text	content	true	false

运行镜像

运行镜像时，只需要设置 Container labels 即可。

name	value
app.name	hyperf-demo-api

比如以下 Dockerfile

# Default Dockerfile

FROM hyperf/hyperf:7.4-alpine-v3.11-swoole
LABEL maintainer="Hyperf Developers <group@hyperf.io>" version="1.0" license="MIT" app.name="hyperf-demo-api"

# 其它内容省略

注意事项

• Docker 存储驱动限制：目前只支持 overlay、overlay2，其他存储驱动需将日志所在目录 mount 到本地，然后改为收集宿主机 ~/logtail_host/your_path 下的日志即可。