XScopeHub

English | 中文

English

This repository hosts multiple components:

• observe-bridge/ – core observability bridge services and supporting code.
• llm-ops-agent/ – placeholder for an upcoming LLM-based operations agent.
• agents/ – external agent integrations (deepflow, node_exporter, process-exporter, vector).
• openobserve and opentelemetry-collector – external dependencies tracked as submodules.

Architecture

[exporter]                     [Vector]         [OTel GW]        [OpenObserve]
NE ─┐                      ┌─────────┐      ┌──────────┐     ┌─────────────┐
PE ─┼── metrics/logs ────> │ Vector  │ ───> │ OTel GW  │ ──> │      OO      │
DF ─┤                      └─────────┘      └──────────┘     └─────────────┘
LG ─┘

                       (nearline window ETL: Align=1m · Delay=2m)
                                        │
                                        ▼
                         ┌──────────────────────────────────────┐
 IaC/Cloud  ────────────>│                                      │
                         │   ObserveBridge (ETL JOBS)           │
 Ansible     ───────────>│   • ETL 窗口聚合 / oo_locator        │
                         │   • 拓扑 (IaC/Ansible)               │
 OO 明细(OO→OB)  ───────>│   • AGE 10 分钟活跃调用图刷新        │
                         └──────────────────────────────────────┘

┌─────────────────────────────── Postgres Suite ───────────────────────────────┐
│   PG_JSONB            │   PG Aggregates (Timescale)   │  PG Vector  │  AGE   │
│ (oo_locator/events)   │ (metric_1m / call_5m / log_5m)│ (pgvector)  │ Graph  │
└───────────────┬────────┴───────────────┬──────────────┴─────────────┬────────┘
                │                        │                             │
                │                        │                             │
                ▼                        ▼                             ▼
                         [ llm-ops-agent / 应用消费（查询/检索/推理） ]

Documentation

• Repository Structure
• Architecture
• API
• Observability Bridge
  • Observability ETL Suite Design (ZH)
  • Observability ETL Suite Design (EN)
• Insight
• Roadmap
• Deployment
• Grafana
• MCP Server Integration
• LLM-Ops Agent
  • Overview
  • API
  • Usage
  • Docs
  • Testing
  • Dual Engine Design
  • Start
  • Postgres Init

中文

本仓库包含多个组件：

• observe-bridge/ – 核心可观测桥服务及支撑代码。
• llm-ops-agent/ – 计划中的 LLM 运维代理。
• agents/ – 外部采集器集成（deepflow、node_exporter、process-exporter、vector）。
• openobserve 和 opentelemetry-collector – 以子模块方式跟踪的外部依赖。

架构

[exporter]                     [Vector]         [OTel GW]        [OpenObserve]
NE ─┐                      ┌─────────┐      ┌──────────┐     ┌─────────────┐
PE ─┼── metrics/logs ────> │ Vector  │ ───> │ OTel GW  │ ──> │      OO      │
DF ─┤                      └─────────┘      └──────────┘     └─────────────┘
LG ─┘

                       (近线窗口 ETL: 对齐=1m · 延迟=2m)
                                        │
                                        ▼
                         ┌──────────────────────────────────────┐
 IaC/Cloud  ────────────>│                                      │
                         │   ObserveBridge (ETL 任务)           │
 Ansible     ───────────>│   • ETL 窗口聚合 / oo_locator        │
                         │   • 拓扑 (IaC/Ansible)               │
 OO 明细(OO→OB)  ───────>│   • AGE 10 分钟活跃调用图刷新        │
                         └──────────────────────────────────────┘

┌─────────────────────────────── Postgres 套件 ───────────────────────────────┐
│   PG_JSONB            │   PG Aggregates (Timescale)   │  PG Vector  │  AGE   │
│ (oo_locator/events)   │ (metric_1m / call_5m / log_5m)│ (pgvector)  │ Graph  │
└───────────────┬────────┴───────────────┬──────────────┴─────────────┬────────┘
                │                        │                             │
                │                        │                             │
                ▼                        ▼                             ▼
                         [ llm-ops-agent / 应用消费（查询/检索/推理） ]

文档

• 仓库结构
• 架构
• API
• Observe-Bridge
  • Observability ETL 套件设计 (中文)
  • Observability ETL Suite Design (English)
• XInsight
• 路线图
• 部署
• Grafana
• MCP Server 集成设计
• LLM 运维代理
  • 概览
  • API
  • 使用
  • 文档目录
  • 测试
  • 双引擎设计
  • 启动
  • Postgres 初始化