本地部署开源分布式追踪后端系统 Tempo 并实现外部访问

Tempo 是一款开源的分布式追踪后端系统,它是一个现代化、高性能、可扩展的解决方案,由 Grafana Labs 开发并维护,专门用于存储和查询大规模的分布式追踪数据。本文将详细介绍如何利用 Docker 在局域网内部署 Tempo 并结合路由侠实现外网访问局域网内部署的 Tempo 。

第一步,本地部署安装 Tempo

1,本教程操作环境为 Linux Ubuntu 系统,Tempo 依赖 Docker 运行,我们需要先确保你的系统上已经安装了 Docker 。如果尚未安装,可以参考文档进行安装,点此查看

2,安装 Docker Compose 。

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep -Po '"tag_name": "\K.*\d')" /usr/local/bin/docker-compose

3,创建并进入项目目录,设置正确权限。

mkdir tempo-test && cd tempo-test
sudo mkdir -p /tmp/tempo-data/blocks
sudo mkdir -p /tmp/tempo-data/wal
sudo chmod -R 777 /tmp/tempo-data

4,创建 tempo.yaml 文件。

sudo vim tempo.yaml

写入以下内容:

server:
  http_listen_port: 3200

distributor:
  receivers:
    otlp:
      protocols:
        grpc:
        http:

ingester:
  max_block_duration: 5m

compactor:
  compaction:
    block_retention: 1h

storage:
  trace:
    backend: local
    local:
      path: /tmp/tempo/blocks
    wal:
      path: /tmp/tempo/wal

5,在项目目录下输入以下命令运行 Tempo 容器。

docker run -d \
  --name tempo \
  -p 3200:3200 \
  -v $(pwd)/tempo.yaml:/etc/tempo.yaml \
  -v /tmp/tempo-data:/tmp/tempo \
  grafana/tempo:latest \
  -config.file=/etc/tempo.yaml

6,在终端输入以下命令检查健康状态接口,如果返回类似 "status":"ready" 或 "status":"success" ,说明 Tempo 正常运行。

curl http://localhost:3200/status

第二步,外网访问本地 Tempo

安装路由侠内网穿透。

1,当前未提供网页管理,需要先在任意一台 Windows 机器安装路由侠 Windows 版本,用作跨机器管理。点此下载

2,在路由侠客户端主界面,进入“ 设备管理 ”,点击右下角的“ 添加设备 ”,此时可查看到对应的安装码,此安装码用于将设备添加到对应账号下,可选中后复制。

3,直接下载后导入:

wget https://dl.luyouxia.com:8443/v2/lyx-docker-x86_64.tar
docker load -i lyx-docker-x86_64.tar

4,然后使用该镜像启动容器。

docker run --name lyx -it --restart=always --net=host -e code=这里填写安装码 luyouxia/lyx

5,此时,需要等待下载和安装的过程,如果一切正常,最终可以看到一些输出,并且可以看到如下提示:

[Device] Logged in. Token: ....

这就表示安装成功了。

当前 Linux 终端这边,如果是使用的上面的命令,Docker 是运行在前台,此时可以按住 Ctrl + C ,退出路由侠,容器也将退出。现在可以使用以下命令将其放入后台持续运行:

docker start lyx

注意如果容器删除,重新 docker run , 将创建为新的设备。

需要注意的是,因为容器参数已经添加了 --restart=always ,这样开机就会自动启动,不需要再手动启动路由侠了。

6,现在回到 Windows 这边设备列表,点击右上角的 × 返回主界面,再次进入,就可以找到这个设备,可以修改名称。

7,回到主界面,点击【内网映射】。

8,注意右上角的设备名称下拉框,这里选中刚刚添加的设备名称,此时在这个界面上添加的映射,就属于刚刚这个设备。添加或修改一般需要等待 30 秒,容器中的路由侠进程就会更新并加载。切换好设备后,点击【添加映射】。

9,选择【原生端口】。

10,在内网地址填写你的服务器 IP 和 Tempo 端口 3200 后点击【创建】按钮,如下图。

11,创建好后,就可以看到一条映射的公网地址,鼠标右键点击【复制地址】。

12,在外网电脑上,打开终端输入以下命令,测试成功就能通过 API 接口接收和查询追踪数据了。

curl http://你的路由侠域名/ready

以上就是 Linux 系统在本地部署 Tempo 服务以及利用路由侠的内网穿透平台实现外网访问本地部署的 Tempo 的全部教程了,如果想要对路由侠有更多的了解,可以进官网详细了解,路由侠官网地址:www.luyouxia.com