OmegaBrain Edge+Cloud 双层架构：Agent 安装、心跳上报、告警推送全流程

概述

OmegaBrain 采用 Edge（端侧 Agent）+ Cloud（云端控制台）的双层架构设计。Edge Agent 部署在客户服务器上，负责采集硬件/网络/进程数据，通过加密 WebSocket 上报至 Cloud；Cloud 聚合数据后触发规则引擎，按路由策略通过短信和 APP 推送触达你。本文详解从零部署 Edge Agent 到收到第一条告警的完整流程。

---

1. 系统架构

┌─────────────────────────────┐ │ 客户服务器 (Edge Node) │ │ │ │ ┌─────────────────────┐ │ │ │ OmegaBrain Edge Agent │ │ │ │ ─────────────────── │ │ │ │ heartbeat.sender │ │ HTTPS / WSS (encrypted) │ │ metrics.collector │ │ │ │ alert.executor │ │ │ └─────────────────────┘ │ └──────────┬──────────────────┘ │ POST /api/edge/ingest ▼ ┌─────────────────────────────┐ │ Cloud Console (:8000) │ │ │ │ OmegaBrain Backend │ │ ├── /api/edge/ingest │ ← 接收 Edge 数据 │ ├── Rules Engine │ ← count ≥ 3 → Hermes │ └── Notification Router │ ← 短信/APP 推送 └─────────────────────────────┘

2. Edge Agent 安装（3 种方式）
2.1 一键脚本（推荐）

# 登录 Cloud 后台 → 节点管理 → 添加节点 → 复制安装命令 curl -fsSL https://omegabrain.cn/portal//install/edge.sh | bash -s -- --api-key=ohae_xxxxxxxxxxxxx

2.2 Docker 部署

# docker-compose.yml services: omega-edge: image: omega/edge-agent:latest container_name: omega-edge restart: unless-stopped environment: API_KEY: "ohae_xxxxxxxxxxxxx" API_BASE: "https://omegabrain.cn/portal//api" HEARTBEAT_INTERVAL: 30 LOG_LEVEL: info volumes: - /proc:/host/proc:ro - /sys:/host/sys:ro - /var/run:/host/var/run:ro network_mode: host

2.3 systemd 独立进程

# 下载二进制 wget https://omegabrain.cn/portal//releases/omega-edge_latest_amd64.tar.gz tar xzf omega-edge_latest_amd64.tar.gz sudo ./install.sh

验证

systemctl status omega-edge journalctl -u omega-edge -f

3. 数据采集规格

4. 告警触发链路

Edge Agent (采集) → POST /api/edge/ingest (30s 一次) → OmegaBrain Backend (规则引擎) → count ≥ 3 → Hermes Agent (:8003) → LLM 分析 → play book → Callback (SSH 执行修复命令) → 通知: 短信 / 邮件 / APP 推送

首次告警体验：

Edge Agent 安装后 90s 内，第一条心跳到达 Cloud
触发规则：CPU ≥ 95% 持续 3 分钟 → 短信推送「节点 X CPU 告警」
点击消息卡片 → 跳转 Cloud 控制台 → 查看 Prometheus 图表


5. 安全机制

**传输加密**：TLS 1.3，证书双向认证
**API Key**：按节点独立，SHA-256 哈希存储
**数据隔离**：多租户，租户 ID 编码到 Token
**防火墙**：Edge 仅 outbound 443 出站，不暴露 inbound 端口


6. 验收测试

1. 验证心跳

curl -H "Authorization: Bearer $API_KEY"
https://omegabrain.cn/portal//api/edge/nodes

2. 模拟 CPU 告警

curl -X POST https://omegabrain.cn/portal//api/edge/test/alert
-H "Authorization: Bearer $API_KEY"
-d '{"node_id":"test","metric":"cpu","value":98}'

3. 检查短信与 APP 推送

预期：90s 内收到「测试告警」短信与 APP 通知

相关资源：OmegaBrain 服务器运维 · 定价 · 预约演示