@sentienguard/apm 1.0.17 → 1.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentienguard/apm",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "SentienGuard APM SDK - Minimal, production-safe application performance monitoring",
   "main": "src/index.js",
   "types": "src/index.d.ts",

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
         }