@julr/otel-instrumentation-clickhouse 1.0.0 → 1.0.2

package/build/src/constants.d.ts

@@ -0,0 +1,25 @@
+import type { ClickHouseInstrumentationConfig } from './types.js';
+export declare const MODULE_NAME = "@clickhouse/client-common";
+export declare const INSTRUMENTATION_NAME = "@julr/otel-instrumentation-clickhouse";
+export declare const INSTRUMENTATION_VERSION = "1.0.0";
+/**
+ * Stable semantic convention attributes for database spans
+ * @see https://opentelemetry.io/docs/specs/semconv/database/database-spans/
+ */
+export declare const ATTR_DB_SYSTEM_NAME = "db.system.name";
+export declare const ATTR_DB_QUERY_TEXT = "db.query.text";
+export declare const ATTR_DB_OPERATION_NAME = "db.operation.name";
+export declare const ATTR_DB_NAMESPACE = "db.namespace";
+export declare const ATTR_DB_COLLECTION_NAME = "db.collection.name";
+export declare const ATTR_SERVER_ADDRESS = "server.address";
+export declare const ATTR_SERVER_PORT = "server.port";
+/**
+ * Deprecated attributes - kept for backward compatibility
+ * Can be removed once consumers migrate to stable attributes
+ */
+export declare const ATTR_DB_SYSTEM = "db.system";
+export declare const ATTR_DB_STATEMENT = "db.statement";
+export declare const ATTR_DB_OPERATION = "db.operation";
+export declare const ATTR_DB_NAME = "db.name";
+export declare const DEFAULT_CONFIG: ClickHouseInstrumentationConfig;
+//# sourceMappingURL=constants.d.ts.map

package/build/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA;AAEjE,eAAO,MAAM,WAAW,8BAA8B,CAAA;AACtD,eAAO,MAAM,oBAAoB,0CAA0C,CAAA;AAC3E,eAAO,MAAM,uBAAuB,UAAU,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AACnD,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AACzD,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAC/C,eAAO,MAAM,uBAAuB,uBAAuB,CAAA;AAC3D,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AACnD,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C;;;GAGG;AACH,eAAO,MAAM,cAAc,cAAc,CAAA;AACzC,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAC/C,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAC/C,eAAO,MAAM,YAAY,YAAY,CAAA;AAErC,eAAO,MAAM,cAAc,EAAE,+BAI5B,CAAA"}

package/build/src/constants.js

@@ -0,0 +1,28 @@
+export const MODULE_NAME = '@clickhouse/client-common';
+export const INSTRUMENTATION_NAME = '@julr/otel-instrumentation-clickhouse';
+export const INSTRUMENTATION_VERSION = '1.0.0';
+/**
+ * Stable semantic convention attributes for database spans
+ * @see https://opentelemetry.io/docs/specs/semconv/database/database-spans/
+ */
+export const ATTR_DB_SYSTEM_NAME = 'db.system.name';
+export const ATTR_DB_QUERY_TEXT = 'db.query.text';
+export const ATTR_DB_OPERATION_NAME = 'db.operation.name';
+export const ATTR_DB_NAMESPACE = 'db.namespace';
+export const ATTR_DB_COLLECTION_NAME = 'db.collection.name';
+export const ATTR_SERVER_ADDRESS = 'server.address';
+export const ATTR_SERVER_PORT = 'server.port';
+/**
+ * Deprecated attributes - kept for backward compatibility
+ * Can be removed once consumers migrate to stable attributes
+ */
+export const ATTR_DB_SYSTEM = 'db.system';
+export const ATTR_DB_STATEMENT = 'db.statement';
+export const ATTR_DB_OPERATION = 'db.operation';
+export const ATTR_DB_NAME = 'db.name';
+export const DEFAULT_CONFIG = {
+    maxQueryLength: 2048,
+    requireParentSpan: false,
+    suppressInternalInstrumentation: true,
+};
+//# sourceMappingURL=constants.js.map

package/build/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAA;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,uCAAuC,CAAA;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAA;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAA;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAA;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAC3D,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAA;AAErC,MAAM,CAAC,MAAM,cAAc,GAAoC;IAC7D,cAAc,EAAE,IAAI;IACpB,iBAAiB,EAAE,KAAK;IACxB,+BAA+B,EAAE,IAAI;CACtC,CAAA"}

package/build/src/index.d.ts

