iLogtail新手入门指南：5分钟快速部署日志采集神器

iLogtail新手入门指南：5分钟快速部署日志采集神器

【免费下载链接】ilogtailFast and Lightweight Observability Data Collector项目地址: https://gitcode.com/gh_mirrors/il/ilogtail

什么是iLogtail及其核心价值

iLogtail是一款轻量级、高性能的日志采集工具，专为大规模日志采集场景设计。它能够帮助你在服务器、容器等环境中高效地收集、处理和传输日志数据。

核心优势：

• 资源占用极低：相比传统日志采集工具，内存和CPU消耗更少
• 配置灵活简单：通过YAML文件即可完成复杂采集任务配置
• 扩展性强：支持多种输入源和输出目标
• 部署便捷：无需复杂环境依赖，开箱即用

环境准备与系统要求

在开始部署之前，请确保你的系统满足以下基本条件：

操作系统：Linux主流发行版（CentOS、Ubuntu等）权限要求：基本的命令行操作权限网络状态：网络连接正常，能够下载必要的文件

四步快速部署流程

第一步：获取iLogtail安装包

首先下载预编译的iLogtail安装包：

wget https://loongcollector-community-edition.oss-cn-shanghai.aliyuncs.com/0.2.0/loongcollector-0.2.0.linux-amd64.tar.gz

第二步：解压与目录准备

解压下载的压缩包并进入解压后的目录：

tar -xzvf loongcollector-0.2.0.linux-amd64.tar.gz cd loongcollector-0.2.0

第三步：基础配置创建

iLogtail的配置分为两个层次：

系统级配置：位于conf/instance_config/local/loongcollector_config.json采集任务配置：位于conf/continuous_pipeline_config/local/目录

创建一个最简单的采集配置文件basic_log_collection.yaml：

enable: true inputs: - Type: input_file FilePaths: - ./test.log flushers: - Type: flusher_stdout OnlyStdout: true

这个配置的含义是：

• 启用当前采集任务
• 输入类型为文件采集
• 采集当前目录下的test.log文件
• 输出类型为标准输出

第四步：启动服务与验证

在后台启动iLogtail服务：

nohup ./loongcollector > output.log 2> error.log &

命令说明：

• nohup：确保进程在终端关闭后继续运行
• > output.log：将标准输出重定向到output.log文件
• 2> error.log：将错误输出重定向到error.log文件
• &：在后台运行进程

快速验证采集效果

生成测试日志

创建一个测试日志文件并写入内容：

echo "iLogtail采集测试 - 第一条日志" >> test.log echo "iLogtail采集测试 - 第二条日志" >> test.log

查看采集结果

检查output.log文件中的采集结果：

cat output.log

预期输出示例：

{"__tag__:__path__":"./test.log","content":"iLogtail采集测试 - 第一条日志","__time__":"1733385029"} {"__tag__:path__":"./test.log","content":"iLogtail采集测试 - 第二条日志","__time__":"1733385030"}

理解采集结果结构

iLogtail的输出采用结构化JSON格式，包含以下关键信息：

结构化输出的优势：

• 便于后续的日志解析和处理
• 自动添加元数据信息
• 支持多种日志分析工具

实用配置技巧与优化

技巧一：多文件同时采集

扩展FilePaths配置，同时采集多个日志文件：

FilePaths: - /var/log/nginx/access.log - /var/log/nginx/error.log - /var/log/system.log

技巧二：日志内容过滤

添加processor实现简单的日志过滤：

processors: - Type: processor_filter_regex Include: Regex: "ERROR|WARN"

技巧三：输出到文件系统

配置输出到本地文件：

flushers: - Type: flusher_file FilePath: ./collected_logs.json

常见问题快速排查

问题1：日志未被采集

排查步骤：

1. 确认配置文件中的enable设置为true
2. 检查日志文件路径是否正确
3. 查看error.log中的错误信息

问题2：输出结果异常

排查步骤：

1. 检查采集配置语法是否正确
2. 确认输出目标是否有写入权限
3. 验证日志文件是否包含可读内容

问题3：进程无法启动

排查步骤：

1. 检查系统权限是否足够
2. 确认安装包是否完整
3. 查看系统资源是否充足

进阶学习路径建议

完成基础部署后，你可以继续探索以下方向：

配置优化：参考example_config/目录下的示例配置功能扩展：了解更多的input和flusher类型性能调优：根据实际场景调整采集参数

总结

通过本指南，你已经成功完成了iLogtail的快速部署和基础验证。iLogtail的强大之处在于其简单易用的配置方式和丰富的功能扩展，后续你可以根据具体需求深入探索更多高级功能。

【免费下载链接】ilogtailFast and Lightweight Observability Data Collector项目地址: https://gitcode.com/gh_mirrors/il/ilogtail