当前位置：首页 > news >正文

掌握 otel-desktop-viewer 的 7 个高级功能：Trace、Metrics、Logs 三合一分析

news 2026/7/16 20:42:46

掌握 otel-desktop-viewer 的 7 个高级功能：Trace、Metrics、Logs 三合一分析

【免费下载链接】otel-desktop-viewerotel-desktop-viewer is a CLI tool for receiving OpenTelemetry traces while working on your local machine.项目地址: https://gitcode.com/gh_mirrors/ot/otel-desktop-viewer

otel-desktop-viewer 是一款强大的本地 OpenTelemetry 数据可视化工具，让开发者在本地机器上就能轻松接收和分析 Trace、Metrics、Logs 三大可观测性数据。这个 CLI 工具基于 OpenTelemetry Collector 构建，采用 DuckDB 后端和 Svelte 5 前端界面，为本地开发环境提供了完整的可观测性解决方案。

🚀 1. 一键启动与多平台支持

快速开始是 otel-desktop-viewer 的首要优势。无论你使用哪种操作系统，都能轻松安装：

macOS 用户：通过 Homebrew Cask 一键安装
Linux 用户：支持 apt 和 dnf 包管理器
Windows 用户：直接下载可执行文件或使用 Docker
开发者：通过go install从源码构建

启动后，UI 默认运行在localhost:8000，同时提供 OTLP 接收器：localhost:4317（gRPC）和localhost:4318（HTTP）。

🔧 2. Docker 集成与容器化部署

otel-desktop-viewer 完美支持 Docker 环境，让你的容器化应用也能享受本地可观测性：

services: app: image: your-apps-image-tag otel-desktop-viewer: image: ghcr.io/ctrlspice/otel-desktop-viewer:latest ports: - "8000:8000" - "4317:4317" - "4318:4318"

只需在 Docker Compose 配置中添加 otel-desktop-viewer 服务，你的应用就能将 OTLP 数据导出到otel-desktop-viewer:4318（HTTP）或otel-desktop-viewer:4317（gRPC）。

📊 3. 智能数据持久化与内存管理

默认情况下，otel-desktop-viewer 将数据存储在内存中，但你也可以选择持久化存储：

otel-desktop-viewer --db ./telemetry.duckdb

核心存储特性：

DuckDB 后端：高性能列式存储引擎
灵活配置：内存模式或文件持久化
自动清理：支持按需清除特定类型数据
数据隔离：不同项目可独立存储

🔗 4. 无缝 OpenTelemetry SDK 集成

配置你的应用与 otel-desktop-viewer 集成非常简单。通过环境变量即可完成：

# HTTP 协议配置 export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318" export OTEL_TRACES_EXPORTER="otlp" export OTEL_METRICS_EXPORTER="otlp" export OTEL_LOGS_EXPORTER="otlp" export OTEL_EXPORTER_OTLP_PROTOCOL="http/protobuf" # gRPC 协议配置 export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4317" export OTEL_TRACES_EXPORTER="otlp" export OTEL_METRICS_EXPORTER="otlp" export OTEL_LOGS_EXPORTER="otlp" export OTEL_EXPORTER_OTLP_PROTOCOL="grpc"

支持所有主流的 OpenTelemetry SDK，包括 Java、Go、Python、JavaScript、.NET 等。

🛠️ 5. 命令行工具深度集成

otel-desktop-viewer 与otel-cli完美配合，为 shell 脚本和命令行工具提供强大的追踪能力：

# 快速追踪命令执行 otel-cli exec --service my-service --name "check the archive" curl -s -o /dev/null https://archive.org/ # 链式追踪 otel-cli exec --kind producer --service demo --name produce -- \ otel-cli exec --kind consumer --service demo --name consume sleep 0.2

高级追踪功能：