[AI/向量数据库/GUI] Attu : Milvus 的图形化与一体化管理工具

1 Attu | Milvus 的一体化管理工具

简介

  • Attu

Milvus 向量数据库的官方图形化/一体化管理工具,由 Zilliz 团队开发维护。

从可视化模式设计到企业级监控,轻松管理您的矢量数据库。

https://zilliz.com.cn/attu

  • License: Apache 2.0

  • URL

功能特性

  • 综合数据与模式管理

    可视化模式设计师:设计、查看并修改集合模式,使用直观的可视化界面。一目了然地查看完整房产详情。

    全生命周期控制:轻松大规模管理多个数据库、收藏及其属性。即时克隆、无缝配置和简化操作。

    智能数据运营:强大的数据管理,包括智能筛选、语法高亮、完整数据查看、内联编辑以及无缝导入导出功能。

    交互式开发工具包

  • 带可视化的交互向量相似性搜索

    基于表达式的快速数据查询

    集成 RESTful API 编辑器

    对Milvus的无缝支持

    企业安全与监控

  • 可视化的RBAC与特权组管理

    实时节点、段与任务监控

    慢查询分析与系统诊断

    详细分段查询与检查

用户界面

  • Home View/主界面

  • Database Management/数据库管理

  • Collection Management/集合管理

  • Create Collection/创建集合

  • Collection Overview

  • Data View

  • Vector Search

  • System View

  • Role Chart (Light)

系统要求

  • Docker 20.10.0 or later
  • Kubernetes 1.19 or later (if using K8s deployment)
  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • For desktop application:
  • Windows 10/11
  • macOS 10.15 or later
  • Linux (Ubuntu 20.04 or later)

版本兼容性: Milvus && Attu

Milvus 版本 推荐 Attu 版本
2.6.x v2.6.1
2.5.x v2.5.10
2.4.x v2.4.12
2.3.x v2.3.5

安装部署 Attu

  • 假设 milvus server 端版本为: v2.5.21,则:

Attu 推荐版本为 : 2.5.10

Install by docker

shell 复制代码
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10
docker images
docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10 zilliz/attu:v2.5.10
docker images

docker run -d \
  --name attu \
  -p 8000:3000 \
  -e MILVUS_URL=your_milvus_ip:19530 \
  -e ATTU_LOG_LEVEL=info \
  -e ROOT_CERT_PATH=/app/tls/ca.pem \  # 可选参数
  -e PRIVATE_KEY_PATH=/app/tls/client.key \ # 可选参数
  -e CERT_CHAIN_PATH=/app/tls/client.pem \ # 可选参数
  -e SERVER_NAME=your_server_name \ # 可选参数
  zilliz/attu:v2.5.10
  • 参数说明
  • -p 8000:3000:将容器内 3000 端口映射到主机的 8000 端口
  • -e MILVUS_URL:Milvus 服务器的 IP 地址和端口(默认 19530)
  • 访问地址:http://localhost:8000
    如果需要连接本地 Milvus,可以使用 host.docker.internal:
shell 复制代码
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10
docker images
docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10 zilliz/attu:v2.5.10
docker images

docker run -d \
  --name attu \
  -p 8000:3000 \
  -e MILVUS_URL=host.docker.internal:19530 \
  --add-host=host.docker.internal:host-gateway \
  -e ATTU_LOG_LEVEL=info \
  zilliz/attu:latest

v2.3.8

Install by Docker Compose (亲测)

  • 如果通过 Docker Compose 部署 Milvus,可以直接在 docker-compose.yml 中添加 Attu 服务

vim ~/milvus/docker-compose.yml

yaml 复制代码
services:
  # ... Milvus 相关服务 ...
  
  attu:
    image: zilliz/attu:v2.5.10
    environment:
      MILVUS_URL: milvus-standalone:19530
      HOST: 0.0.0.0
    ports:
      - "8000:3000"
    depends_on:
      - "standalone"

"milvus-standalone:19530" 是指对应的containerName

