安装 Grafana Tempo

欢迎回到第 8 章的学习。在上一节，我们了解了 Tempo 的架构和机制。现在我们要学习如何安装和部署 Tempo。

本节将学习：在 macOS、Linux 上安装 Tempo，以及使用 Docker 部署 Tempo。我们会详细演示每个平台的安装过程。

macOS 安装

在 macOS 上安装 Tempo 的方法有两种。

第一种方法：使用 Homebrew 安装。 这是最简单的方法。

brew install grafana-tempo

第二种方法：下载二进制文件。 从 GitHub 下载二进制文件，解压后运行。

安装完成后，我们需要创建配置文件。 配置文件定义了 Tempo 的运行参数，比如端口、存储后端等。

然后启动 Tempo。 使用

tempo --config.file=tempo.yaml

最后验证安装。 访问 http://localhost:3200，应该能看到 Tempo 状态页面。

在 macOS 上安装 Tempo，非常简单。

Linux 安装

在 Linux 上安装 Tempo 的步骤是什么？

第一步：下载二进制文件。 从 GitHub 下载 Linux 版本的二进制文件，解压。

第二步：复制到系统路径。 复制到

/usr/local/bin/

第三步：创建配置文件。 创建

/etc/tempo/tempo.yaml

第四步：创建 systemd 服务。 创建

/etc/systemd/system/tempo.service

第五步：启动服务。 使用 systemctl 启动服务，设置开机自启。

最后验证安装。 访问 http://localhost:3200，应该能看到 Tempo 状态页面。

在 Linux 上安装 Tempo，配置为系统服务，便于管理。

Docker 部署

使用 Docker 部署 Tempo 有什么方式呢？

第一种方式：使用 Docker Run。 直接运行 Docker 命令。需要手动配置端口、卷等。

第二种方式：使用 Docker Compose。 这是推荐的方式。在一个 YAML 文件中配置所有参数，非常简单。

Docker Compose 配置： 配置镜像、端口、卷、命令等。端口包括 3200（HTTP API）、4317（OTLP gRPC）、4318（OTLP HTTP）。

启动服务： 使用

docker-compose up -d

验证安装： 访问 http://localhost:3200，应该能看到 Tempo 状态页面。

使用 Docker 部署 Tempo，非常简单，推荐使用。

验证安装

验证安装的步骤是什么？

第一步：检查服务状态。 访问 http://localhost:3200，查看状态页面，检查版本信息。

第二步：测试 OTLP 接收。 使用 otel-cli 发送测试 Trace，验证 Trace 是否被接收。

第三步：检查日志。 查看 Tempo 日志，确认没有错误。

验证命令： 使用

curl http://localhost:3200/ready

otel-cli

验证存储： 检查存储目录，确认 Trace 数据被存储。

这就是验证安装。确保服务正常运行，可以接收和存储 Trace 数据。

本节小结

在本节中，我们学习了安装 Grafana Tempo：

第一个是 macOS 安装。 使用 Homebrew 或二进制文件安装。

第二个是 Linux 安装。 使用二进制文件和 systemd 服务安装。

第三个是 Docker 部署。 使用 Docker Compose 部署，推荐使用。

第四个是验证安装。 检查服务状态、测试 OTLP 接收、检查日志、检查存储。

安装方法总结： 安装 Tempo → macOS（Homebrew/二进制）或 Linux（二进制/systemd）或 Docker（Docker Compose）→ 验证安装。

这就是安装 Grafana Tempo。安装完成后，你就可以开始配置 Tempo 了。

在下一节，我们将学习配置 Alloy 转发 Traces 到 Tempo。学习如何配置 Alloy 将 Trace 数据转发到 Tempo。