阿里云日志服务
优质
小牛编辑
137浏览
2023-12-01
在 Docker 集群 部署项目时，收集日志会是一个比较麻烦的问题，但阿里云提供了十分好用的 日志收集系统，本篇文档就是简略介绍一下阿里云日志收集的使用方法。
- Docker Swarm 集群搭建
开通日志服务
首先第一步便是在阿里云上开通 日志服务。
以下的教程是一个顺序的操作方式，一步一步讲述如何使用日志服务。
安装 Logtail 容器
| 参数 | 说明 |
|---|---|
| ${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 |
接入数据
选择 Docker 文件
创建机器组
如果已经创建过机器组，可以跳过这一步
| 参数 | 填写示例 |
|---|---|
| 机器组名称 | Hyperf |
| 机器组标识 | 用户自定义标识 |
| 用户自定义标识 | Hyperf |
- 配置机器组
应用刚刚创建的机器组
- 配置 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 |
- 查询分析配置
字段索引属性
| 字段名称 | 类型 | 别名 | 中文分词 | 开启统计 |
|---|---|---|---|---|
| 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下的日志即可。