"standalone" 是指对应的 serviceName

  • 下载镜像并重启
shell 复制代码
docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10
docker images
docker tag swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/zilliz/attu:v2.5.10 zilliz/attu:v2.5.10
docker images

# 单独启动 Attu (且镜像本地不存在时才找远程仓库拉取)
cd ~/milvus/
docker compose up attu --pull missing -d
  • 查看 attu 服务的日志输出
shell 复制代码
docker logs $(docker ps -aqf "name=attu")

安装后的验证/访问

  • 访问 Attu

http://host:8000

登录连接界面

主页

系统视图

数据库

  • Schema
  • 向量搜索
  • 数据
  • 分区
  • Segment
  • 属性

Play

用户和角色

权限组

角色

用户

Milvus Web UI

详情参见: Milvus Web UI 章节

2 Milvus Web UI : Milvus 内置的 Web UI

Home/主页

System Info

Component Information

Connected Clients

System Dependencies

Collections/集合

  • 点击 Collectin-Name 时,将可查看到集合下的向量数据列表:
  • Base Info / Indexes / Segements

Query/查询

Data/数据

Task/任务

Slow Request/慢请求

Configurations/配置

Tools

  • pprof

http://milvus-host:9091/debug/pprof/

  • Memory Data Visualization

Z FAQ for Attu / Milvus WEB-UI

Q:milvus webui 与 attu 的联系与区别?

Milvus WebUI 和 Attu 都是 Milvus 向量数据库的图形化管理工具,但它们在定位、功能和使用场景上有明显区别。

核心区别

特性 Attu Milvus WebUI
部署方式 独立工具(需单独安装) 内置功能(随 Milvus 启动)
目标用户 开发者、数据分析师 运维人员、开发者
主要定位 数据库管理与数据操作 系统监控与性能排查
访问地址 独立部署,默认端口 8000 http://${MILVUS_PROXY_IP}:9091/webui
首次版本 v0.1.8 Milvus v2.5.0+

功能对比

Attu 的核心功能

  • 数据管理:数据库、集合、分区的创建与管理
  • Schema 设计器:可视化设计、查看和修改集合结构
  • 向量操作:插入、索引、查询向量数据
  • 向量搜索:交互式相似度搜索,支持可视化结果
  • 权限管理:RBAC 用户和角色管理
  • 系统拓扑:可视化系统架构
  • AI Assistant(v2.6.0+):智能辅助功能
  • REST API Playground:集成的 API 调试工具

Milvus WebUI 的核心功能

  • 系统健康监控:节点状态、客户端连接、依赖服务
  • 集合检查:验证数据加载和索引状态
  • 查询分析:通道监控、副本性能追踪
  • 任务追踪:实时监控索引构建、compaction 等后台任务
  • 慢查询分析:识别性能瓶颈和优化点
  • 开箱即用:无需额外安装,启动 Milvus 即可访问

使用场景建议

选择 Attu 的场景:

  • 需要频繁进行数据操作(增删改查)
  • 需要可视化设计 Collection Schema
  • 需要进行向量相似度搜索验证
  • 需要管理用户权限和角色
  • 需要跨平台桌面应用(支持 Windows/macOS/Linux)

选择 Milvus WebUI 的场景:

  • 需要排查系统性能问题
  • 需要监控集群健康状态
  • 需要追踪慢查询和优化点
  • 需要查看后台任务执行状态
  • 希望零配置快速查看系统状态

两者关系

Milvus v2.6.0+ 开始,Attu 增加了【系统监控】功能(如 System Segments View、Task Management、Slow Requests),与 Milvus WebUI 的功能有一定重叠 。

但两者的核心定位仍然不同:

  • Attu 更侧重于数据层面的管理和操作
  • Milvus WebUI 更侧重于系统层面的可观测性和故障排查

在实际使用中,两者可以互补:开发阶段主要使用 Attu 进行数据管理,运维阶段结合 Milvus WebUI 进行系统监控

Y 推荐文献

  • Attu

X 参考文献