Skip to content

Latest commit

 

History

History
104 lines (78 loc) · 2.87 KB

README.md

File metadata and controls

104 lines (78 loc) · 2.87 KB

OpenTelemetry Receiver/Agent for Informix Database

Introduction

IBM® Informix® Database is a relational database management system (RDBMS). We provide this OpenTelemetry Receiver implementation tested with Informix version 12.x.

<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

Deployment Information (for end users)

Download the installation package from OJR releases:

wget https://github.com/liurui-software/ojr/releases/download/xxx/ojr-informix-db-xxx.tar

Extract the package to the desired deployment location:

tar vxf ojr-informix-db-xxx.tar
cd ojr-informix-db-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-informix-db

Or Run the Receiver/Agent asynchronously:

nohup ./bin/ojr-informix-db &

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

Build and Run (for developers)

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

References of configuration parameters

Parameter Scope Description Default Examples
db.system global The logical name of the DB system - informix
db.driver global The JDBC driver of the DB system - com.informix.jdbc.IfxDriver
db.address instance The IP address of the DB instance - 192.168.3.14
db.port instance The internet port of the DB instance - 9088
db.username instance The user name of the DB instance - SYSDBA
db.password instance The BASE64 encoded password of the DB instance - TXlQYXNzd29yZA==
db.name instance The name of the DB instance - myDB1
db.serverName instance The server name of the DB instance - ol_informix1410
db.path instance The path of the DB instance - /opt/IBM/Informix_Software_Bundle