@@ -0,0 +1,3 @@
+export { ClickHouseInstrumentation } from './instrumentation.js';
+export type { ClickHouseInstrumentationConfig } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAChE,YAAY,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA"}

package/build/src/index.js

@@ -0,0 +1,2 @@
+export { ClickHouseInstrumentation } from './instrumentation.js';
+//# sourceMappingURL=index.js.map

package/build/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA"}

package/build/src/instrumentation.d.ts

@@ -0,0 +1,11 @@
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from '@opentelemetry/instrumentation';
+import type { ClickHouseInstrumentationConfig } from './types.js';
+export declare class ClickHouseInstrumentation extends InstrumentationBase<ClickHouseInstrumentationConfig> {
+    #private;
+    constructor(config?: ClickHouseInstrumentationConfig);
+    /**
+     * Initialize the instrumentation by defining module patches.
+     */
+    protected init(): InstrumentationNodeModuleDefinition;
+}
+//# sourceMappingURL=instrumentation.d.ts.map

package/build/src/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,mCAAmC,EAEpC,MAAM,gCAAgC,CAAA;AAIvC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAA;AAqBjE,qBAAa,yBAA0B,SAAQ,mBAAmB,CAAC,+BAA+B,CAAC;;gBACrF,MAAM,GAAE,+BAAoC;IAwNxD;;OAEG;IACH,SAAS,CAAC,IAAI;CA8Bf"}

package/build/src/instrumentation.js

