这是一篇根据您提供的操作流程编写的技术文档。它详细记录了手动安装和配置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 |
