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 <[email protected]>
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: [email protected]
For additional commands, e-mail: [email protected]
