# netcracker/qubership-profiler-agent architecture

> Architecture diagram of the GitHub repository netcracker/qubership-profiler-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/netcracker/qubership-profiler-agent
- Repository: https://github.com/netcracker/qubership-profiler-agent

## Overview

Qubership Profiler is a Java-agent continuous tracing and profiling product. Its documented workflow instruments a JVM, records calls and diagnostic data, sends profiling data to collection services, and makes captured data available for analysis; the repository also contains a Go collector/query stack and a React UI. The README documents product capabilities, while the sampled source is sparse across these subsystems, so uncertain cross-service links are shown as dashed and unverified.

Main entry points: [`boot/src/main/java/com/netcracker/profiler/agent/Profiler.java`](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/Profiler.java) (Profiler Runtime), [`backend/apps/ui/src/app.tsx`](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/app.tsx) (Web Profiler UI), [`backend/apps/ui/src/pages/tree-page.tsx`](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/pages/tree-page.tsx) (Tree Viewer), [`backend/libs/query/api.go`](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/api.go) (Query API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_instrument["JVM Instrumentation"]
  node_agent["Java Agent<br/>[Agent.java]"]
  node_runtime["Profiler Runtime<br/>[Profiler.java]"]
  node_runtime_data["Runtime Data<br/>[ProfilerData.java]"]
  node_buffer["Thread Buffers<br/>[LocalBuffer.java]"]
  node_call_info["Call Records<br/>[CallInfo.java]"]
  node_bootstrap["Agent Bootstrap<br/>[Bootstrap.java]"]
  node_sql["SQL Capture"]
  node_dumper["Data Dumper"]
end

subgraph group_transport["Collection and Storage"]
  node_collector["Go Collector<br/>[service.go]"]
  node_ingest["Trace Ingest<br/>[listener.go]"]
  node_hotstore[("Hot Storage<br/>[store.go]")]
  node_coldstore[("Cold Storage<br/>[data.go]")]
  node_dump_files["Dump Management"]
  node_dump_collector["Dumps Collector<br/>[http_server.go]"]
end

subgraph group_analysis["Query and Analysis"]
  node_query_api["Query API<br/>[api.go]"]
  node_query_service["Query Service<br/>[service.go]"]
  node_tree_query["Call Tree Query<br/>[tree.go]"]
end

subgraph group_presentation["User Interfaces"]
  node_ui["Web Profiler UI<br/>[app.tsx]"]
  node_calls_view["Calls Browser<br/>[use-calls-query.ts]"]
  node_tree_view["Tree Viewer<br/>[tree-page.tsx]"]
  node_wire_decode["MessagePack Decoder<br/>[decode.ts]"]
  node_cli["Profiler CLI<br/>[Main.java]"]
end

node_app(("Instrumented JVM"))
node_ui_user(("Profiler User"))

node_app -.->|"attaches agent"| node_agent
node_agent -.->|"starts runtime"| node_bootstrap
node_bootstrap -.->|"initializes"| node_runtime
node_runtime -->|"records events"| node_runtime_data
node_runtime -->|"exchanges buffers"| node_buffer
node_runtime -->|"tracks calls"| node_call_info
node_sql -->|"reports SQL"| node_runtime
node_runtime -.->|"sends profiling data"| node_dumper
node_dumper -.->|"uploads data"| node_collector
node_collector -.->|"accepts streams"| node_ingest
node_ingest -.->|"writes traces"| node_hotstore
node_hotstore -.->|"archives data"| node_coldstore
node_ui_user -.->|"explores profiles"| node_ui
node_ui -.->|"shows calls"| node_calls_view
node_calls_view -.->|"requests calls"| node_query_api
node_ui -.->|"opens call trees"| node_tree_view
node_tree_view -.->|"decodes data"| node_wire_decode
node_tree_view -.->|"requests tree data"| node_query_api
node_query_api -.->|"dispatches queries"| node_query_service
node_query_service -.->|"builds call trees"| node_tree_query
node_cli -.->|"manages dumps"| node_dump_files
node_dump_collector -.->|"serves dump files"| node_dump_files

click node_agent "https://github.com/netcracker/qubership-profiler-agent/blob/main/agent/src/main/java/com/netcracker/profiler/javaagent/Agent.java"
click node_runtime "https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/Profiler.java"
click node_runtime_data "https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/ProfilerData.java"
click node_buffer "https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/LocalBuffer.java"
click node_call_info "https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/CallInfo.java"
click node_bootstrap "https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java"
click node_sql "https://github.com/netcracker/qubership-profiler-agent/blob/main/plugins/postgresql/src/injector/java/org/postgresql/core/v3/QueryExecutorImpl.java"
click node_dumper "https://github.com/netcracker/qubership-profiler-agent/blob/main/dumper/src/main/java/com/netcracker/profiler/client/DefaultCollectorClient.java"
click node_collector "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/service.go"
click node_ingest "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/ingest/listener.go"
click node_hotstore "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/hotstore/store.go"
click node_coldstore "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/storage/data.go"
click node_query_api "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/api.go"
click node_query_service "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/service.go"
click node_tree_query "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/tree.go"
click node_ui "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/app.tsx"
click node_calls_view "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/calls/use-calls-query.ts"
click node_tree_view "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/pages/tree-page.tsx"
click node_wire_decode "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/msgpack/decode.ts"
click node_cli "https://github.com/netcracker/qubership-profiler-agent/blob/main/cli/src/main/java/com/netcracker/profiler/cli/Main.java"
click node_dump_files "https://github.com/netcracker/qubership-profiler-agent/blob/main/common/src/main/java/com/netcracker/profiler/dump/DumpFileManager.java"
click node_dump_collector "https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/dumps-collector/pkg/server/http_server.go"

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_runtime,node_runtime_data,node_buffer,node_call_info,node_bootstrap,node_sql,node_dumper,node_ui_user toneBlue
class node_collector,node_ingest,node_hotstore,node_coldstore,node_dump_files,node_dump_collector toneAmber
class node_query_api,node_query_service,node_tree_query toneMint
class node_ui,node_calls_view,node_tree_view,node_wire_decode,node_cli toneRose
class node_app toneIndigo
```

## Components

### JVM Instrumentation

- [Java Agent](https://github.com/netcracker/qubership-profiler-agent/blob/main/agent/src/main/java/com/netcracker/profiler/javaagent/Agent.java): `agent/src/main/java/com/netcracker/profiler/javaagent/Agent.java`
- [Profiler Runtime](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/Profiler.java): `boot/src/main/java/com/netcracker/profiler/agent/Profiler.java`
- [Runtime Data](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/ProfilerData.java): `boot/src/main/java/com/netcracker/profiler/agent/ProfilerData.java`
- [Thread Buffers](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/LocalBuffer.java): `boot/src/main/java/com/netcracker/profiler/agent/LocalBuffer.java`
- [Call Records](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/CallInfo.java): `boot/src/main/java/com/netcracker/profiler/agent/CallInfo.java`
- [Agent Bootstrap](https://github.com/netcracker/qubership-profiler-agent/blob/main/boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java): `boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java`
- [SQL Capture](https://github.com/netcracker/qubership-profiler-agent/blob/main/plugins/postgresql/src/injector/java/org/postgresql/core/v3/QueryExecutorImpl.java): `plugins/postgresql/src/injector/java/org/postgresql/core/v3/QueryExecutorImpl.java`
- [Data Dumper](https://github.com/netcracker/qubership-profiler-agent/blob/main/dumper/src/main/java/com/netcracker/profiler/client/DefaultCollectorClient.java): `dumper/src/main/java/com/netcracker/profiler/client/DefaultCollectorClient.java`

### Collection and Storage

- [Go Collector](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/service.go): `backend/libs/collector/service.go`
- [Trace Ingest](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/ingest/listener.go): `backend/libs/collector/ingest/listener.go`
- [Hot Storage](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/collector/hotstore/store.go): `backend/libs/collector/hotstore/store.go`
- [Cold Storage](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/storage/data.go): `backend/libs/storage/data.go`
- [Dump Management](https://github.com/netcracker/qubership-profiler-agent/blob/main/common/src/main/java/com/netcracker/profiler/dump/DumpFileManager.java): `common/src/main/java/com/netcracker/profiler/dump/DumpFileManager.java`
- [Dumps Collector](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/dumps-collector/pkg/server/http_server.go): `backend/apps/dumps-collector/pkg/server/http_server.go`

### Query and Analysis

- [Query API](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/api.go): `backend/libs/query/api.go`
- [Query Service](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/service.go): `backend/libs/query/service.go`
- [Call Tree Query](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/libs/query/tree.go): `backend/libs/query/tree.go`

### User Interfaces

- [Web Profiler UI](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/app.tsx): `backend/apps/ui/src/app.tsx`
- [Calls Browser](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/calls/use-calls-query.ts): `backend/apps/ui/src/calls/use-calls-query.ts`
- [Tree Viewer](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/pages/tree-page.tsx): `backend/apps/ui/src/pages/tree-page.tsx`
- [MessagePack Decoder](https://github.com/netcracker/qubership-profiler-agent/blob/main/backend/apps/ui/src/msgpack/decode.ts): `backend/apps/ui/src/msgpack/decode.ts`
- [Profiler CLI](https://github.com/netcracker/qubership-profiler-agent/blob/main/cli/src/main/java/com/netcracker/profiler/cli/Main.java): `cli/src/main/java/com/netcracker/profiler/cli/Main.java`

### Other components

- **Instrumented JVM**
- **Profiler User**

## Connections

- Instrumented JVM → Java Agent: attaches agent (evidence: `README.md`)
- Java Agent → Agent Bootstrap: starts runtime
- Agent Bootstrap → Profiler Runtime: initializes (evidence: `boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java`)
- Profiler Runtime → Runtime Data: records events (evidence: `boot/src/main/java/com/netcracker/profiler/agent/Profiler.java`)
- Profiler Runtime → Thread Buffers: exchanges buffers (evidence: `boot/src/main/java/com/netcracker/profiler/agent/Profiler.java`)
- Profiler Runtime → Call Records: tracks calls (evidence: `boot/src/main/java/com/netcracker/profiler/agent/Profiler.java`)
- SQL Capture → Profiler Runtime: reports SQL (evidence: `plugins/postgresql/src/injector/java/org/postgresql/core/v3/QueryExecutorImpl.java`)
- Profiler Runtime → Data Dumper: sends profiling data
- Data Dumper → Go Collector: uploads data
- Go Collector → Trace Ingest: accepts streams
- Trace Ingest → Hot Storage: writes traces
- Hot Storage → Cold Storage: archives data
- Profiler User → Web Profiler UI: explores profiles
- Web Profiler UI → Calls Browser: shows calls
- Calls Browser → Query API: requests calls
- Web Profiler UI → Tree Viewer: opens call trees (evidence: `backend/apps/ui/src/app.tsx`)
- Tree Viewer → MessagePack Decoder: decodes data
- Tree Viewer → Query API: requests tree data
- Query API → Query Service: dispatches queries
- Query Service → Call Tree Query: builds call trees
- Profiler CLI → Dump Management: manages dumps
- Dumps Collector → Dump Management: serves dump files
