菜单
文档breadcrumb arrow Grafana Lokibreadcrumb arrow 设置breadcrumb arrow 安装breadcrumb arrow 使用 Docker 安装
开源

使用 Docker 或 Docker Compose 安装 Loki

您可以使用 Grafana Cloud 来避免自行安装、维护和扩展 Grafana Loki 实例。创建免费帐户即可开始使用,其中包含永久免费访问 1万 指标、50GB 日志、50GB 链路追踪、500 VUh k6 测试及更多内容。

如果您正在评估、测试或开发 Loki,可以使用 Docker 或 Docker Compose 安装 Loki 和 Promtail。对于生产环境,Grafana 推荐使用 Helm 或 Tanka 进行安装。

这些安装说明相关的配置文件将 Loki 作为单个二进制文件运行。

先决条件

在 Linux 上使用 Docker 安装

  1. 创建名为 loki 的目录。将 loki 设置为当前工作目录

    bash
    mkdir loki
    cd loki
  2. 将以下命令复制并粘贴到命令行中,将 loki-local-config.yamlpromtail-docker-config.yaml 下载到 loki 目录。

    bash
    wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/cmd/loki/loki-local-config.yaml -O loki-config.yaml
    wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml
  3. 将以下命令复制并粘贴到命令行中,使用上一步下载的配置文件启动 Docker 容器。

    bash
    docker run --name loki -d -v $(pwd):/mnt/config -p 3100:3100 grafana/loki:3.4.1 -config.file=/mnt/config/loki-config.yaml
    docker run --name promtail -d -v $(pwd):/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.4.1 -config.file=/mnt/config/promtail-config.yaml

    注意

    默认情况下,该镜像配置为以用户 loki 运行,其 UID 为 10001,GID 为 10001。您可以使用其他用户,特别是如果您使用绑定挂载,可以通过 docker run 命令并使用 --user=UID 指定适合您需要的数字 UID。

  4. 验证容器正在运行

    bash
    docker container ls

    您应该看到类似以下内容

    bash
    
    CONTAINER ID   IMAGE                    COMMAND                  CREATED              STATUS              PORTS                                       NAMES
    9485de9ad351   grafana/promtail:3.4.1   "/usr/bin/promtail -…"   About a minute ago   Up About a minute                                               promtail
    cece1df84519   grafana/loki:3.4.1       "/usr/bin/loki -conf…"   About a minute ago   Up About a minute   0.0.0.0:3100->3100/tcp, :::3100->3100/tcp   loki
  5. 验证 Loki 是否已启动并正在运行。

    • 要查看就绪状态,请导航至 https://:3100/ready。
    • 要查看指标,请导航至 https://:3100/metrics。

在 Windows 上使用 Docker 安装

  1. 将以下命令复制并粘贴到命令行中,将 loki-local-config.yamlpromtail-docker-config.yaml 下载到 loki 目录。请注意,您需要将命令中的 <local-path> 替换为您的本地路径。
bash
cd "<local-path>"
wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/cmd/loki/loki-local-config.yaml -O loki-config.yaml
wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/clients/cmd/promtail/promtail-docker-config.yaml -O promtail-config.yaml
  1. 将以下命令复制并粘贴到命令行中,使用上一步下载的配置文件启动 Docker 容器。请注意,您需要将命令中的 <local-path> 替换为您的本地路径。
bash
docker run --name loki -v <local-path>:/mnt/config -p 3100:3100 grafana/loki:3.4.1 --config.file=/mnt/config/loki-config.yaml
docker run -v <local-path>:/mnt/config -v /var/log:/var/log --link loki grafana/promtail:3.4.1 --config.file=/mnt/config/promtail-config.yaml
  1. 验证 Loki 是否已启动并正在运行。

    • 要查看就绪状态,请导航至 https://:3100/ready。
    • 要查看指标,请导航至 https://:3100/metrics。

使用 Docker Compose 安装

在命令行中运行以下命令。这些命令适用于 Windows 或 Linux 系统。

  1. 创建名为 loki 的目录。将 loki 设置为当前工作目录

    bash
    mkdir loki
    cd loki
  2. 将以下命令复制并粘贴到命令行中,下载 docker-compose 文件。

    bash
    wget https://raw.githubusercontent.com/grafana/loki/v3.4.1/production/docker-compose.yaml -O docker-compose.yaml
  3. loki 作为当前工作目录的情况下,运行以下 'docker-compose' 命令

    bash
    docker-compose -f docker-compose.yaml up

    您应该看到类似以下内容

    bash
    ✔ Container loki-loki-1      Started              0.0s
    ✔ Container loki-grafana-1   Started              0.0s
    ✔ Container loki-promtail-1  Started              0.0s
  4. 验证 Loki 是否已启动并正在运行。

    • 要查看就绪状态,请导航至 https://:3100/ready。
    • 要查看指标,请导航至 https://:3100/metrics。