A tool for extracting data out of any application exposing a JMX interface. It also provides support for golang.
Starting from v2 you can call nrjmx from Go applications by using our gojmx module.
If you want to read more about or to contribute you can check our develop docs.
Common package managers can be used for this purpose: yum, apt, zypper.
For example: yum install nrjmx
You can download and decompress the Java executable from the downloads page.
nrjmx is not bundled within the nri-jmx package. Still, it's declared as a dependency.
So if you have nrjmx already installed while installing nri-jmx, the installed version is kept. Otherwise, nri-jmx will try to get the latest nrjmx release.
nrjmx expects the connection parameters to the JMX interface as command line arguments.
$ ./bin/nrjmx -hostname 127.0.0.1 -port 7199 -username user -password pwdnrjmx reads lines from the standard input which should contain object name patterns for which we want to fetch their attributes. For each line, it gets the beans matching the pattern and outputs a JSON with all the attributes found.
For example, if you want to fetch some beans from Cassandra JMX metrics, you can execute:
$ echo
"org.apache.cassandra.metrics:type=Table,keyspace=*,scope=*,name=ReadLatency" | java -jar target/nrjmx-0.0.1-SNAPSHOT-jar-with-dependencies.jar -hostname 127.0.0.1 -port 7199 -username user -password pwdor for Windows CMD:
$ echo | set /p="org.apache.cassandra.metrics:type=Table,keyspace=*,scope=*,name=ReadLatency" | java -jar target/nrjmx-0.0.1-SNAPSHOT-jar-with-dependencies.jar -hostname 127.0.0.1 -port 7199 -username user -password pwdAdditional options are listed below.
JMX allows use of custom protocols to communicate with the application. To use a custom protocol you have to include the custom connectors in the nrjmx classpath.
By default, nrjmx will include the sub-folder connectors in its class path. If this folder does not exist create it under the folder where you have nrjmx installed.
For example, to add support for JBoss, create a folder connectors under the default (Linux) library path /usr/lib/nrjmx/ (/usr/lib/nrjmx/connectors) and copy the custom connector jar ($JBOSS_HOME/bin/client/jboss-cli-client.jar) into it. You can now execute JMX queries against JBoss.
If you want to use a remoting-jmx URL you can use the flag -remote. In this case it uses the remoting connection URL: service:jmx:remote://host:port instead of service:jmx:rmi:///jndi/rmi://host:port/jmxrmi.
This sets a URI ready for JBoss Domain mode.
You will need to add support for the custom JBoss protocol. See the previous section
Custom protocols.
This is supported via -remoteJBossStandalone and sets a connection URL to service:jmx:remote+http://host:port.
Example of usage with remoting:
$ ./bin/nrjmx -hostname 127.0.0.1 -port 7199 -username user -password pwd -remoteYou will need to add support for the custom JBoss protocol. See the previous section
Custom protocols.
If your JMX provider uses a non-standard JMX service URI path (default path is jmxrmi), you can use the flag -uriPath to specify the path portion (without / prefix).
For example:
- A default URI path could be like:
service:jmx:rmi:///jndi/rmi://localhost:1689/jmxrmi(path is last path of the URI without the prefix/) - ForgeRock OpenDJ uses a JMX service URI like:
service:jmx:rmi:///jndi/rmi://localhost:1689/org.opends.server.protocols.jmx.client-unknown
To extract data from this application:
$ ./bin/nrjmx -hostname localhost -port 1689 -uriPath "org.opends.server.protocols.jmx.client-unknown" -username user -password pwdIf you are having difficulties with nrjmx to get data out of your JMX service, You can check our troubleshoot guide.
nrjmx uses Maven for generating the binaries:
$ mvn packageThis creates the nrjmx.jar file under the ./bin/ directory. Copy the bin/nrjmx and bin/nrjmx.jar files to your preferred location. Both files must
be located under the same folder.
It also creates DEB and RPM packages to automatically install nrjmx. If you want to skip the creation of DEB and RPM packages (for example, because your development machine does not provide the required tools), you can disable the deb and rpm Maven profiles from the command line:
mvn clean package -P \!deb,\!rpm,\!tarball,\!testNew Relic hosts and moderates an online forum where customers can interact with New Relic employees as well as other customers to get help and share best practices. Like all official New Relic open source projects, there's a related Community topic in the New Relic Explorers Hub. You can find this project's topic/threads here:
https://discuss.newrelic.com/c/support-products-agents/new-relic-infrastructure
We encourage your contributions to improve New Relic JMX fetcher! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at opensource@newrelic.com.
A note about vulnerabilities
As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.
If you would like to contribute to this project, review these guidelines.
To all contributors, we thank you! Without your contribution, this project would not be what it is today.
New Relic JMX fetcher is licensed under the Apache 2.0 License.