This is an automated email from the ASF dual-hosted git repository. vavrtom pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/qpid-broker-j.git
The following commit(s) were added to refs/heads/main by this push: new f0b3bf7045 QPID-8601: [Broker-J] Renamed module and updated documentation (#151) f0b3bf7045 is described below commit f0b3bf7045ffbde2804abf1b63c4b4a7e7933b30 Author: vavrtom <vavricka.to...@gmail.com> AuthorDate: Fri Oct 21 15:12:15 2022 +0200 QPID-8601: [Broker-J] Renamed module and updated documentation (#151) --- broker-instrumentation/README.md | 10 +++++----- broker-instrumentation/pom.xml | 4 ++-- broker/pom.xml | 2 +- .../docbkx/runtime/Java-Broker-Runtime-Instrumentation.xml | 13 +++++++++---- pom.xml | 2 +- 5 files changed, 18 insertions(+), 13 deletions(-) diff --git a/broker-instrumentation/README.md b/broker-instrumentation/README.md index d500f6a7b2..ffc554de73 100644 --- a/broker-instrumentation/README.md +++ b/broker-instrumentation/README.md @@ -10,21 +10,21 @@ To use instrumentation agent following JVM argument should be added to the broke parameters: ``` --javaagent:$BROKER_DIR/lib/broker-instrumentation-9.0.0-SNAPSHOT.jar +-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar ``` List of classes to instrument can be supplied as a comma separated list: ``` --javaagent:$BROKER_DIR/lib/broker-instrumentation-9.0.0-SNAPSHOT.jar=ConfiguredObjectMethodAttributeOrStatistic +-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic ``` ``` --javaagent:$BROKER_DIR/lib/broker-instrumentation-9.0.0-SNAPSHOT.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation +-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation ``` ``` --javaagent:$BROKER_DIR/lib/broker-instrumentation-9.0.0-SNAPSHOT.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation,AutomatedField +-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation,AutomatedField ``` -When no arguments supplied, all classes will be instrumented. \ No newline at end of file +When no arguments supplied, all classes will be instrumented. diff --git a/broker-instrumentation/pom.xml b/broker-instrumentation/pom.xml index a2f4444c90..b9a547bae2 100644 --- a/broker-instrumentation/pom.xml +++ b/broker-instrumentation/pom.xml @@ -25,9 +25,9 @@ </parent> <modelVersion>4.0.0</modelVersion> - <artifactId>broker-instrumentation</artifactId> + <artifactId>qpid-broker-instrumentation</artifactId> <name>Apache Qpid Broker-J Instrumentation</name> - <description>Broker instrumentation</description> + <description>Broker static instrumentation agent</description> <dependencies> <dependency> diff --git a/broker/pom.xml b/broker/pom.xml index 71189f789f..f382164e1e 100644 --- a/broker/pom.xml +++ b/broker/pom.xml @@ -51,7 +51,7 @@ <dependency> <groupId>org.apache.qpid</groupId> - <artifactId>broker-instrumentation</artifactId> + <artifactId>qpid-broker-instrumentation</artifactId> <scope>runtime</scope> </dependency> diff --git a/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Instrumentation.xml b/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Instrumentation.xml index 1dc1452fa1..cf9d6c6203 100644 --- a/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Instrumentation.xml +++ b/doc/java-broker/src/docbkx/runtime/Java-Broker-Runtime-Instrumentation.xml @@ -23,9 +23,14 @@ <section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Java-Broker-Runtime-Instrumentation"> <title>Broker Instrumentation</title> <para>The Apache Qpid Broker-J heavy relies on java reflection mechanism. A static instrumentation agent - can be used to replace method.invoke() reflection calls with static final MethodHandle.invokeExact().</para> - <para>To use instrumentation agent following JVM argument should be added to the broker start - parameters:</para> - <para>-javaagent:$BROKER_DIR/lib/broker-instrumentation.jar</para> + can be used to replace <literal>method.invoke()</literal> reflection calls with static final + <literal>MethodHandle.invokeExact()</literal>.</para> + <para>To use instrumentation agent following JVM argument should be added to the broker start parameters:</para> + <screen>-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar</screen> + <para>List of classes to instrument can be supplied as a comma separated list:</para> + <screen>-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic</screen> + <screen>-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation</screen> + <screen>-javaagent:$BROKER_DIR/lib/qpid-broker-instrumentation-${broker-version}.jar=ConfiguredObjectMethodAttributeOrStatistic,ConfiguredObjectMethodOperation,AutomatedField</screen> + <para>When no arguments supplied, all classes will be instrumented.</para> </section> diff --git a/pom.xml b/pom.xml index 9c64eed3de..3e78c60fb9 100644 --- a/pom.xml +++ b/pom.xml @@ -292,7 +292,7 @@ <dependency> <groupId>org.apache.qpid</groupId> - <artifactId>broker-instrumentation</artifactId> + <artifactId>qpid-broker-instrumentation</artifactId> <version>${project.version}</version> </dependency> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org