Instana - Java Startup Agent

Javaagent to initialize JVM attach and instrument features.

License	MIT License
GroupId	com.instana
ArtifactId	instana-javaagent
Last Version	1.0.0
Release Date	Sep 28, 2016
Type	jar
Description	Instana - Java Startup Agent Javaagent to initialize JVM attach and instrument features.
Project URL	https://github.com/instana/instana-javaagent
Project Organization	Instana Inc.
Source Code Management	https://github.com/instana/instana-javaagent

Download instana-javaagent

Filename	Size
instana-javaagent-1.0.0.pom
instana-javaagent-1.0.0.jar	3 KB
instana-javaagent-1.0.0-sources.jar	3 KB
instana-javaagent-1.0.0-javadoc.jar	23 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.instana/instana-javaagent/ -->
<dependency>
    <groupId>com.instana</groupId>
    <artifactId>instana-javaagent</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.instana/instana-javaagent/
implementation 'com.instana:instana-javaagent:1.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.instana/instana-javaagent/
implementation ("com.instana:instana-javaagent:1.0.0")

Apache Buildr

'com.instana:instana-javaagent:jar:1.0.0'

Apache Ivy

<dependency org="com.instana" name="instana-javaagent" rev="1.0.0">
  <artifact name="instana-javaagent" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.instana', module='instana-javaagent', version='1.0.0')
)

Scala SBT

libraryDependencies += "com.instana" % "instana-javaagent" % "1.0.0"

Leiningen

[com.instana/instana-javaagent "1.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Instana JVM Startup Agent

The Instana agent architecture is modular. When the Instana agent runs, it will perform a runtime attach to any JVM and load the required classes lazily.

Compatibility tests however have shown that certain versions of J9 do not support all required features when no -javaagent was present on the JVM start command line. J9 will log a message like this:

*** java.lang.instrument ASSERTION FAILED ***: "jvmtierror == JVMTI_ERROR_NOT_AVAILABLE" at JPLISAgent.c line: 1009

Additionally tests have shown that the first runtime attach can cause a short pause when the JVM starts the necessary services for the agent.

For those reasons we recommend to start the JVM with this javaagent like this:

java -javaagent:instana-javaagent-1.0.0.jar -jar app.jar server

The latest version of that jar can be found in MavenCentral -> Instana.

Should the J9 that is used be a Java 8 updated with recent fixpacks, this is no longer necessary, but a command line switch can be used instead. Since as of "Java 8 - Service refresh 3 fix pack 22 (Dec 2016)" an option exists which basically performs the same:

-XX:+EnableHCR

Use the -XX:+EnableHCR option to enable late attached agents to redefine or retransform classes. 
This option might incur a performance penalty. This option is temporary and deprecated and will
be removed in a future update when no longer necessary.

Instana

Sensors for instrumentation of various languages and outbound data connectors

Versions

Version
1.0.0 Sep 28, 2016