cilium/hubble-ui

Hubble UI

1. 概述

Hubble UI 是 https://github.com/cilium/hubble 的开源用户界面，旨在提供直观的可视化工具，帮助用户监控和分析 Kubernetes 集群中的服务通信与依赖关系。其主要用途是通过图形化界面展示服务依赖图，简化对微服务架构中网络流量和连接性的理解与故障排查。

2. 核心功能与特性

2.1 核心功能

• 自动服务依赖发现：零成本自动发现 Kubernetes 集群中服务的依赖关系图，支持 L3（网络层）、L4（传输层）乃至 L7（应用层）网络流量分析。
• 服务地图可视化：以用户友好的方式将服务间数据流可视化为服务地图，直观展示集群内服务依赖关系。
• 数据流过滤：支持对服务通信数据进行灵活过滤，便于聚焦特定服务或流量类型的分析。

2.2 特性

• 开源免费，与 Cilium Hubble 深度集成。
• 无需额外配置即可自动识别服务依赖，降低使用门槛。
• 适配 Kubernetes 环境，支持动态变化的微服务架构。

3. 使用场景与适用范围

3.1 主要使用场景

• 微服务连接性故障排查：当微服务间通信异常时，通过服务地图快速定位依赖关系问题。
• 服务依赖分析：梳理集群内服务间的调用链、外部 API 或数据库连接，优化架构设计。
• 网络流量监控：实时查看服务间流量模式，识别潜在瓶颈或异常流量。

3.2 适用范围

• 基于 Kubernetes 部署的微服务架构环境。
• 使用 Cilium 作为 CNI（容器网络接口）的集群。
• 需要可视化网络依赖关系的开发、运维或 SRE 团队。

4. 安装

Hubble UI 作为 Hubble 的一部分进行部署，无需单独安装。详细部署步骤请参考 https://docs.cilium.io/en/stable/gettingstarted/hubble/#deploy-cilium-and-hubble%EF%BC%8C%E8%AF%A5%E6%8C%87%E5%8D%97%E5%8C%85%E5%90%AB Cilium 与 Hubble 的完整部署流程。

5. 使用方法

5.1 部署与访问

Hubble UI 部署完成后，通常通过 Hubble 提供的访问方式（如端口转发、Ingress 等）进行访问。具体访问方式请参考 Hubble 部署后的配置指南。

5.2 开发指南

如需对 Hubble UI 进行二次开发，可参考以下步骤：

5.2.1 后端开发

若需将前端指向部署在 minikube 中的后端，执行端口转发：

bash
kubectl port-forward -n kube-system deployment/hubble-ui 8081

若需修改 Go 后端代码，需执行以下额外步骤：

1. 进入后端目录并启动服务：

   bash
   cd ./backend
   ./ctl.sh run  # 等待构建完成并启动服务器
   

2. 在另一个终端中，进入包含 Envoy 配置的服务器目录并启动 Envoy（需预先安装 Envoy）：

   bash
   cd ./server
   envoy -c ./envoy.yaml
   

3. 在第三个终端中，端口转发至 hubble-relay：

   bash
   kubectl port-forward -n kube-system deployment/hubble-relay 50051:4245
   

5.2.2 前端开发

1. 安装依赖：

   bash
   npm install
   

2. 启动开发服务器：

   bash
   npm run watch
   

3. 打开浏览器访问 http://localhost:8080

6. 社区

了解更多关于 https://github.com/cilium/cilium#community 的信息。

7. 许可

Hubble UI 采用 https://github.com/cilium/hubble-ui/blob/master/LICENSE 许可协议。