@sentienguard/apm 1.0.17 → 1.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentienguard/apm",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "SentienGuard APM SDK - Minimal, production-safe application performance monitoring",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -58,6 +58,8 @@
     "@opentelemetry/core": "^2.6.1",
     "@opentelemetry/instrumentation-express": "^0.46.0",
     "@opentelemetry/instrumentation-http": "^0.57.2",
+    "@opentelemetry/instrumentation-mongodb": "^0.68.0",
+    "@opentelemetry/instrumentation-mongoose": "^0.61.0",
     "@opentelemetry/resources": "^1.30.1",
     "@opentelemetry/sdk-node": "^0.57.2",
     "@opentelemetry/sdk-trace-base": "^1.30.1",

package/src/traceSpanExporter.js

@@ -10,6 +10,45 @@ import { SpanStatusCode } from '@opentelemetry/api';
 import { enqueueSpans } from './traceTransport.js';
 import { getConfig } from './config.js';
 
+let debugLogged = 0;
+const DEBUG_LOG_LIMIT = 10;
+
+function debugSpanShape(span, serialized, cfg) {
+  try {
+    if (!cfg?.debug) return;
+    if (debugLogged >= DEBUG_LOG_LIMIT) return;
+    debugLogged++;
+
+    const attrObj = serialized?.attributes && typeof serialized.attributes === 'object' ? serialized.attributes : {};
+    const keys = Object.keys(attrObj);
+    const sample = keys.slice(0, 12).reduce((acc, k) => {
+      acc[k] = attrObj[k];
+      return acc;
+    }, {});
+
+    // eslint-disable-next-line no-console
+    console.log(
+      '[SentienGuard APM][trace-debug]',
+      JSON.stringify(
+        {
+          name: serialized?.name,
+          kind: serialized?.kind,
+          status: serialized?.status?.code,
+          trace_id: serialized?.trace_id,
+          span_id: serialized?.span_id,
+          parent_span_id: serialized?.parent_span_id,
+          attributes_count: keys.length,
+          attributes_sample: sample
+        },
+        null,
+        0
+      )
+    );
+  } catch {
+    // never break the app
+  }
+}
+
 function hrTimeToUnixNanoString(hrTime) {
   // hrTime is [seconds, nanoseconds]
   if (!Array.isArray(hrTime) || hrTime.length !== 2) return '';
@@ -98,7 +137,10 @@ export class SentienGuardTraceSpanExporter {
       for (const span of spans) {
         try {
           const s = serializeSpan(span);
-          if (s && shouldSampleTraceId(s.trace_id, rate)) serialized.push(s);
+          if (s && shouldSampleTraceId(s.trace_id, rate)) {
+            debugSpanShape(span, s, cfg);
+            serialized.push(s);
+          }
         } catch {
           // ignore
         }

package/src/tracing.js

@@ -10,6 +10,8 @@ import { SEMRESATTRS_SERVICE_NAME, SEMRESATTRS_DEPLOYMENT_ENVIRONMENT } from '@o
 import { W3CTraceContextPropagator } from '@opentelemetry/core';
 import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
 import { ExpressInstrumentation } from '@opentelemetry/instrumentation-express';
+import { MongoDBInstrumentation } from '@opentelemetry/instrumentation-mongodb';
+import { MongooseInstrumentation } from '@opentelemetry/instrumentation-mongoose';
 import { AlwaysOnSampler, BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
 import { getConfig, debug } from './config.js';
 import { SentienGuardSpanExporter } from './spanExporter.js';
@@ -169,6 +171,8 @@ export function startTracing() {
     });
 
     const expressInstrumentation = new ExpressInstrumentation();
+    const mongoInstrumentation = new MongoDBInstrumentation();
+    const mongooseInstrumentation = new MongooseInstrumentation();
 
     sdk = new NodeSDK({
       resource,
@@ -176,7 +180,9 @@ export function startTracing() {
       // Raw trace export sampling is handled inside SentienGuardTraceSpanExporter instead.
       sampler: new AlwaysOnSampler(),
       textMapPropagator: new W3CTraceContextPropagator(),
-      instrumentations: [httpInstrumentation, expressInstrumentation],
+      // Include MongoDB/Mongoose instrumentations for "zero-code" DB spans.
+      // These are safe even when the app doesn't use MongoDB; they patch when modules are loaded.
+      instrumentations: [httpInstrumentation, expressInstrumentation, mongoInstrumentation, mongooseInstrumentation],
       spanProcessors: [
         new BatchSpanProcessor(metricsExporter),
         new BatchSpanProcessor(traceExporter)