How oneteme/inspect-core works
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: TraceHub.java Trace Hub · HttpSessionTracer.java Incoming HTTP · DatabaseConnectionLifecycleTracer.java JDBC Capture · SessionContextManager.java Session Context
Components 22
Configuration
- Collector Config
src/main/java/org/usf/inspect/core/InspectConfiguration.java - Core Wiring
src/main/java/org/usf/inspect/core/InspectCoreConfiguration.java
Operation Capture
- Incoming HTTP
src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java - Blocking HTTP
src/main/java/org/usf/inspect/web/httpclient/HttpRequestInterceptor.java - Reactive HTTP
src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java - JDBC Capture
src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java - LDAP Capture
src/main/java/org/usf/inspect/ldap/DirContextWrapper.java - Other I/O
src/main/java/org/usf/inspect - Async Scheduling
src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java
Session Correlation
- Session Context
src/main/java/org/usf/inspect/core/SessionContextManager.java - Context State
src/main/java/org/usf/inspect/core/SessionContext.java
Trace Processing
- Trace Signals
src/main/java/org/usf/inspect/TraceSignal.java - SQL Classification
src/main/java/org/usf/inspect/DatabaseCommand.java - Event Formatting
src/main/java/org/usf/inspect/EventTraceFormatter.java - Resource Metrics
src/main/java/org/usf/inspect/core/SystemMonitor.java - Execution Wrapper
src/main/java/org/usf/inspect/core/InspectExecutor.java
Dispatch and Reporting
- Trace Hub
src/main/java/org/usf/inspect/core/TraceHub.java - REST Publisher
src/main/java/org/usf/inspect/core/RestClientTracePublisher.java - Log Reporter
src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java
Other components
- Application
- Inspect Server
- Local Analysis
Connections 26
- 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
src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java - Incoming HTTP → Execution Wrapper: wraps execution
src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java - Incoming HTTP → Trace Hub: emits traces
src/main/java/org/usf/inspect/web/mvc/HttpSessionTracer.java - Reactive HTTP → Execution Wrapper: wraps exchange
src/main/java/org/usf/inspect/web/reactive/WebClientFilter.java - Reactive HTTP → Session Context: captures request
- JDBC Capture → Session Context: creates request
src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java - JDBC Capture → SQL Classification: classifies SQL
src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java - JDBC Capture → Trace Signals: builds stages
src/main/java/org/usf/inspect/sql/DatabaseConnectionLifecycleTracer.java - LDAP Capture → Execution Wrapper: wraps operations
src/main/java/org/usf/inspect/ldap/DirContextWrapper.java - Async Scheduling → Context State: propagates context
src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java - Async Scheduling → Execution Wrapper: traces tasks
src/main/java/org/usf/inspect/util/ScheduledExecutorServiceWrapper.java - Session Context → Context State: manages state
src/main/java/org/usf/inspect/core/SessionContextManager.java - Context State → Trace Hub: emits updates
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
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
src/main/java/org/usf/inspect/slf4j/InspectLogReporter.java - Trace Hub → Local Analysis: supports local dump