How ongridio/ongrid works
Ongrid is an infrastructure-operations platform combining a cloud manager, an outbound-connected Edge agent, and a React operator workspace. Operators ask questions or alerts trigger investigation; the system gathers telemetry, topology, and knowledge, then presents analysis or routes permitted actions. The README documents specialist agents, workflows, skills, MCP, approvals, browser SSH, Kubernetes, and network-device management, which are included as distinct branches. Wiring details are based on the sampled entry points and documented capabilities; unsampled subsystem links are omitted where ownership is unclear.
Main entry points: react.go Agent graph · ongrid-edge/main.go Edge agent · ongrid/main.go Cloud manager · runtime.go Chat runtime
Components 25
Operator workspace
- Web workspace
web/src/App.tsx
Agent and automation
- Chat runtime
internal/manager/biz/aiops/chatruntime/runtime.go - Agent graph
internal/manager/biz/aiops/graph/react.go - Agent tools
internal/manager/biz/aiops/tools/registry.go - Alert investigation
internal/manager/biz/alert/investigator/usecase.go - Approval gate
internal/manager/biz/approval/usecase.go - Workflow engine
internal/manager/biz/flow/engine.go
Observability and context
- Knowledge vault
internal/manager/biz/knowledge/usecase.go - Topology service
internal/manager/biz/topology/usecase.go - Metrics logs traces
internal/manager/biz/metric/query.go - Alert evaluation
internal/manager/biz/alert/pipeline.go
Edge and infrastructure
- Edge agent
cmd/ongrid-edge/main.go - Host collectors
internal/edgeagent/collector/composite.go - Telemetry plugins
internal/edgeagent/plugins/plugin.go - Kubernetes management
internal/manager/biz/k8s/usecase.go - Network devices
internal/manager/biz/device/usecase.go - Browser SSH
internal/manager/biz/webshell/router.go
Platform services
- Cloud manager
cmd/ongrid/main.go - Identity and access
internal/iam/server/http.go - IM channels
internal/manager/biz/imbridge/usecase.go - MCP integrations
internal/manager/biz/mcp/usecase.go
Other components
- Operator
- Telemetry backends
- Managed infrastructure
- Slack and Telegram
Connections 25
- Operator → Web workspace: uses
- Web workspace → Cloud manager: API requests
- Cloud manager → Identity and access: composes
- Slack and Telegram → IM channels: messages
- IM channels → Chat runtime: dispatches
- Cloud manager → Chat runtime: builds runtime
- Chat runtime → Agent graph: runs agent
- Agent graph → Agent tools: invokes tools
- Alert evaluation → Alert investigation: triggers investigation
- Alert investigation → Agent graph: starts RCA
- Agent graph → Knowledge vault: searches context
- Agent graph → Topology service: queries topology
- Agent graph → Metrics logs traces: queries telemetry
- Agent graph → Approval gate: requests approval
- Workflow engine → Agent tools: executes nodes
- Edge agent → Host collectors: runs collectors
- Edge agent → Telemetry plugins: runs plugins
- Host collectors → Telemetry backends: exports telemetry
- Telemetry plugins → Telemetry backends: exports telemetry
- Edge agent → Cloud manager: dials tunnel
- Managed infrastructure → Edge agent: observed by
- Kubernetes management → Edge agent: enrolls clusters
- Network devices → Edge agent: discovers through
- Browser SSH → Edge agent: tunnels shell
- MCP integrations → Agent tools: exposes tools