For the complete documentation index, see llms.txt. This page is also available as Markdown.

快速开始

采集主机日志

  1. 下载预编译的 LoongCollector 包,解压后进入目录,该目录下文均称为部署目录。

    版本号请始终以 GitHub Releases — alibaba/loongcollector 为准(含 linux-amd64 / linux-arm64 / windows-amd64 资产及 checksum)。下例中的 VERSION 仅为演示;你也可使用 Release 正文中给出的 OSS 镜像 URL(与 GitHub 资产一致)。

    VERSION=3.3.2
    curl -fL -o "loongcollector-${VERSION}.linux-amd64.tar.gz" \
      "https://github.com/alibaba/loongcollector/releases/download/v${VERSION}/loongcollector-${VERSION}.linux-amd64.tar.gz"
    tar -xzvf "loongcollector-${VERSION}.linux-amd64.tar.gz"
    cd "loongcollector-${VERSION}"

    若解压后的顶层目录名与上述 cd 不一致,请以包内实际目录名为准。

  2. 对 LoongCollector 进行配置

    部署目录中conf/instance_config/local/loongcollector_config.json是 LoongCollector 的系统参数配置文件,conf/continuous_pipeline_config/local是 LoongCollector 的本地采集配置目录。 这里我们在采集配置目录中创建file_simple.yaml文件,配置采集当前目录simple.log文件并输出到标准输出:

    enable: true
    inputs:
      - Type: input_file     # 文件输入类型
        FilePaths:
        - ./simple.log
    flushers:
      - Type: flusher_stdout # 标准输出流输出类型
        OnlyStdout: true

    您也可以直接从下面的地址下载示例配置。

    cd conf/continuous_pipeline_config/local
    wget https://raw.githubusercontent.com/alibaba/loongcollector/main/example_config/quick_start/config/file_simple.yaml
    cd -
  3. 后台启动 LoongCollector

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

    以上命令将标准输出重定向到 stdout.log以便观察。

  4. 构造示例日志

    echo 'Hello, LoongCollector!' >> simple.log
  5. 查看采集到的文件日志

    cat stdout.log

    结果为

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

更多采集配置

了解采集配置结构:采集配置

参考更多可组合的日志采集和处理配置样例:https://github.com/alibaba/loongcollector/blob/main/example_config

Last updated