IBM MQ Appliance is an IBM production based on IBM MQ. We provide this OpenTelemetry Receiver implementation tested with latest releases of IBM MQ Appliance.
<style> .center { width: auto; display: table; margin-left: auto; margin-right: auto; } </style>Status of the Receiver
| Receiver type | Status | JDK required | Semantic Conventions |
|---|---|---|---|
| metrics | alpha | JDK v8+ | link |
Download the installation package from OJR releases:
wget https://github.com/liurui-software/ojr/releases/download/xxx/ojr-mq-appliance-xxx.tar
Extract the package to the desired deployment location:
tar vxf ojr-mq-appliance-xxx.tar
cd ojr-mq-appliance-xxx
Make sure following configuration files are correct for your environment:
- config/config.yaml
- config/logging.properties
Refine configuration file (config/config.yaml) according to your own database.
Run the Receiver/Agent synchronously:
./bin/ojr-mq-appliance
Or Run the Receiver/Agent asynchronously:
nohup ./bin/ojr-mq-appliance &
Note: Query the Receiver/Agent
ps -ef | grep ojr | grep -v grep
Note: Stop DataCollector
ps -ef | grep ojr | grep -v grep | awk '{printf " "$2" "}' | xargs kill -9
Make sure Java SDK is installed.
java -version
Get the source code from github.com.
git clone https://github.com/liurui-software/ojr.git
cd ojr-xxx
Build with Gradle
./gradlew clean build
Run the Agent with Gradle
./gradlew run
| Parameter | Scope | Description | Default | Examples |
|---|---|---|---|---|
| host.system | global | The logical name of the host system | - | mq_appliance |
| appliance.host | instance | The host name or IP address of the IBM MQ appliance | - | testbox1.mqappliance.com |
| appliance.user | instance | The user name of the IBM MQ appliance | - | admin |
| appliance.password | instance | The password of the IBM MQ appliance | - | passw0rd |