• Building
• Agent Configuration
• Maven Plugin Configuration
  • Plugin Goals
  • Plugin configuration options
  • Example

Artifacts will be written to target/ use appmap-java-plugin-[VERSION].jar. as your maven plugin.

$ mvn clean install

When you run your program, the agent reads configuration settings from appmap.yml by default.

Please read configuration options from AppMap Java Agent README.md

prepare-agent : adds appmap.jar to JVM execution as javaagent

outputDirectory (default: ./target/appmap/) configFile (default: ./appmap.yml) debug (enabled|disabled, default: disabled) eventValueSize (integer, default 1024) skip(Boolean, default false)

<!-- AppMap Java agent, default parameters -->
<plugin>
    <groupId>com.appland</groupId>
    <artifactId>appmap-maven-plugin</artifactId>
    <version>${appmap-java.version}</version>
        <configuration>
            <outputDirectory></outputDirectory>
            <configFile>appmap.yml</configFile>
            <debug>enabled</debug>
            <eventValueSize>1024</eventValueSize>
            <skip>false</skip>
        </configuration>
    <executions>
        <execution>
            <goals>
                <goal>prepare-agent</goal>
            </goals>
        </execution>
    </executions>
</plugin>

To run the java agent with correct plugin configuration you only need to build your project as usual without skipping the test goal.

$ mvn clean install