@@ -0,0 +1,209 @@
+import { InstrumentationBase, InstrumentationNodeModuleDefinition, isWrapped, } from '@opentelemetry/instrumentation';
+import { suppressTracing } from '@opentelemetry/core';
+import { SpanKind, SpanStatusCode, context, trace } from '@opentelemetry/api';
+import { ATTR_DB_COLLECTION_NAME, ATTR_DB_NAME, ATTR_DB_NAMESPACE, ATTR_DB_OPERATION, ATTR_DB_OPERATION_NAME, ATTR_DB_QUERY_TEXT, ATTR_DB_STATEMENT, ATTR_DB_SYSTEM, ATTR_DB_SYSTEM_NAME, ATTR_SERVER_ADDRESS, ATTR_SERVER_PORT, DEFAULT_CONFIG, INSTRUMENTATION_NAME, INSTRUMENTATION_VERSION, MODULE_NAME, } from './constants.js';
+export class ClickHouseInstrumentation extends InstrumentationBase {
+    constructor(config = {}) {
+        super(INSTRUMENTATION_NAME, INSTRUMENTATION_VERSION, {
+            ...DEFAULT_CONFIG,
+            ...config,
+        });
+    }
+    /**
+     * Wrap a method on the prototype with instrumentation.
+     */
+    #wrapMethod(prototype, methodName, operation) {
+        if (isWrapped(prototype[methodName]))
+            this._unwrap(prototype, methodName);
+        this._wrap(prototype, methodName, this.#createWrapper(operation));
+    }
+    /**
+     * Create a wrapper function that instruments the original method.
+     */
+    #createWrapper(operation) {
+        // oxlint-disable-next-line no-this-alias
+        const instrumentation = this;
+        return function wrapper(original) {
+            return function (params) {
+                const config = instrumentation.getConfig();
+                const parentSpan = trace.getSpan(context.active());
+                if (config.requireParentSpan && !parentSpan)
+                    return original.apply(this, arguments);
+                const tableName = instrumentation.#extractTableName(params, operation);
+                const queryText = instrumentation.#extractQueryText(params, operation);
+                const spanName = tableName
+                    ? `clickhouse.${operation} ${tableName}`
+                    : `clickhouse.${operation}`;
+                const attributes = instrumentation.#buildAttributes({
+                    client: this,
+                    operation,
+                    tableName,
+                    queryText,
+                });
+                const span = instrumentation.tracer.startSpan(spanName, {
+                    kind: SpanKind.CLIENT,
+                    attributes,
+                });
+                const spanContext = trace.setSpan(context.active(), span);
+                return context.with(spanContext, () => {
+                    const result = instrumentation.#callOriginalFunction(original, this, arguments);
+                    if (result && typeof result.then === 'function') {
+                        return result.then((res) => {
+                            instrumentation.#endSpan(span, null);
+                            return res;
+                        }, (err) => {
+                            instrumentation.#endSpan(span, err);
+                            throw err;
+                        });
+                    }
+                    instrumentation.#endSpan(span, null);
+                    return result;
+                });
+            };
+        };
+    }
+    /**
+     * Extract the table/collection name from params.
+     *
+     * For `insert` operations, we use `params.table` directly (clean approach).
+     * For other operations (`query`, `command`, `exec`), the ClickHouse client
+     * only provides raw SQL strings, so we fall back to regex parsing.
+     */
+    #extractTableName(params, operation) {
+        if (!params)
+            return null;
+        if (operation === 'insert' && 'table' in params && params.table)
+            return params.table.trim();
+        if ('query' in params && params.query)
+            return this.#parseTableFromQuery(params.query);
+        return null;
+    }
+    /**
+     * Extract a displayable query text from the params.
+     */
+    #extractQueryText(params, operation) {
+        if (!params)
+            return operation;
+        if ('query' in params && params.query)
+            return this.#normalizeQuery(params.query);
+        if ('table' in params && params.table)
+            return `INSERT INTO ${params.table}`;
+        return operation;
+    }
+    /**
+     * Normalize query text by collapsing excessive whitespace.
+     */
+    #normalizeQuery(query) {
+        return query.replace(/\s+/g, ' ').trim();
+    }
+    /**
+     * Parse table name from SQL query string.
+     * This is a best-effort extraction for common SQL patterns.
+     */
+    #parseTableFromQuery(query) {
+        if (!query)
+            return null;
+        const normalized = query.trim().toUpperCase();
+        const fromMatch = query.match(/\bFROM\s+([`"]?[\w.]+[`"]?)/i);
+        if (fromMatch)
+            return fromMatch[1].replace(/[`"]/g, '');
+        const insertMatch = query.match(/\bINSERT\s+INTO\s+([`"]?[\w.]+[`"]?)/i);
+        if (insertMatch)
+            return insertMatch[1].replace(/[`"]/g, '');
+        if (normalized.startsWith('UPDATE')) {
+            const updateMatch = query.match(/\bUPDATE\s+([`"]?[\w.]+[`"]?)/i);
+            if (updateMatch)
+                return updateMatch[1].replace(/[`"]/g, '');
+        }
+        if (normalized.startsWith('DELETE')) {
+            const deleteMatch = query.match(/\bDELETE\s+FROM\s+([`"]?[\w.]+[`"]?)/i);
+            if (deleteMatch)
+                return deleteMatch[1].replace(/[`"]/g, '');
+        }
+        return null;
+    }
+    /**
+     * Build span attributes from the client and operation context.
+     */
+    #buildAttributes(options) {
+        const { client, operation, tableName, queryText } = options;
+        const config = this.getConfig();
+        const maxQueryLength = config.maxQueryLength ?? 2048;
+        const attributes = {
+            [ATTR_DB_SYSTEM_NAME]: 'clickhouse',
+            [ATTR_DB_OPERATION_NAME]: operation,
+            [ATTR_DB_SYSTEM]: 'clickhouse',
+            [ATTR_DB_OPERATION]: operation,
+        };
+        if (tableName)
+            attributes[ATTR_DB_COLLECTION_NAME] = tableName;
+        if (maxQueryLength > 0 && queryText) {
+            const truncatedQuery = queryText.length > maxQueryLength
+                ? queryText.substring(0, maxQueryLength) + '...'
+                : queryText;
+            attributes[ATTR_DB_QUERY_TEXT] = truncatedQuery;
+            attributes[ATTR_DB_STATEMENT] = truncatedQuery;
+        }
+        if (client.connectionParams) {
+            const url = client.connectionParams.url;
+            if (url) {
+                attributes[ATTR_SERVER_ADDRESS] = url.hostname;
+                if (url.port)
+                    attributes[ATTR_SERVER_PORT] = Number.parseInt(url.port, 10);
+            }
+            if (client.connectionParams.database) {
+                attributes[ATTR_DB_NAMESPACE] = client.connectionParams.database;
+                attributes[ATTR_DB_NAME] = client.connectionParams.database;
+            }
+        }
+        return attributes;
+    }
+    /**
+     * Call the original function, optionally suppressing HTTP instrumentation.
+     */
+    #callOriginalFunction(original, thisArg, args) {
+        const config = this.getConfig();
+        if (config.suppressInternalInstrumentation) {
+            return context.with(suppressTracing(context.active()), () => original.apply(thisArg, args));
+        }
+        return original.apply(thisArg, args);
+    }
+    /**
+     * End a span with either success or error status.
+     */
+    #endSpan(span, error) {
+        if (error) {
+            span.recordException(error);
+            span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        }
+        else {
+            span.setStatus({ code: SpanStatusCode.OK });
+        }
+        span.end();
+    }
+    /**
+     * Initialize the instrumentation by defining module patches.
+     */
+    init() {
+        return new InstrumentationNodeModuleDefinition(MODULE_NAME, ['>=1.0.0'], (moduleExports) => {
+            const ClickHouseClientClass = moduleExports.ClickHouseClient;
+            if (!ClickHouseClientClass?.prototype)
+                return moduleExports;
+            this.#wrapMethod(ClickHouseClientClass.prototype, 'query', 'query');
+            this.#wrapMethod(ClickHouseClientClass.prototype, 'insert', 'insert');
+            this.#wrapMethod(ClickHouseClientClass.prototype, 'command', 'command');
+            this.#wrapMethod(ClickHouseClientClass.prototype, 'exec', 'exec');
+            return moduleExports;
+        }, (moduleExports) => {
+            const ClickHouseClientClass = moduleExports.ClickHouseClient;
+            if (!ClickHouseClientClass?.prototype)
+                return moduleExports;
+            this._unwrap(ClickHouseClientClass.prototype, 'query');
+            this._unwrap(ClickHouseClientClass.prototype, 'insert');
+            this._unwrap(ClickHouseClientClass.prototype, 'command');
+            this._unwrap(ClickHouseClientClass.prototype, 'exec');
+            return moduleExports;
+        });
+    }
+}
+//# sourceMappingURL=instrumentation.js.map

package/build/src/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../src/instrumentation.ts"],"names":[],"mappings":"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"}

package/build/src/internal_types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Internal representation of the ClickHouse client instance.
+ * Used for accessing connection parameters during instrumentation.
+ */
+export interface ClickHouseClient {
+    connectionParams?: {
+        url?: URL;
+        database?: string;
+    };
+}
+/**
+ * Parameters for query, command, and exec operations.
+ */
+export interface QueryParams {
+    query?: string;
+    query_id?: string;
+}
+/**
+ * Parameters for insert operations.
+ * Extends QueryParams with table name support.
+ */
+export interface InsertParams extends QueryParams {
+    table?: string;
+}
+//# sourceMappingURL=internal_types.d.ts.map

package/build/src/internal_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal_types.d.ts","sourceRoot":"","sources":["../../src/internal_types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE;QACjB,GAAG,CAAC,EAAE,GAAG,CAAA;QACT,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/build/src/internal_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=internal_types.js.map

package/build/src/internal_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal_types.js","sourceRoot":"","sources":["../../src/internal_types.ts"],"names":[],"mappings":""}

package/build/src/types.d.ts

@@ -0,0 +1,26 @@
+import type { InstrumentationConfig } from '@opentelemetry/instrumentation';
+/**
+ * Configuration options for ClickHouse instrumentation.
+ */
+export interface ClickHouseInstrumentationConfig extends InstrumentationConfig {
+    /**
+     * Maximum length of the query to include in the span.
+     * Queries longer than this will be truncated.
+     * Set to 0 to disable query capture.
+     * @default 2048
+     */
+    maxQueryLength?: number;
+    /**
+     * Whether to require a parent span to create child spans.
+     * @default false
+     */
+    requireParentSpan?: boolean;
+    /**
+     * Whether to suppress internal HTTP instrumentation.
+     * When true, the HTTP spans for ClickHouse requests will not be created
+     * by @opentelemetry/instrumentation-http, avoiding duplicate spans.
+     * @default true
+     */
+    suppressInternalInstrumentation?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,qBAAqB;IAC5E;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAE3B;;;;;OAKG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAA;CAC1C"}

package/build/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@julr/otel-instrumentation-clickhouse",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "OpenTelemetry automatic instrumentation for ClickHouse client",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./build/src/index.js",
+  "module": "./build/src/index.js",
+  "types": "./build/src/index.d.ts",
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./build/src/index.js",
+      "types": "./build/src/index.d.ts"
     }
   },
   "files": [
-    "dist"
+    "build"
   ],
   "scripts": {
     "build": "tsc",