
AIOpsLab
给运维智能体搭个可复现的故障演练场,直接比出谁更能修。
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 1036
使用教程
环境要求
- Python >= 3.11
- Helm(用于部署微服务云环境)
- Poetry(推荐)或 pip
- 一个可用的 Kubernetes 集群,本机 kubectl context 已指向该集群(远程集群需配 Ansible,另见 scripts/ansible/
- 运行远程服务时需可访问的宿主机与端口
安装与启动步骤
-
1安装 Python 3.11
在 Linux 上用 apt 安装 Python 3.11 及其 venv、dev 组件,AIOpsLab 要求 Python 版本不低于 3.11。
sudo apt update sudo apt install python3.11 python3.11-venv python3.11-dev -y -
2安装 Poetry
使用官方安装脚本,不要用 apt 版本(已过时);安装后把 Poetry 的 bin 目录加入 PATH。
curl -sSL https://install.python-poetry.org | python3.11 - export PATH="$HOME/.local/bin:$PATH" -
3克隆仓库
必须带 --recurse-submodules,否则子模块缺失会导致后续运行异常;示例使用官方仓库地址。
git clone --recurse-submodules https://github.com/microsoft/AIOpsLab.git -
4安装项目依赖
进入目录,指定 Python 3.11 作为 Poetry 环境,安装依赖并激活虚拟环境。若报 lock file 不兼容先跑 poetry lock。
cd AIOpsLab poetry env use python3.11 poetry install eval $(poetry env activate) -
5准备 Kubernetes 集群
用远程集群需先按 docs 里的 Ansible README 搭建集群,然后更新 config.yml 中的集群配置;kubectl context 需指向目标集群。
-
6运行本地 CLI 智能体
启动交互式 CLI 后,输入 start 加问题 ID 开始任务,等待环境准备完成后用 submit("Yes") 提交解答。
python3 cli.py -
7启动远程服务
在资源更大的远程机器上启动 AIOpsLab 服务,通过环境变量指定监听地址、端口和工作进程数。
SERVICE_HOST=<YOUR_HOST> SERVICE_PORT=<YOUR_PORT> SERVICE_WORKERS=<YOUR_WORKERS> python service.py -
8远程调用智能体
先在远程机器启动 vLLM(可选),再从本地用 curl 提交 simulate 请求,指定问题、智能体与采样参数。
chmod +x ./clients/launch_vllm.sh ./clients/launch_vllm.sh curl -X POST http://<YOUR_HOST>:<YOUR_PORT>/simulate -H "Content-Type: application/json" -d '{"problem_id": "misconfig_app_hotel_res-mitigation-1", "agent_name": "vllm", "max_steps": 10, "temperature": 0.7, "top_p": 0.9}'
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
SERVICE_HOST | 是 | 远程 AIOpsLab 服务监听的宿主机地址 | 0.0.0.0 |
SERVICE_PORT | 是 | 远程服务监听端口,curl 与客户端需一致 | 8000 |
SERVICE_WORKERS | 否 | 服务的工作进程数 | 4 |
config.yml | 是 | 集群连接与运行配置,搭建集群后需按其说明更新 | 见仓库根目录 config.yml |
agent_name | 是 | simulate 请求指定的智能体名称 | vllm |
problem_id | 是 | simulate 请求指定的评测问题 ID | misconfig_app_hotel_res-mitigation-1 |
如何确认成功
远程服务可执行 curl http://<YOUR_HOST>:<YOUR_PORT>/health 检查健康状态,并可用 /problems、/agents 列出可用问题与智能体;本地 CLI 能正常 start 问题并 submit 解
常见问题
Q:poetry install 报 "lock file not compatible" 怎么办?
A:先执行 poetry lock 重新生成锁文件,然后再执行 poetry install。
Q:不想用 Poetry,可以用 pip 安装吗?
A:可以,在仓库根目录执行 pip install -e . 即可完成安装。
Q:如何更换 vLLM 使用的模型?
A:在运行前编辑 clients/launch_vllm.sh,改成你需要的模型配置后再执行该脚本。
Q:AIOpsLab 支持哪些集群?
A:支持任何 kubectl context 指向的远程 Kubernetes 集群,既包括云厂商集群,也可按 scripts/ansible/README.md 自建集群。
注意事项
- 克隆仓库必须加 --recurse-submodules,否则子模块不会拉取。
- Poetry 必须用官方安装脚本安装,apt 仓库中的版本过旧。
- 运行前确认 kubectl context 已指向目标 Kubernetes 集群,并已在 config.yml 中更新对应配置。
- 远程调用前需先启动 service.py 并确认 /health 可访问,使用 vLLM 时还需额外启动 vLLM 服务。
核心亮点
- 提供端到端评测闭环,从故障注入到根因定位再到修复效果都有量化指标,避免只比单点算法
- 智能体接口可插拔,能同时接入 LLM 智能体、强化学习策略和传统规则引擎做横向对比
- 基于真实微服务与云环境抽象,故障场景贴近生产,复现实验成本低
不足之处
- 项目处于早期成长阶段,生态和第三方场景库还不够丰富
- 对非微软技术栈或自建环境的适配可能需要额外开发工作
适用场景
- 研究团队对比不同 LLM 运维智能体在故障诊断任务上的准确率与修复耗时
- 企业平台团队在自建云环境中预演智能体自动修复流程,评估上线风险
- 教学场景中让学生用统一沙箱理解 AIOps 从检测到修复的完整链路
替代项目
Chaos Mesh、OpenRCA、AIOps Challenge
上一篇:agentmemoryrepo
下一篇:autocontext
同类项目推荐
hermes-rs
开源
用 Rust 重写 AI 智能体核心循环,让工具调用快如闪电。
A fast, self-contained AI agent runtime
Agent-Execution-Partnership
开源
给AI代理装上安全阀门,动作先审批、全程可追踪、事后可审计。
Agent Execution Partnership AEE is an open-source control plane that ensures every A···
Flowise
开源
像搭积木一样拖出 AI 助手,不用写一行代码
Build AI Agents, Visually
Plato-Scientific-Research-Autono···
开源
上传实验数据,自动生成可发表的科研论文初稿
Multi-agent AI scientist that turns experimental data into > publication-ready resea···
MCP-SuperAssistant
开源
给所有主流AI聊天框装上MCP工具,秒变超级助手
Brings MCP to ChatGPT, DeepSeek, Perplexity, Grok, Gemini, Google AI Studio, OpenRou···
langgraph-email-automation
开源
用多AI代理自动处理客服邮件,从接收到回复全流程搞定。
Multi AI agents for customer support email automation built with Langchain & Langgra···
stock-agent-ops
开源
用 LSTM 和智能体自动生成周度股票报告,省时省力
Designing end-to-end weekly stock report generation using LSTM and Agentic AI. Deplo···
monid
开源
一套接口接所有 Agent 工具,换模型不用重写
Monid - OpenRouter for agent tools. Join our community at https://discord.gg/rQzztcg···
my-virtual-office
开源
把 AI 智能体放进 2D 办公室,可视化管理和协作
A self-hosted 2D AI workspace for AI Agents