# oneteme/inspect-core architecture

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

- Interactive diagram: https://gitdiagram.com/oneteme/inspect-core
- Repository: https://github.com/oneteme/inspect-core

## Overview

inspect-core is a Spring-friendly Java runtime telemetry library. Its main workflow instruments application operations, creates correlated session/request traces, and dispatches those traces for remote or local analysis. The tree and README identify HTTP, JDBC, LDAP, FTP/SFTP, SMTP, local-operation, asynchronous-context, and resource-monitoring capabilities; sampled code shows session-context management, JDBC stage capture, reactive HTTP capture, configuration, and trace emission. Several integrations are documented but unsampled, so their internal call paths are not asserted.

Main entry points: [`src/main/java/org/usf/inspect/core/TraceHub.java`](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/TraceHub.java) (Trace Hub), [`src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java`](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java) (Incoming HTTP), [`src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java`](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java) (JDBC Capture), [`src/main/java/org/usf/inspect/core/SessionContextManager.java`](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SessionContextManager.java) (Session Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Configuration"]
  node_config["Collector Config"]
  node_coreconfig["Core Wiring"]
end

subgraph group_capture["Operation Capture"]
  node_mvc["Incoming HTTP"]
  node_httpclient["Blocking HTTP"]
  node_webclient["Reactive HTTP"]
  node_jdbc["JDBC Capture"]
  node_ldap["LDAP Capture"]
  node_otherio["Other I/O"]
  node_async["Async Scheduling"]
end

subgraph group_correlation["Session Correlation"]
  node_session["Session Context"]
  node_context["Context State"]
end

subgraph group_telemetry["Trace Processing"]
  node_signals["Trace Signals<br/>[TraceSignal.java]"]
  node_databasecommand["SQL Classification"]
  node_formatter["Event Formatting"]
  node_resources["Resource Metrics<br/>[SystemMonitor.java]"]
  node_executor["Execution Wrapper"]
end

subgraph group_delivery["Dispatch and Reporting"]
  node_hub["Trace Hub<br/>[TraceHub.java]"]
  node_publisher["REST Publisher"]
  node_logreport["Log Reporter"]
end

node_app(("Application"))
node_server(("Inspect Server"))
node_local(("Local Analysis"))

node_app -.->|"handles requests"| node_mvc
node_app -.->|"makes calls"| node_httpclient
node_app -.->|"makes calls"| node_webclient
node_app -.->|"uses database"| node_jdbc
node_app -.->|"uses directory"| node_ldap
node_app -.->|"uses resources"| node_otherio
node_mvc -->|"creates session"| node_session
node_mvc -->|"wraps execution"| node_executor
node_mvc -->|"emits traces"| node_hub
node_webclient -->|"wraps exchange"| node_executor
node_webclient -.->|"captures request"| node_session
node_jdbc -->|"creates request"| node_session
node_jdbc -->|"classifies SQL"| node_databasecommand
node_jdbc -->|"builds stages"| node_signals
node_ldap -->|"wraps operations"| node_executor
node_async -->|"propagates context"| node_context
node_async -->|"traces tasks"| node_executor
node_session -->|"manages state"| node_context
node_context -->|"emits updates"| node_hub
node_signals -->|"formats events"| node_formatter
node_config -.->|"configures beans"| node_coreconfig
node_config -->|"enables monitoring"| node_resources
node_hub -.->|"dispatches traces"| node_publisher
node_publisher -.->|"sends traces"| node_server
node_hub -->|"reports events"| node_logreport
node_hub -.->|"supports local dump"| node_local

click node_config "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectConfiguration.java"
click node_coreconfig "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectCoreConfiguration.java"
click node_mvc "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java"
click node_httpclient "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/httpclient/HttpRequestInterceptor.java"
click node_webclient "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java"
click node_jdbc "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java"
click node_ldap "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/ldap/DirContextWrapper.java"
click node_otherio "https://github.com/oneteme/inspect-core/tree/main/src/main/java/org/usf/inspect"
click node_async "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java"
click node_session "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SessionContextManager.java"
click node_context "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SessionContext.java"
click node_signals "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/TraceSignal.java"
click node_databasecommand "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/DatabaseCommand.java"
click node_formatter "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/EventTraceFormatter.java"
click node_resources "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SystemMonitor.java"
click node_executor "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectExecutor.java"
click node_hub "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/TraceHub.java"
click node_publisher "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/RestClientTracePublisher.java"
click node_logreport "https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java"

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_config,node_coreconfig toneBlue
class node_mvc,node_httpclient,node_webclient,node_jdbc,node_ldap,node_otherio,node_async toneAmber
class node_session,node_context,node_server toneMint
class node_signals,node_databasecommand,node_formatter,node_resources,node_executor toneRose
class node_hub,node_publisher,node_logreport,node_app,node_local toneIndigo
```

## Components

### Configuration

- [Collector Config](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectConfiguration.java): `src/main/java/org/usf/inspect/core/InspectConfiguration.java`
- [Core Wiring](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectCoreConfiguration.java): `src/main/java/org/usf/inspect/core/InspectCoreConfiguration.java`

### Operation Capture

- [Incoming HTTP](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java): `src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java`
- [Blocking HTTP](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/httpclient/HttpRequestInterceptor.java): `src/main/java/org/usf/inspect/web/httpclient/HttpRequestInterceptor.java`
- [Reactive HTTP](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java): `src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java`
- [JDBC Capture](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java): `src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java`
- [LDAP Capture](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/ldap/DirContextWrapper.java): `src/main/java/org/usf/inspect/ldap/DirContextWrapper.java`
- [Other I/O](https://github.com/oneteme/inspect-core/tree/main/src/main/java/org/usf/inspect): `src/main/java/org/usf/inspect`
- [Async Scheduling](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java): `src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java`

### Session Correlation

- [Session Context](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SessionContextManager.java): `src/main/java/org/usf/inspect/core/SessionContextManager.java`
- [Context State](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SessionContext.java): `src/main/java/org/usf/inspect/core/SessionContext.java`

### Trace Processing

- [Trace Signals](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/TraceSignal.java): `src/main/java/org/usf/inspect/TraceSignal.java`
- [SQL Classification](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/DatabaseCommand.java): `src/main/java/org/usf/inspect/DatabaseCommand.java`
- [Event Formatting](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/EventTraceFormatter.java): `src/main/java/org/usf/inspect/EventTraceFormatter.java`
- [Resource Metrics](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/SystemMonitor.java): `src/main/java/org/usf/inspect/core/SystemMonitor.java`
- [Execution Wrapper](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/InspectExecutor.java): `src/main/java/org/usf/inspect/core/InspectExecutor.java`

### Dispatch and Reporting

- [Trace Hub](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/TraceHub.java): `src/main/java/org/usf/inspect/core/TraceHub.java`
- [REST Publisher](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/core/RestClientTracePublisher.java): `src/main/java/org/usf/inspect/core/RestClientTracePublisher.java`
- [Log Reporter](https://github.com/oneteme/inspect-core/blob/main/src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java): `src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java`

### Other components

- **Application**
- **Inspect Server**
- **Local Analysis**

## Connections

- Application → Incoming HTTP: handles requests
- Application → Blocking HTTP: makes calls
- Application → Reactive HTTP: makes calls
- Application → JDBC Capture: uses database
- Application → LDAP Capture: uses directory
- Application → Other I/O: uses resources
- Incoming HTTP → Session Context: creates session (evidence: `src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java`)
- Incoming HTTP → Execution Wrapper: wraps execution (evidence: `src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java`)
- Incoming HTTP → Trace Hub: emits traces (evidence: `src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java`)
- Reactive HTTP → Execution Wrapper: wraps exchange (evidence: `src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java`)
- Reactive HTTP → Session Context: captures request
- JDBC Capture → Session Context: creates request (evidence: `src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java`)
- JDBC Capture → SQL Classification: classifies SQL (evidence: `src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java`)
- JDBC Capture → Trace Signals: builds stages (evidence: `src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java`)
- LDAP Capture → Execution Wrapper: wraps operations (evidence: `src/main/java/org/usf/inspect/ldap/DirContextWrapper.java`)
- Async Scheduling → Context State: propagates context (evidence: `src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java`)
- Async Scheduling → Execution Wrapper: traces tasks (evidence: `src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java`)
- Session Context → Context State: manages state (evidence: `src/main/java/org/usf/inspect/core/SessionContextManager.java`)
- Context State → Trace Hub: emits updates (evidence: `src/main/java/org/usf/inspect/core/SessionContext.java`)
- Trace Signals → Event Formatting: formats events
- Collector Config → Core Wiring: configures beans
- Collector Config → Resource Metrics: enables monitoring (evidence: `src/main/java/org/usf/inspect/core/InspectConfiguration.java`)
- Trace Hub → REST Publisher: dispatches traces
- REST Publisher → Inspect Server: sends traces
- Trace Hub → Log Reporter: reports events (evidence: `src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java`)
- Trace Hub → Local Analysis: supports local dump
