这是一篇根据您提供的操作流程编写的技术文档。它详细记录了手动安装和配置Logtail以采集Nginx日志的全过程。
技术文档:手动安装阿里云Logtail采集Nginx访问日志
1. 文档概述
本文档详细描述了在Linux服务器上通过手动安装方式,部署阿里云日志服务(SLS)的Logtail客户端,并完成相关配置,以实现对Nginx访问日志的采集与集中化管理。此方案适用于无法通过自动化脚本或CLI工具安装的场景。
2. 环境准备
项目 | 要求 |
---|---|
操作系统 | CentOS 7.x / 8.x, Red Hat, Ubuntu, AlmaLinux 等主流Linux发行版 |
权限要求 | 执行安装和重启操作需 root 权限 |
网络要求 | 服务器可访问公网,能与指定地域的阿里云SLS服务端通信 |
依赖工具 | wget (用于下载安装脚本) |
3. 安装步骤
3.1. 下载Logtail安装脚本
通过以下命令下载阿里云官方提供的Logtail安装脚本。该脚本将自动识别系统架构并下载对应的二进制包。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh
参数说明:
-O logtail.sh
:指定下载的文件保存为logtail.sh
。
3.2. 赋予脚本执行权限
下载完成后,需为脚本添加可执行权限。
chmod 755 logtail.sh
3.3. 执行安装
运行安装脚本,并指定地域参数。本文以华东1(杭州)为例。
sudo ./logtail.sh install cn-hangzhou-internet
关键参数说明:
install
:执行安装操作。cn-hangzhou-internet
:指定Logtail客户端连接到华东1(杭州)地域的公共服务端点。如果您的SLS Project位于其他地域,请替换为相应的参数(如cn-beijing-internet
,cn-shanghai-internet
)。
3.4. 验证安装结果
安装完成后,通过检查Logtail服务状态来验证是否安装成功。
sudo /etc/init.d/ilogtaild status
预期成功输出:
ilogtail is running.
或
ilogtail (pid xxxx) is running...
此输出表明Logtail守护进程已正常启动并运行。
3.5. (可选)重启服务
若安装后状态检查异常,或需强制重新加载配置,可重启服务。
sudo /etc/init.d/ilogtaild restart
4. 阿里云控制台配置
Logtail安装成功仅完成了客户端部署,要开始采集日志,必须在阿里云SLS控制台进行配置。
4.1. 创建Project与Logstore
- 登录阿里云SLS控制台。
- 在目标地域(与安装参数一致,如华东1)创建或选择已有的 Project。
- 在该Project下创建或选择已有的 Logstore(用于存储Nginx日志)。
4.2. 配置Logtail采集
- 进入目标Logstore,点击“数据接入”。
- 选择“Nginx访问日志”或其他适合的数据源类型。
- 按照向导进行配置:
- 配置名称:自定义(如
nginx-access
)。 - 日志路径:填写Nginx访问日志的绝对路径(如
/var/log/nginx/access.log
)。确保与服务器上的实际路径一致。 - 机器组:选择包含当前服务器的机器组。安装后,服务器通常出现在“默认机器组”中,需将其应用到当前配置。
- 配置名称:自定义(如
4.3. 查询验证
完成配置并等待几分钟后,在Logstore的“查询分析”界面查询日志,若能看到采集到的Nginx日志,即表示整个流程成功。
5. 故障排查
问题现象 | 可能原因及解决方案 |
---|---|
状态检查失败 | 执行 sudo /etc/init.d/ilogtaild restart 重启服务,并再次检查状态。 |
无心跳 | 在SLS控制台的“机器组”中,确认服务器IP已正确添加且状态为“正常”。 |
无日志数据 | 1. 检查SLS中配置的日志路径是否与服务器实际路径完全一致。 2. 确认Logtail用户(通常为 ilogtail )有权限读取Nginx日志文件(如执行 sudo setfacl -m u:ilogtail:r /var/log/nginx/access.log )。 |
6. 附录
常用命令
# 启动Logtail服务
sudo /etc/init.d/ilogtaild start# 停止Logtail服务
sudo /etc/init.d/ilogtaild stop# 查看Logtail详细运行日志
tail -f /usr/local/ilogtail/ilogtail.LOG
其他地域安装参数示例
地域名称 | 安装参数 |
---|---|
华北2(北京) | cn-beijing-internet |
华东2(上海) | cn-shanghai-internet |
华南1(深圳) | cn-shenzhen-internet |