【免费下载】 iLogtail快速入门指南：从零开始采集主机日志

什么是iLogtail

iLogtail是一款轻量级、高性能的日志采集工具，由阿里巴巴开源并广泛应用于大规模日志采集场景。它具有资源占用低、配置灵活、扩展性强等特点，特别适合在服务器、容器等环境中进行日志采集和处理。

环境准备

在开始之前，请确保您的系统满足以下基本要求：

• Linux操作系统（推荐使用主流发行版）
• 基本的命令行操作权限
• 网络连接正常

安装iLogtail

1. 首先下载预编译的iLogtail包：

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

2. 解压下载的压缩包：

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

3. 进入解压后的目录：

cd loongcollector-0.2.0

配置iLogtail

iLogtail的配置分为系统参数配置和采集配置两部分：

1. 系统参数配置：位于conf/instance_config/local/loongcollector_config.json，用于设置iLogtail运行时的全局参数。

2. 采集配置：位于conf/continuous_pipeline_config/local目录下，每个YAML文件代表一个独立的采集任务。

下面我们创建一个简单的采集配置示例file_simple.yaml：

enable: true
inputs:
  - Type: input_file     # 指定输入类型为文件
    FilePaths:
    - ./simple.log       # 指定要采集的日志文件路径
flushers:
  - Type: flusher_stdout # 指定输出类型为标准输出
    OnlyStdout: true     # 仅输出到标准输出

这个配置表示：

• 采集当前目录下的simple.log文件
• 将采集到的日志内容输出到标准输出

启动iLogtail服务

使用以下命令在后台启动iLogtail：

nohup ./loongcollector > stdout.log 2> stderr.log &

这个命令做了以下几件事：

• 使用nohup确保进程在终端关闭后继续运行
• 将标准输出重定向到stdout.log文件
• 将错误输出重定向到stderr.log文件
• &符号表示在后台运行

测试日志采集

1. 首先创建一个测试日志文件：

echo 'Hello, iLogtail!' >> simple.log

2. 查看采集结果：

cat stdout.log

您应该能看到类似以下的输出：

2024-12-05 15:50:29 {"__tag__:__path__":"./simple.log","content":"Hello, iLogtail!","__time__":"1733385029"}

这个输出表明：

• 日志被成功采集
• 包含了原始内容"Hello, iLogtail!"
• 自动添加了文件路径和时间戳等元信息

理解采集结果

iLogtail的输出采用结构化格式，包含以下关键字段：

• __tag__:__path__：记录日志来源文件路径
• content：原始日志内容
• __time__：日志采集时间戳（UNIX时间戳格式）

这种结构化输出便于后续的日志处理和解析。

进阶配置建议

当您熟悉了基本采集流程后，可以考虑以下进阶配置：

1. 多文件采集：在FilePaths下添加多个文件路径或使用通配符
2. 日志过滤：添加processors部分对日志进行过滤或处理
3. 多种输出：配置输出到文件、远程服务器或其他存储系统
4. 日志解析：使用正则表达式或分隔符解析非结构化日志

常见问题排查

1. 日志未被采集：

   • 检查配置文件路径是否正确
   • 确认配置文件中的enable设置为true
   • 查看stderr.log中的错误信息

2. 输出不符合预期：

   • 检查采集配置中的输出类型设置
   • 确认输出目标是否有写入权限

3. 性能问题：

   • 检查系统资源使用情况
   • 考虑调整采集批次大小或间隔

总结

通过本指南，您已经完成了iLogtail的基本安装、配置和测试。iLogtail的强大之处在于其灵活的配置能力和丰富的功能扩展，后续您可以探索更多高级功能来满足不同的日志采集需求。