How netcracker/qubership-profiler-agent works
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: Profiler.java Profiler Runtime · app.tsx Web Profiler UI · tree-page.tsx Tree Viewer · api.go Query API
Components 24
JVM Instrumentation
- Java Agent
agent/src/main/java/com/netcracker/profiler/javaagent/Agent.java - Profiler Runtime
boot/src/main/java/com/netcracker/profiler/agent/Profiler.java - Runtime Data
boot/src/main/java/com/netcracker/profiler/agent/ProfilerData.java - Thread Buffers
boot/src/main/java/com/netcracker/profiler/agent/LocalBuffer.java - Call Records
boot/src/main/java/com/netcracker/profiler/agent/CallInfo.java - Agent Bootstrap
boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java - SQL Capture
plugins/postgresql/src/injector/java/org/postgresql/core/v3/QueryExecutorImpl.java - Data Dumper
dumper/src/main/java/com/netcracker/profiler/client/DefaultCollectorClient.java
Collection and Storage
- Go Collector
backend/libs/collector/service.go - Trace Ingest
backend/libs/collector/ingest/listener.go - Hot Storage
backend/libs/collector/hotstore/store.go - Cold Storage
backend/libs/storage/data.go - Dump Management
common/src/main/java/com/netcracker/profiler/dump/DumpFileManager.java - Dumps Collector
backend/apps/dumps-collector/pkg/server/http_server.go
Query and Analysis
- Query API
backend/libs/query/api.go - Query Service
backend/libs/query/service.go - Call Tree Query
backend/libs/query/tree.go
User Interfaces
- Web Profiler UI
backend/apps/ui/src/app.tsx - Calls Browser
backend/apps/ui/src/calls/use-calls-query.ts - Tree Viewer
backend/apps/ui/src/pages/tree-page.tsx - MessagePack Decoder
backend/apps/ui/src/msgpack/decode.ts - Profiler CLI
cli/src/main/java/com/netcracker/profiler/cli/Main.java
Other components
- Instrumented JVM
- Profiler User
Connections 22
- Instrumented JVM → Java Agent: attaches agent
README.md - Java Agent → Agent Bootstrap: starts runtime
- Agent Bootstrap → Profiler Runtime: initializes
boot/src/main/java/com/netcracker/profiler/agent/Bootstrap.java - Profiler Runtime → Runtime Data: records events
boot/src/main/java/com/netcracker/profiler/agent/Profiler.java - Profiler Runtime → Thread Buffers: exchanges buffers
boot/src/main/java/com/netcracker/profiler/agent/Profiler.java - Profiler Runtime → Call Records: tracks calls
boot/src/main/java/com/netcracker/profiler/agent/Profiler.java - SQL Capture → Profiler Runtime: reports SQL
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
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