# observexinc/observex_managed architecture

> Architecture diagram of the GitHub repository observexinc/observex_managed, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/observexinc/observex_managed
- Repository: https://github.com/observexinc/observex_managed

## Overview

ObserveX Managed is a self-hosted observability platform. Its main collection path runs from host agents through a Unified Gateway to Server intake and the configured stores; operators explore results in the web Console. The README also documents node supervision, a TLS Front Door, self-monitoring, browser telemetry, and six store types. Some feature modules are present in the tree but their wiring was not sampled, so those relationships are left unasserted or marked unverified.

Main entry points: [`internal/server/server.go`](https://github.com/observexinc/observex_managed/blob/main/internal/server/server.go) (ObserveX Server), [`internal/gateway/gateway.go`](https://github.com/observexinc/observex_managed/blob/main/internal/gateway/gateway.go) (Unified Gateway), [`internal/node/supervisor/supervisor.go`](https://github.com/observexinc/observex_managed/blob/main/internal/node/supervisor/supervisor.go) (Node Supervisor), [`internal/agent/agent.go`](https://github.com/observexinc/observex_managed/blob/main/internal/agent/agent.go) (Host Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Telemetry Collection"]
  node_agent["Host Agent<br/>[agent.go]"]
  node_gateway["Unified Gateway<br/>[gateway.go]"]
  node_browser["Browser Collector<br/>[collect.ts]"]
end

subgraph group_node["Node Platform"]
  node_node_supervisor["Node Supervisor<br/>[supervisor.go]"]
  node_frontdoor["NGINX Front Door<br/>[frontdoor.go]"]
  node_selfmon["Node Self-Monitoring<br/>[selfmon.go]"]
end

subgraph group_server["Server Services"]
  node_server_runtime["ObserveX Server<br/>[server.go]"]
  node_intake["Telemetry Intake<br/>[intake.go]"]
  node_pipeline["Signal Pipeline<br/>[pipeline.go]"]
  node_graph["Entity Graph<br/>[service.go]"]
  node_investigator["Investigator<br/>[tools.go]"]
  node_proofchain["Proof Chain<br/>[block.go]"]
  node_public_api["Public API<br/>[server.go]"]
end

subgraph group_storage["State Stores"]
  node_metric_store[("MetricStore<br/>[metric.go]")]
  node_search_store[("SearchStore<br/>[search.go]")]
  node_trace_store[("TraceStore<br/>[store.go]")]
  node_config_store[("ConfigurationStore<br/>[store.go]")]
end

subgraph group_console["Web Console"]
  node_console_app["Console Application<br/>[App.tsx]"]
  node_console_api["Console API Client<br/>[api.ts]"]
  node_console_pages["Observability Views<br/>[Entities.tsx]"]
end

node_host(("Monitored Host"))
node_operator(("Operator"))

node_host -->|"runs on"| node_agent
node_agent -->|"forwards telemetry"| node_gateway
node_gateway -->|"delivers batches"| node_intake
node_server_runtime -.->|"starts"| node_intake
node_server_runtime -->|"starts"| node_public_api
node_server_runtime -->|"configures stores"| node_metric_store
node_server_runtime -->|"configures stores"| node_search_store
node_server_runtime -->|"configures stores"| node_trace_store
node_server_runtime -->|"configures stores"| node_config_store
node_server_runtime -.->|"runs"| node_pipeline
node_server_runtime -.->|"runs"| node_graph
node_server_runtime -.->|"runs"| node_investigator
node_server_runtime -.->|"runs"| node_proofchain
node_node_supervisor -->|"starts"| node_frontdoor
node_node_supervisor -->|"starts"| node_server_runtime
node_operator -->|"uses"| node_console_app
node_console_app -->|"routes to"| node_console_pages
node_console_pages -->|"requests data"| node_console_api
node_console_api -.->|"calls over HTTP"| node_public_api
node_browser -.->|"sends telemetry"| node_gateway
node_server_runtime -->|"registers metrics"| node_selfmon

click node_agent "https://github.com/observexinc/observex_managed/blob/main/internal/agent/agent.go"
click node_gateway "https://github.com/observexinc/observex_managed/blob/main/internal/gateway/gateway.go"
click node_browser "https://github.com/observexinc/observex_managed/blob/main/web/console/browser/src/collect.ts"
click node_node_supervisor "https://github.com/observexinc/observex_managed/blob/main/internal/node/supervisor/supervisor.go"
click node_frontdoor "https://github.com/observexinc/observex_managed/blob/main/internal/node/frontdoor/frontdoor.go"
click node_selfmon "https://github.com/observexinc/observex_managed/blob/main/internal/node/selfmon/selfmon.go"
click node_server_runtime "https://github.com/observexinc/observex_managed/blob/main/internal/server/server.go"
click node_intake "https://github.com/observexinc/observex_managed/blob/main/internal/server/intake/intake.go"
click node_pipeline "https://github.com/observexinc/observex_managed/blob/main/internal/server/pipeline/pipeline.go"
click node_graph "https://github.com/observexinc/observex_managed/blob/main/internal/server/graph/service.go"
click node_investigator "https://github.com/observexinc/observex_managed/blob/main/internal/server/investigator/tools.go"
click node_proofchain "https://github.com/observexinc/observex_managed/blob/main/internal/server/proofchain/block.go"
click node_public_api "https://github.com/observexinc/observex_managed/blob/main/internal/server/api/server.go"
click node_metric_store "https://github.com/observexinc/observex_managed/blob/main/internal/store/cassandra/metric.go"
click node_search_store "https://github.com/observexinc/observex_managed/blob/main/internal/store/opensearch/search.go"
click node_trace_store "https://github.com/observexinc/observex_managed/blob/main/internal/store/tracestore/store.go"
click node_config_store "https://github.com/observexinc/observex_managed/blob/main/internal/store/etcdstore/store.go"
click node_console_app "https://github.com/observexinc/observex_managed/blob/main/web/console/src/App.tsx"
click node_console_api "https://github.com/observexinc/observex_managed/blob/main/web/console/src/api.ts"
click node_console_pages "https://github.com/observexinc/observex_managed/blob/main/web/console/src/pages/Entities.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agent,node_gateway,node_browser toneBlue
class node_node_supervisor,node_frontdoor,node_selfmon toneAmber
class node_server_runtime,node_intake,node_pipeline,node_graph,node_investigator,node_proofchain,node_public_api toneMint
class node_metric_store,node_search_store,node_trace_store,node_config_store toneRose
class node_console_app,node_console_api,node_console_pages,node_host,node_operator toneIndigo
```

## Components

### Telemetry Collection

- [Host Agent](https://github.com/observexinc/observex_managed/blob/main/internal/agent/agent.go): `internal/agent/agent.go`
- [Unified Gateway](https://github.com/observexinc/observex_managed/blob/main/internal/gateway/gateway.go): `internal/gateway/gateway.go`
- [Browser Collector](https://github.com/observexinc/observex_managed/blob/main/web/console/browser/src/collect.ts): `web/console/browser/src/collect.ts`

### Node Platform

- [Node Supervisor](https://github.com/observexinc/observex_managed/blob/main/internal/node/supervisor/supervisor.go): `internal/node/supervisor/supervisor.go`
- [NGINX Front Door](https://github.com/observexinc/observex_managed/blob/main/internal/node/frontdoor/frontdoor.go): `internal/node/frontdoor/frontdoor.go`
- [Node Self-Monitoring](https://github.com/observexinc/observex_managed/blob/main/internal/node/selfmon/selfmon.go): `internal/node/selfmon/selfmon.go`

### Server Services

- [ObserveX Server](https://github.com/observexinc/observex_managed/blob/main/internal/server/server.go): `internal/server/server.go`
- [Telemetry Intake](https://github.com/observexinc/observex_managed/blob/main/internal/server/intake/intake.go): `internal/server/intake/intake.go`
- [Signal Pipeline](https://github.com/observexinc/observex_managed/blob/main/internal/server/pipeline/pipeline.go): `internal/server/pipeline/pipeline.go`
- [Entity Graph](https://github.com/observexinc/observex_managed/blob/main/internal/server/graph/service.go): `internal/server/graph/service.go`
- [Investigator](https://github.com/observexinc/observex_managed/blob/main/internal/server/investigator/tools.go): `internal/server/investigator/tools.go`
- [Proof Chain](https://github.com/observexinc/observex_managed/blob/main/internal/server/proofchain/block.go): `internal/server/proofchain/block.go`
- [Public API](https://github.com/observexinc/observex_managed/blob/main/internal/server/api/server.go): `internal/server/api/server.go`

### State Stores

- [MetricStore](https://github.com/observexinc/observex_managed/blob/main/internal/store/cassandra/metric.go): `internal/store/cassandra/metric.go`
- [SearchStore](https://github.com/observexinc/observex_managed/blob/main/internal/store/opensearch/search.go): `internal/store/opensearch/search.go`
- [TraceStore](https://github.com/observexinc/observex_managed/blob/main/internal/store/tracestore/store.go): `internal/store/tracestore/store.go`
- [ConfigurationStore](https://github.com/observexinc/observex_managed/blob/main/internal/store/etcdstore/store.go): `internal/store/etcdstore/store.go`

### Web Console

- [Console Application](https://github.com/observexinc/observex_managed/blob/main/web/console/src/App.tsx): `web/console/src/App.tsx`
- [Console API Client](https://github.com/observexinc/observex_managed/blob/main/web/console/src/api.ts): `web/console/src/api.ts`
- [Observability Views](https://github.com/observexinc/observex_managed/blob/main/web/console/src/pages/Entities.tsx): `web/console/src/pages/Entities.tsx`

### Other components

- **Monitored Host**
- **Operator**

## Connections

- Monitored Host → Host Agent: runs on
- Host Agent → Unified Gateway: forwards telemetry
- Unified Gateway → Telemetry Intake: delivers batches
- ObserveX Server → Telemetry Intake: starts
- ObserveX Server → Public API: starts (evidence: `internal/server/server.go`)
- ObserveX Server → MetricStore: configures stores
- ObserveX Server → SearchStore: configures stores
- ObserveX Server → TraceStore: configures stores
- ObserveX Server → ConfigurationStore: configures stores
- ObserveX Server → Signal Pipeline: runs
- ObserveX Server → Entity Graph: runs
- ObserveX Server → Investigator: runs
- ObserveX Server → Proof Chain: runs
- Node Supervisor → NGINX Front Door: starts
- Node Supervisor → ObserveX Server: starts
- Operator → Console Application: uses
- Console Application → Observability Views: routes to (evidence: `web/console/src/App.tsx`)
- Observability Views → Console API Client: requests data (evidence: `web/console/src/pages/Entities.tsx`)
- Console API Client → Public API: calls over HTTP
- Browser Collector → Unified Gateway: sends telemetry
- ObserveX Server → Node Self-Monitoring: registers metrics (evidence: `internal/server/server.go`)
