feat: added support for oracledb (#1828)

refs https://jsw.ibm.com/browse/INSTA-43857

Author: kirrg001

.tekton/assets/sidecars.json

@@ -20,6 +20,15 @@
         "timeoutSeconds": 10
       }
     },
+    {
+      "name": "oracledb",
+      "image": "gvenzl/oracle-free:23-slim",
+      "env": [
+        { "name": "ORACLE_PASSWORD", "value": "teamnodejstest" },
+        { "name": "APP_USER", "value": "teamnodejs" },
+        { "name": "APP_USER_PASSWORD", "value": "teamnodejspassword" }
+      ]
+    },
     {
       "name": "mongodb",
       "image": "public.ecr.aws/docker/library/mongo:8.0.8"

.tekton/generate-test-files.js

@@ -78,7 +78,7 @@ const groups = {
     subname: 'test:ci:tracing:protocols'
   },
   'test:ci:collector:tracing:general': {
-    sidecars: ['postgres'],
+    sidecars: ['postgres', 'oracledb'],
     condition: ' && true'
   },
   'test:ci:collector:tracing:misc': {

.tekton/tasks/test-groups/collector-tracing-general-task.yaml

@@ -23,6 +23,16 @@ spec:
           initialDelaySeconds: 3
           periodSeconds: 2
           timeoutSeconds: 10
+    - name: oracledb
+      image: gvenzl/oracle-free:23-slim
+      imagePullPolicy: IfNotPresent
+      env:
+          - name: "ORACLE_PASSWORD"
+            value: "teamnodejstest"
+          - name: "APP_USER"
+            value: "teamnodejs"
+          - name: "APP_USER_PASSWORD"
+            value: "teamnodejspassword"
   envFrom:
     - configMapRef:
         name: environment-properties  

currencies.json

@@ -867,5 +867,16 @@
     "ignoreUpdates": false,
     "note": "",
     "core": false
+  },
+  {
+    "name": "oracledb",
+    "policy": "45-days",
+    "lastSupportedVersion": "",
+    "latestVersion": "",
+    "cloudNative": false,
+    "isBeta": false,
+    "ignoreUpdates": false,
+    "note": "",
+    "core": false
   }
 ]

docker-compose-base.yaml

@@ -1,11 +1,22 @@
 version: '2'
 services:
+  oracledb:
+    image: gvenzl/oracle-free:23-slim
+    container_name: oracle-free
+    ports:
+      - "1521:1521"
+      - "8080:8080"
+    environment:
+      ORACLE_PASSWORD: teamnodejstest
+      APP_USER: teamnodejs
+      APP_USER_PASSWORD: teamnodejspassword
+
   redis:
     image: redis:7.4.3
     ports:
       - 6379:6379
 
- # sentinel test setup       
+ # sentinel test setup
   redis-slave:
     image: redis:7.4.3
     network_mode: host
@@ -205,7 +216,7 @@ services:
       - "4510-4559:4510-4559"  # external services port range
     environment:
       - DEBUG=${DEBUG-}
-      - DOCKER_HOST=unix:///var/run/docker.sock 
+      - DOCKER_HOST=unix:///var/run/docker.sock
     volumes:
       - "/var/run/docker.sock:/var/run/docker.sock"
 
@@ -214,4 +225,4 @@ networks:
     driver: bridge
     ipam:
       config:
-        - subnet: 172.30.0.0/16
+        - subnet: 172.30.0.0/16

package-lock.json

@@ -211,6 +211,7 @@
     "node-fetch-v2": "npm:[email protected]",
     "node-gyp": "11.2.0",
     "node-nats-streaming": "0.3.2",
+    "oracledb": "6.9.0",
     "pg": "8.16.3",
     "pino": "9.9.1",
     "pino-http": "9.0.0",

package.json

@@ -16,6 +16,7 @@ const DEFAULT_ENV_VALUES = {
   KAFKA: '127.0.0.1:9092',
   REDIS: '127.0.0.1:6379',
   REDIS_ALTERNATIVE: 'localhost:6379',
+  ORACLEDB: 'localhost:1521',
   REDIS_SENTINEL_MASTER_NAME: 'mymaster',
   REDIS_SENTINEL_HOST: 'localhost',
   REDIS_SENTINEL_PORT: 26379,

packages/collector/test/initEnv.js

@@ -0,0 +1,74 @@
+/*
+ * (c) Copyright IBM Corp. 2025
+ */
+
+/* eslint-disable no-console */
+
+'use strict';
+
+// NOTE: c8 bug https://github.com/bcoe/c8/issues/166
+process.on('SIGTERM', () => {
+  process.disconnect();
+  process.exit(0);
+});
+
+const opentelemetryDisabled = process.env.INSTANA_DISABLE_USE_OPENTELEMETRY === 'true';
+
+require('@instana/collector')({
+  tracing: {
+    useOpentelemetry: !opentelemetryDisabled
+  }
+});
+
+const oracledb = require('oracledb');
+const port = require('../../test_util/app-port')();
+const delay = require('@instana/core/test/test_util/delay');
+const logPrefix = `Oracle App (${process.pid}):\t`;
+const express = require('express');
+const app = express();
+
+let connected = false;
+let connection;
+
+(async function connect() {
+  try {
+    connection = await oracledb.getConnection({
+      user: 'teamnodejs',
+      password: 'teamnodejspassword',
+      connectString: `${process.env.ORACLEDB}/FREEPDB1`
+    });
+
+    connected = true;
+    log('Connected to OracleDB');
+  } catch (err) {
+    log('Failed to connect to OracleDB:', err);
+    log('Retrying in a few seconds...');
+    await delay(1000 * 5);
+    await connect();
+  }
+})();
+
+app.get('/', (req, res) => {
+  if (!connected) {
+    return res.sendStatus(500);
+  }
+
+  res.sendStatus(200);
+});
+
+app.get('/trace', async (req, res) => {
+  await connection.execute('SELECT 1 FROM DUAL');
+  log('Executed query');
+  res.sendStatus(200);
+});
+
+app.listen(port, () => {
+  log(`Listening on port: ${port}`);
+});
+
+function log() {
+  /* eslint-disable no-console */
+  const args = Array.prototype.slice.call(arguments);
+  args[0] = logPrefix + args[0];
+  console.log.apply(console, args);
+}