# newrelic-experimental/newrelic-java-boomi architecture

> Architecture diagram of the GitHub repository newrelic-experimental/newrelic-java-boomi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/newrelic-experimental/newrelic-java-boomi
- Repository: https://github.com/newrelic-experimental/newrelic-java-boomi

## Overview

##### Project type and purpose
- This is an open-source Java instrumentation library (“New Relic Java Instrumentation for Boomi”) that plugs into Boomi’s Atom Node and Atom Worker JVMs to collect and report telemetry to the New Relic platform.

##### File structure
- Top-level build files (build.gradle, settings.gradle) and Gradle wrapper indicate a JVM/Gradle project.
- The submodule `boomi-container-execution` contains the core instrumentation code (`ExecutionQueue.java`, `ExecutionSubmission.java`).
- Prebuilt JARs in `template-lib`, `test-lib`, and `boomi-container-execution/lib` are extension libraries that are loaded by the New Relic agent.
- Documentation files (`README.md`, `CONTRIBUTING.md`, workflows) describe deployment steps, release process, and CI pipelines.

##### README for additional insights
- The library is deployed by adding `-javaagent:/path/to/newrelic.jar` plus configuration flags (`-Dnewrelic.config.app_name=…`) to Boomi’s `atom.vmoptions` (Atom Node) and `procworker.sh` (Atom Worker).
- Extensions (instrumented jars) are placed under `newrelic/extensions`.
- After deployment, the agent automatically instruments Boomi processes to send high-level and detailed telemetry to New Relic.

##### Detail
- Both Atom Node and multiple Atom Worker instances.
- Filesystem path for `extensions/`.
- High-level vs. detailed telemetry flows (Node metrics vs. Worker process instrumentation).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Boomi Processes"
        AtomNodeJVM["Atom Node JVM\n-javaagent & -Dnewrelic.config.app_name"]:::jvm
        AtomWorkerJVM["Atom Worker JVM(s)\n-javaagent & -Dnewrelic.config.app_name"]:::jvm
    end

    AtomNodeJVM --> NewRelicAgent
    AtomWorkerJVM --> NewRelicAgent

    subgraph "New Relic Java Agent" 
        Agent["newrelic.jar"]:::agent
        subgraph "Instrumentation Extensions"
            CILib["Core Instrumentation Library"]:::extension
            subgraph "Core Instrumentation"
                ExecQueue["ExecutionQueue.java"]:::code
                ExecSubmission["ExecutionSubmission.java"]:::code
            end
            ContainerExec["container-execution.jar"]:::extension
            ContainerConfig["container-config.jar"]:::extension
            TemplateLib["gradle-templates-1.5.jar"]:::extension
            TestLib["instrumentation-test.jar"]:::extension
        end
    end

    NewRelicAgent --> Agent
    Agent -->|loads| CILib
    CILib --> ExecQueue
    CILib --> ExecSubmission
    CILib --> ContainerExec
    CILib --> ContainerConfig
    Agent --> TemplateLib
    Agent --> TestLib

    Agent -->|"HTTP/HTTPS Telemetry"| Telemetry["New Relic Telemetry Platform"]:::external

    click CILib "https://github.com/newrelic-experimental/newrelic-java-boomi/tree/main/boomi-container-execution/"
    click ExecQueue "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/boomi-container-execution/src/main/java/com/boomi/execution/ExecutionQueue.java"
    click ExecSubmission "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/boomi-container-execution/src/main/java/com/boomi/execution/ExecutionSubmission.java"
    click ContainerExec "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/boomi-container-execution/lib/container-execution.jar"
    click ContainerConfig "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/boomi-container-execution/lib/container-config.jar"
    click TemplateLib "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/template-lib/gradle-templates-1.5.jar"
    click TestLib "https://github.com/newrelic-experimental/newrelic-java-boomi/blob/main/test-lib/instrumentation-test.jar"

    classDef jvm fill:#adcfff,stroke:#337ab7,color:#000
    classDef agent fill:#ffd59e,stroke:#e67e22,color:#000
    classDef extension fill:#fff59e,stroke:#f1c40f,color:#000
    classDef external fill:#caffca,stroke:#27ae60,color:#000
    classDef code fill:#eeeeee,stroke:#aaaaaa,color:#000
```
