
## 一 背景

在 Kubernetes 的世界里，复杂的网络流量往往难以追踪和调试。开发和运维人员需要一款便捷的工具来洞察集群内部的流量走向，以便快速定位问题和优化性能。Muzi 应运而生，成为 K8s 流量查看的利器。

Mizu 是一个简单但功能强大的 Kubernetes API 流量查看器，可以让我们查看微服务之间的所有 API 通信，以帮助你调试和排查故障，相当于 `TCPDump` 和 `Chrome Dev Tools` 工具的结合。

Muzi 是一个开源的 Kubernetes 网络流量可视化工具，它可以帮助用户实时查看集群内部服务之间的流量拓扑和流量指标，例如：

*   服务之间的连接关系
*   请求数量、延迟、错误率
*   TCP 连接状态
*   HTTP 请求详情

Muzi 的界面简洁直观，用户无需复杂的配置即可轻松上手。它支持多种流量协议，包括 HTTP、gRPC、Dubbo 等，并提供丰富的过滤和查询功能，帮助用户快速找到所需信息。

## 二 特性

*   **轻量级:** Muzi 部署简单，资源消耗低，对集群性能影响 minimal。
*   **实时性:** Muzi 实时展示流量数据，帮助用户及时发现问题。
*   **可视化:** Muzi 提供直观的图形界面，方便用户理解流量拓扑和指标。
*   **易用性:** Muzi 操作简单，用户无需编写代码即可进行流量查看和分析。
*   **可扩展性:** Muzi 支持插件扩展，用户可以自定义功能和指标。

## 三 安装部署

Mizu 是一个 Golang 开发的二进制工具包，只需要单独下载即可运行。

### 2.1 mac

```shell
curl -Lo mizu https://github.com/up9inc/mizu/releases/download/0.16.15/mizu_darwin_amd64 && chmod 755 mizu

```

### 2.2 linux

```shell
curl -Lo mizu https://github.com/up9inc/mizu/releases/download/0.16.15/mizu_linux_amd64 && chmod 755 mizu

```

`Mizu` 使用的是 `KUBECONFIG` 环境变量来查找 kubeconfig 文件，如果没有设置则使用默认的 `$HOME/.kube/config` 文件，所以只需要保证我们的 kubectl 能正常控制 Kubernetes 集群，那么 `Mizu` 就可以正常运行了。

此外 `Mizu` 会假设运行该命令的用户有权在你的 Kubernetes 集群上创建资源对象（比如 pod、service、namespace）。

## 三 使用

### 3.1 查看浏览

要使用 `Mizu` 来查看流量，只需要按照下面的步骤操作即可：

1.  在 Kubernetes 集群中查找你想要查看的 Pod
2.  运行 `mizu tap` 或者 `mizu tap PODNAME` 命令
3.  在浏览器中打开 `http://localhost:8899/mizu` 页面
4.  在打开的页面中即可观察 API 的流量
5.  输入 `^C` 即可停止

假设我们正在运行的 Pod 列表如下所示：

要查看指定 Pod 的流量，只需要输入 Pod 名即可：

    mizu tap catalogue-b87b45784-sxc8q
    +catalogue-b87b45784-sxc8q
     Web interface is now available at http://localhost:8899
     ^C

如果要查看多个 Pod 的流量，则可以通过一个正则表达式来进行匹配：

    mizu tap "(catalo*|front-end*)"

该命令将观察以下 Pod 的流量，因为它们的名字符合正则表达式。

*   **catalo**gue-6676dc489b-6tx9h
*   **catalo**gue-db-69bd898747-7p8rq
*   **front-end**-946fd755f-8t6gp

如果要查看所有的 API 流量，则更简单了，直接执行 `mizu tap ".*"` 即可。查看某个命名空间的 Pod 中的所有 API 流量：

    mizu tap ".*" -n sock-shop

除此之外还有安全配置和高级用法，可以查看`官方网站`(<https://getmizu.io/)了解更多详情。>

![](https://developer.qcloudimg.com/http-save/yehe-1137075/6ac1426436d91da1cf26316522a178ca.png#?w=1834\&h=998\&s=314441\&e=png\&a=1\&b=022029)

## 四 注意事项

### 4.1 muzi启动异常

#### 4.1.1 故障原因

启动一次，muzi启动需要的镜像拉取异常。

![](https://developer.qcloudimg.com/http-save/yehe-1137075/6c90002c014f701b290d310d5c323ed4.png#?w=903\&h=155\&s=37639\&e=png\&a=1\&b=072029)

![](https://developer.qcloudimg.com/http-save/yehe-1137075/21264410de5a92a8ecd390518dde21e2.png#?w=1002\&h=450\&s=87919\&e=png\&a=1\&b=072029)

#### 4.1.2 解决

需要k8s集群内部能正常下载到该镜像。

<https://github.com/anjia0532/gcr.io_mirror>

## 五 二次开发需求

*   本地使用，由于内网地址，需要监听0.0.0.0 地址
*   tap 命令制定镜像拉取策略为IfNotPresent，由于是内网场景

### 六 总结

在复杂的 Kubernetes 集群中，洞察网络流量至关重要。Muzi 应运而生，成为 K8s 流量查看的利器。这款开源工具以其轻量、实时、易用的特性，帮助用户轻松掌握集群内部的流量走向。通过直观的可视化界面，Muzi 展示服务之间的连接关系、请求数量、延迟、错误率等关键指标，助力用户快速定位问题、优化性能和保障安全。支持多种协议、丰富的过滤和查询功能，以及持续发展的插件生态，使得 Muzi 成为开发和运维人员管理 K8s 网络流量的得力助手。

# 参考链接

*   <https://github.com/up9inc/mizu/releases>
*   <https://getmizu.io/>


在 Kubernetes 的世界里，复杂的网络流量往往难以追踪和调试。开发和运维人员需要一款便捷的工具来洞察集群内部的流量走向，以便快速定位问题和优化性能。Muzi 应运而生，成为 K8s 流量查看的利器。

Muzi：轻松洞察 K8s 流量的利器

Devops工程师

云计算

运维

网络与通信

Muzi是一款开源的Kubernetes网络流量可视化工具，实时监控集群内部服务间的HTTP、gRPC等协议流量，提供拓扑图、请求数、延迟等关键指标。轻量级设计，支持多协议过滤查询，帮助开发运维快速定位网络问题，优化K8s集群性能。

Kubernetes

11.11畅享AI算力 云启新增长

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

Muzi：轻松洞察 K8s 流量的利器-腾讯云开发者社区-腾讯云

Muzi：轻松洞察 K8s 流量的利器

Muzi：轻松洞察 K8s 流量的利器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