06.2安装Loki和Promtail

分类: Grafana Loki日志管理

安装 Loki 和 Promtail

本节将学习:在 Linux 上安装 Loki 和 Promtail,以及使用 Docker 安装。我们会详细演示每个平台的安装过程。

在 Linux 上安装 Loki

在 Linux 上安装 Loki 的步骤是什么?

第一步:下载 Loki。 从 GitHub 下载 Loki 二进制文件,解压。

第二步:创建配置目录。 创建 /etc/loki 和 /var/lib/loki 目录。

第三步:复制文件。 复制 loki-linux-amd64 到 /usr/local/bin/loki,设置执行权限。

第四步:创建配置文件。 创建 /etc/loki/loki-config.yaml 配置文件,配置端口、存储路径等。

第五步:创建 systemd 服务。 创建 systemd 服务文件,配置启动命令。

第六步:启动服务。 启动 Loki 服务,设置开机自启。

配置文件说明:

  • auth_enabled: false
    :禁用认证(开发环境)。
  • http_listen_port: 3100
    :HTTP 端口。Grafana 通过这个端口连接 Loki。
  • path_prefix: /var/lib/loki
    :数据存储路径。
  • storage.filesystem
    :使用文件系统存储(开发环境)。生产环境建议使用对象存储。

安装完成后,Loki 会在 3100 端口启动。

安装 Promtail

Promtail 是什么? Promtail 是 Loki 的日志收集代理。它收集本地日志文件,添加标签,发送到 Loki。

安装 Promtail 的步骤是什么?

第一步:下载 Promtail。 从 GitHub 下载 Promtail 二进制文件,解压。

第二步:复制文件。 复制 promtail-linux-amd64 到 /usr/local/bin/promtail,设置执行权限。

第三步:创建配置文件。 创建 /etc/promtail/promtail-config.yaml 配置文件,配置 Loki 地址、日志路径等。

第四步:启动 Promtail。 运行 Promtail,指定配置文件。

配置文件说明:

  • http_listen_port: 9080
    :Promtail 的 HTTP 端口。
  • clients.url: http://localhost:3100/loki/api/v1/push
    :Loki 的地址。Promtail 会把日志发送到这里。
  • scrape_configs
    :配置要收集的日志。这里配置收集 /var/log/*.log。
  • labels
    :添加标签,例如
    job: varlogs

Promtail 会收集日志并发送到 Loki。

使用 Docker 安装

如果你熟悉 Docker,可以使用 Docker 安装。 这样更简单,也更灵活。

Docker 安装的步骤是什么?

第一步:创建配置目录。 创建 /opt/loki/config 和 /opt/loki/data 目录。

第二步:创建 Loki 配置文件。 创建 loki-config.yaml 配置文件,配置端口、存储路径等。

第三步:运行 Loki 容器。 使用 Docker 运行 Loki 容器,映射端口 3100,挂载配置文件和数据目录。

第四步:运行 Promtail 容器。 使用 Docker 运行 Promtail 容器,挂载配置文件,挂载日志目录(只读)。

Docker Compose 示例: 使用 Docker Compose 更简单。我们可以创建一个 docker-compose.yml 文件,同时运行 Loki 和 Promtail。

使用 Docker 更简单,也更灵活。

验证安装

验证步骤:

第一步:检查 Loki 状态。 访问 http://localhost:3100/ready,应该返回 ready。如果返回 ready,说明 Loki 正常运行。

第二步:检查 Promtail 状态。 访问 http://localhost:9080/ready,应该返回 ready。如果返回 ready,说明 Promtail 正常运行。

第三步:在 Grafana 中添加 Loki 数据源。 Configuration > Data Sources,Add data source > Loki,URL: http://localhost:3100,测试连接。如果测试成功,说明可以连接 Loki。

第四步:查询日志。 在 Explore 中查询

{job="varlogs"}
,应该能看到日志。如果能看到日志,说明 Promtail 正在收集日志并发送到 Loki。

如果这些步骤都成功了,说明 Loki 和 Promtail 安装成功了。

本节小结

在本节中,我们学习了如何安装 Loki 和 Promtail:

第一个是 Linux 安装。 下载二进制文件,配置 systemd 服务,可以开机自启。

第二个是 Docker 安装。 使用容器安装,简单灵活。

第三个是 Promtail。 日志收集代理,发送日志到 Loki。Promtail 负责收集日志,Loki 负责存储。

第四个是验证安装。 检查服务状态,添加数据源,查询日志。确保一切正常运行。

安装方法对比: Linux 安装适合生产环境,Docker 安装适合开发环境。选择适合你的方法。

这就是安装 Loki 和 Promtail。安装完成后,你就可以开始收集和查询日志了。

在下一节,我们将学习 Promtail 配置。学习如何配置日志收集。