OpenTelemetry 终端可视化工具 otel-tui 安装与配置指南

郁俪晟Gertrude

于 2025-04-07 11:20:01 发布

阅读量998

点赞数 22

本文链接：https://blog.csdn.net/gitblog_00325/article/details/147039918

版权

OpenTelemetry 终端可视化工具 otel-tui 安装与配置指南

otel-tui A terminal OpenTelemetry viewer inspired by otel-desktop-viewer 项目地址: https://gitcode.com/gh_mirrors/ot/otel-tui

OpenTelemetry 是一个开源的追踪、指标和日志的收集器，用于观测云原生应用。otel-tui 是一个基于终端界面的 OpenTelemetry 可视化工具，它允许用户在终端中查看追踪、指标和日志信息。本项目主要使用 Go 语言开发。

项目基础介绍

otel-tui 项目是一个终端 OpenTelemetry 观察工具，它受到了 otel-desktop-viewer 的启发。此工具支持 OpenTelemetry、Zipkin（追踪）和 Prometheus（指标）格式。它通过 gRPC 或 HTTP 接收 OpenTelemetry 信号，并提供了一个简单的终端用户界面来展示这些数据。

项目使用的关键技术和框架

OpenTelemetry: 用于收集和导出应用性能数据的框架。
gRPC: Google 开发的用于高性能、分布式系统的 RPC 框架。
HTTP: 用于接收 Zipkin 追踪数据的 Web 协议。
Termui: 用于创建终端用户界面的库。

安装和配置准备工作

在开始安装 otel-tui 之前，请确保您的环境中已经安装了以下依赖：

Go 语言环境：本项目使用 Go 语言开发，需要安装 Go 语言环境，具体安装步骤请参考 Go 官方文档。
Docker（可选）：如果您希望通过 Docker 容器运行 otel-tui，则需要安装 Docker。Docker 的安装步骤请参考 Docker 官方文档。

安装步骤

1. 使用 Go 直接安装

克隆项目到本地：

git clone https://github.com/ymtdzzz/otel-tui.git

切换到项目目录：
```
cd otel-tui
```
运行 Go 命令编译并安装：
```
go run ./...
```

2. 使用 Homebrew 安装（macOS 用户）

如果您使用 macOS，可以使用 Homebrew 安装 otel-tui：

brew install ymtdzzz/tap/otel-tui

3. 使用 Docker 容器安装

运行以下命令以启动 otel-tui 容器：

docker run --rm -it --name otel-tui ymtdzzz/otel-tui:latest

如果您希望后台运行 otel-tui，可以使用以下命令：
```
docker run --rm -dit --name otel-tui ymtdzzz/otel-tui:latest
```
启动后，您可以通过以下命令连接到运行中的容器：
```
docker attach otel-tui
```
要断开连接而不停止容器，可以按 Ctrl+p 然后 Ctrl+q。

4. 使用 Docker Compose

创建 docker-compose.yml 文件并在其中配置 otel-tui 服务：

version: '3'
services:
  otel-tui:
    image: ymtdzzz/otel-tui:latest
    container_name: otel-tui
    stdin_open: true
    tty: true
    entrypoint: ["/otel-tui", "--enable-zipkin"]