camel-ops-platform/docs/EXTRACTION_PROMPT.md

Architecture Update: nJAMS-Style Data Extraction (Java Agent)

Context from User (Hendrik): "The architect and developer should think about a javaagent to mimic the njams agent for mulesoft and tibco to extract data from not-instrumented apache camel applications. we should be as 'apache camel native' as possible and also keep the monitoring overhead to an absolute minimum."

Directives for Architect & Developer:

1. Zero-Code Change: Customers should not have to rewrite their Camel XML or Java DSL. We attach an agent, and it works.
2. Camel Native: Instead of blindly instrumenting JVM bytecode (which can break things and add overhead), the agent should ideally hook into Camel's native SPIs (CamelContext, EventNotifier, InterceptStrategy, Tracer).
3. Minimum Overhead: Capturing payloads at every step can cause OutOfMemory errors and CPU spikes. How do we extract data cheaply? (e.g., Ring buffers, sampling, payload truncation, extracting only on error, or dynamically toggling capture from the SaaS Control Plane).