
一键启动 cwc-workshops 事故仪表盘StreamlitMock 数据全流程指南【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshopscwc-workshops 仓库里的ship-your-first-managed-agent工作区是一套基于Streamlit Mock 数据的电商事故仪表盘代号 Incident-2277。Metrics、Logs、Deploys 三大页面开箱即用右侧还挂着一个离线的 SRE Agent 聊天面板。本文带你一键启动这套事故仪表盘走通从克隆、装依赖到streamlit run的完整流程。项目速览这套事故仪表盘是什么想象一个真实的 2 点场景PagerDuty 报警checkout 服务 P99 延迟飙到基线的10 倍。你得打开仪表盘、grep 日志、翻部署记录反复猜测——40 分钟后才发现是有人上线了一条N1 查询。这套仪表盘就是为此而生️开箱即跑Metrics / Logs / Deploys 三个页面全部由 Mock 数据驱动不需要任何真实后端自带假故障内置一场真实感十足的线上事故证据散落在日志、指标、部署记录里预留 Agent 位每个页面右侧都有 SRE Agent 聊天面板初始离线补全 7 个小函数即可让它在线排查 想快速理解全貌先看这份说明ship-your-first-managed-agent/README.md快速上手前的 3 项准备启动前只需确认三样东西#准备项要求1Python 版本3.102依赖包Streamlit / Plotly / anthropic / python-dotenv3环境变量.env中配置ANTHROPIC_API_KEY依赖清单见 ship-your-first-managed-agent/requirements.txt核心依赖一览依赖用途streamlit渲染仪表盘四大页面plotly绘制 Metrics 时序曲线anthropic驱动 SRE Agent离线阶段可不用python-dotenv读取.env中的 API Key⚠️ 只跑仪表盘看 Mock 数据时无需联网调 AgentAPI Key 可留空只有接入聊天面板才需要。一键启动4 步跑起 Streamlit 事故仪表盘把下面这段复制进终端依次执行即可git clone https://gitcode.com/GitHub_Trending/cw/cwc-workshops cd cwc-workshops/ship-your-first-managed-agent python -m venv .venv source .venv/bin/activate # Windows 用 .venv\Scripts\activate pip install -r requirements.txt cp .env.example .env # 然后把你的 ANTHROPIC_API_KEY 填进 .env streamlit run app.py✅ 启动后浏览器打开localhost:8501即可看到仪表盘主界面。 入口文件ship-your-first-managed-agent/app.py 首次运行会自动生成 7 万行的data/app.log日志夹具约 0.5 秒结果确定之后再也不会重复生成页面导览四大页面分别看什么仪表盘通过侧边导航切换 4 个页面每个页面右侧都挂着聊天面板页面看什么对应文件Overview事故总览P99 延迟、错误率、DB 池、持续时长app.pyMetricsP99 延迟 / 错误率 / DB 池三条时序曲线带部署标记线pages/1_Metrics.pyLogs70 万行级 JSON 日志流式过滤按 service / level / 行数pages/2_Logs.pyDeploys近 6 小时部署列表 提交 diff 查看pages/3_Deploys.py在Metrics页面里三条曲线会在部署时刻a3f9c21出现一条虚线标注直观呈现上线 → 指标跳水的因果关系Logs页面则支持按服务、级别、行数三级过滤逐行流式加载。Mock 数据拆解一场假故障是怎么演出来的data/目录内置了一整套真实感十足的事故证据链14:31:18 UTC提交a3f9c21部署到 checkout 服务把批量查询改成了逐行循环 几分钟后 P99 延迟从65 ms飙升到3,600 msDB 连接池打满20% 的 checkout 开始失败 证据分散在四类文件Agent 需要把它们关联起来才能定位根因文件作用data/app.log7 万行 JSON 日志Agent 需在沙箱里 grep 分析data/metrics.json各服务时序指标延迟 / 错误率 / DB 池data/deploys.json近 6 小时部署记录data/diff.txt问题提交的代码 diff 关键点get_metrics/get_recent_deploys/get_diff三个工具跑在你本机读 Mock JSON而非云端——这正是本地工具 云端 Agent混合架构的精髓。从离线到在线SRE Agent 的 7 步打开 ship-your-first-managed-agent/agent.py里面有 7 个待实现的函数每个只对应一次Managed Agents API 调用。补全后聊天面板就逐步在线#函数作用1setup_agent()创建 Agent模型 系统提示 工具2setup_environment()创建云端沙箱环境3upload_log()上传日志到 Files API4start_session()绑定 Agent 环境挂载日志5stream_reply()打开事件流发送消息并流式返回6handle_tool()本地执行工具读data/*.json7delete_session()清理云端会话资源全部加起来约34 行。系统提示、工具 schema、聊天 UI、会话选择器都已预置在 ship-your-first-managed-agent/provided.py。卡住了参考 ship-your-first-managed-agent/agent_complete.py。核心文件在哪里目录速览路径说明agent.py唯一需要编辑的文件7 个函数agent_complete.py参考实现provided.py系统提示 / 工具 schema / 聊天 UIe2e.py全流程无头测试app.py事故总览入口ui.py assets/style.css深色主题样式data/日志 指标 部署 diff 夹具常见问题 FAQQ1启动报错说找不到 API Key只跑仪表盘看 Mock 数据不需要 Key若想接入 SRE Agent把ANTHROPIC_API_KEY填进.env再重启即可。Q2data/app.log生成失败怎么办按页面提示手动执行python data/generate_log.py然后刷新页面。Q3聊天面板一直显示agent offline这是正常现象——对应函数还没实现。补全 agent.py 中相应函数后面板会逐步点亮。Q4Windows 下激活虚拟环境用.venv\Scripts\activate代替source .venv/bin/activate。写在最后这套cwc-workshops 事故仪表盘用 Mock 数据把线上事故排查浓缩成了一个可本地一键启动的 Streamlit 应用四大页面开箱即用7 万行日志、指标、部署、diff 一应俱全。补上 7 个小函数你还能让 SRE Agent 在线帮你 grep 日志、关联时间戳、直接点出有问题的提交——这正是从手动排查 40 分钟到Agent 自动定位的完整闭环。【免费下载链接】cwc-workshops项目地址: https://gitcode.com/GitHub_Trending/cw/cwc-workshops创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考