Promtail 对接日志最佳实践

2025-07-23
上海
本文字数：1429 字
阅读完需：约 5 分钟

Promtail 介绍

Promtail 是由 Grafana Labs 开发的日志收集代理，主要用于从本地系统或容器中采集日志，并将其发送到 Loki 或兼容 Loki 协议的系统，本次为对接到观测云。

观测云

观测云是一款专为 IT 工程师打造的全链路可观测产品，它集成了基础设施监控、应用程序性能监控和日志管理，为整个技术栈提供实时可观察性。这款产品能够帮助工程师全面了解端到端的用户体验追踪，了解应用内函数的每一次调用，以及全面监控云时代的基础设施。此外，观测云还具备快速发现系统安全风险的能力，为数字化时代提供安全保障。

实验环境

操作系统：Ubuntu 22.04
日志源：/var/log/message
采集工具：Promtail
目标平台：观测云（通过本地 DataKit，地址为 http://localhost:9529/v1/write/promtail）

部署 DataKit

DataKit 是一个开源的、跨平台的数据收集和监控工具，由观测云开发并维护。它旨在帮助用户收集、处理和分析各种数据源，如日志、指标和事件，以便进行有效的监控和故障排查。DataKit 支持多种数据输入和输出格式，可以轻松集成到现有的监控系统中。

登录观测云控制台，在「集成」 - 「DataKit」选择对应安装方式，当前采用 Linux 主机部署 DataKit。

开启 Promtail 采集器

进入 DataKit 安装目录下的 /usr/local/datakit/conf.d/log 目录，复制promtail.conf.sample 并命名为 promtail.conf。示例如下：

cp promtail.conf.sample  promtail.conf

复制代码

备注：

对于 v0.3.0 及之前的版本需要配置 legacy = true，即使用 POST /api/prom/push，可以用 Legacy 版本 API 处理接收 Promtail 的日志数据。
之后的版本使用默认配置，即 legacy = false，即使用 POST /loki/api/v1/push。

实验环境部署

下载安装（本次验证仅为主机安装，也可 kubernetes 部署）

wget https://github.com/grafana/loki/releases/latest/download/promtail-linux-amd64.zipunzip promtail-linux-amd64.zipchmod +x promtail-linux-amd64sudo mv promtail-linux-amd64 /usr/local/bin/promtail#验证 Promtail 安装成功promtail --version

复制代码

配置 Promtail

vim /etc/promtail/promtail.yaml

复制代码

server:  http_listen_port: 9080  grpc_listen_port: 0
positions:  filename: /tmp/positions.yaml
clients:  - url: http://localhost:9529/v1/write/promtail?source=promtail
scrape_configs:  - job_name: system    static_configs:      - targets:          - localhost        labels:          job: varlogs          __path__: /var/log/message

复制代码

运行 Promtail

#前台测试promtail -config.file=/etc/promtail/promtail.yaml#后台测试sudo tee /etc/systemd/system/promtail.service > /dev/null <<EOF[Unit]Description=Promtail Log CollectorAfter=network.target
[Service]ExecStart=/usr/local/bin/promtail -config.file=/etc/promtail/promtail.yamlRestart=alwaysRestartSec=5User=root
[Install]WantedBy=multi-user.targetEOF#追加日志测试echo "test log from promtail at $(date)" | sudo tee -a /var/log/message

复制代码

验证

查看采集器状态

在观测云中查看日志功能 Promtail 数据源日志

总结

观测云通过对接 Promtail 后，无需额外适配即可协助用户使用 Promtail 将主机和容器日志实时推送到观测云；通过标签化管理和与指标、追踪数据的统一关联，帮助工程师迅速实现多维度分析、故障定位和业务洞察，有效降低了日志管理复杂度和运维成本，提升了全链路观测的效率与准确性。

发布于: 刚刚阅读数: 2

观测云

关注

还未添加个人签名 2021-02-08 加入

云时代的系统可观测平台

发布

暂无评论

创作场景

Promtail 对接日志最佳实践

Promtail 介绍

观测云

实验环境

部署 DataKit

开启 Promtail 采集器

实验环境部署

验证

总结

观测云

评论