@glasstrace/sdk 0.13.5 → 0.13.6

package/dist/index.d.cts

@@ -361,7 +361,7 @@ interface GlasstraceExporterOptions {
     environment: string | undefined;
     endpointUrl: string;
     createDelegate: ((url: string, headers: Record<string, string>) => SpanExporter) | null;
-    /** @deprecated No-op retained for backward compatibility. Will be removed in a future major. */
+    /** When true, logs diagnostic details about enrichment decisions via sdkLog. */
     verbose?: boolean;
 }
 /**
@@ -383,6 +383,7 @@ declare class GlasstraceExporter implements SpanExporter {
     private readonly environment;
     private readonly endpointUrl;
     private readonly createDelegateFn;
+    private readonly verbose;
     private delegate;
     private delegateKey;
     private pendingBatches;

package/dist/index.d.ts

@@ -361,7 +361,7 @@ interface GlasstraceExporterOptions {
     environment: string | undefined;
     endpointUrl: string;
     createDelegate: ((url: string, headers: Record<string, string>) => SpanExporter) | null;
-    /** @deprecated No-op retained for backward compatibility. Will be removed in a future major. */
+    /** When true, logs diagnostic details about enrichment decisions via sdkLog. */
     verbose?: boolean;
 }
 /**
@@ -383,6 +383,7 @@ declare class GlasstraceExporter implements SpanExporter {
     private readonly environment;
     private readonly endpointUrl;
     private readonly createDelegateFn;
+    private readonly verbose;
     private delegate;
     private delegateKey;
     private pendingBatches;

package/dist/index.js

@@ -591,6 +591,7 @@ var GlasstraceExporter = class {
   environment;
   endpointUrl;
   createDelegateFn;
+  verbose;
   delegate = null;
   delegateKey = null;
   pendingBatches = [];
@@ -603,6 +604,7 @@ var GlasstraceExporter = class {
     this.environment = options.environment;
     this.endpointUrl = options.endpointUrl;
     this.createDelegateFn = options.createDelegate;
+    this.verbose = options.verbose ?? false;
   }
   export(spans, resultCallback) {
     const currentKey = this.getApiKey();
@@ -708,7 +710,17 @@ var GlasstraceExporter = class {
       if (statusCode !== void 0) {
         extra[ATTR.HTTP_STATUS_CODE] = statusCode;
       }
-      if (method && span.status?.code === SpanStatusCode.ERROR) {
+      const isErrorByStatus = span.status?.code === SpanStatusCode.ERROR;
+      const isErrorByEvent = hasExceptionEvent(span);
+      const isErrorByAttrs = typeof attrs["exception.type"] === "string" || typeof attrs["exception.message"] === "string";
+      const statusNotExplicitlyOK = span.status?.code !== SpanStatusCode.OK;
+      if (this.verbose && method) {
+        sdkLog(
+          "info",
+          `[glasstrace] enrichSpan "${name}": status.code=${span.status?.code}, http.status_code=${statusCode}, isErrorByStatus=${isErrorByStatus}, isErrorByEvent=${isErrorByEvent}, isErrorByAttrs=${isErrorByAttrs}`
+        );
+      }
+      if (method && statusNotExplicitlyOK && (isErrorByStatus || isErrorByEvent || isErrorByAttrs)) {
         if (statusCode === void 0 || statusCode === 0 || statusCode === 200) {
           const httpErrorType = attrs["error.type"];
           if (typeof httpErrorType === "string") {
@@ -721,6 +733,12 @@ var GlasstraceExporter = class {
           } else {
             extra[ATTR.HTTP_STATUS_CODE] = 500;
           }
+          if (this.verbose) {
+            sdkLog(
+              "info",
+              `[glasstrace] enrichSpan "${name}": inferred status_code=${extra[ATTR.HTTP_STATUS_CODE]} (was ${statusCode}), error.type=${attrs["error.type"]}`
+            );
+          }
         }
       }
       if (span.startTime && span.endTime) {
@@ -731,14 +749,28 @@ var GlasstraceExporter = class {
           extra[ATTR.HTTP_DURATION_MS] = durationMs;
         }
       }
+      const eventDetails = statusNotExplicitlyOK ? getExceptionEventDetails(span) : { type: void 0, message: void 0 };
       const errorMessage = attrs["exception.message"];
       if (typeof errorMessage === "string") {
         extra[ATTR.ERROR_MESSAGE] = errorMessage;
+      } else if (eventDetails.message) {
+        extra[ATTR.ERROR_MESSAGE] = eventDetails.message;
       }
       const errorType = attrs["exception.type"];
       if (typeof errorType === "string") {
         extra[ATTR.ERROR_CODE] = errorType;
         extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(errorType);
+      } else if (eventDetails.type) {
+        extra[ATTR.ERROR_CODE] = eventDetails.type;
+        extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(eventDetails.type);
+      }
+      if (this.verbose && (extra[ATTR.ERROR_MESSAGE] || extra[ATTR.ERROR_CODE])) {
+        const msgSource = typeof errorMessage === "string" ? "attrs" : eventDetails.message ? "event" : "none";
+        const typeSource = typeof errorType === "string" ? "attrs" : eventDetails.type ? "event" : "none";
+        sdkLog(
+          "info",
+          `[glasstrace] enrichSpan "${name}": error.message source=${msgSource}, error.code source=${typeSource}`
+        );
       }
       const errorField = attrs["error.field"];
       if (typeof errorField === "string") {
@@ -861,6 +893,21 @@ function createEnrichedSpan(span, extra) {
     }
   });
 }
+function hasExceptionEvent(span) {
+  return span.events?.some((e) => e.name === "exception") ?? false;
+}
+function getExceptionEventDetails(span) {
+  const event = span.events?.find((e) => e.name === "exception");
+  if (!event?.attributes) {
+    return { type: void 0, message: void 0 };
+  }
+  const type = event.attributes["exception.type"];
+  const message = event.attributes["exception.message"];
+  return {
+    type: typeof type === "string" ? type : void 0,
+    message: typeof message === "string" ? message : void 0
+  };
+}
 function deriveOrmProvider(instrumentationName) {
   const lower = instrumentationName.toLowerCase();
   if (lower.includes("prisma")) {
@@ -3763,7 +3810,8 @@ async function configureOtel(config, sessionManager) {
     getConfig: () => getActiveConfig(),
     environment: config.environment,
     endpointUrl: exporterUrl,
-    createDelegate: createOtlpExporter
+    createDelegate: createOtlpExporter,
+    verbose: config.verbose
   });
   _activeExporter = glasstraceExporter;
   const vercelOtel = await tryImport("@vercel/otel");
@@ -4115,8 +4163,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("0.13.5");
-  const initResult = await performInit(config, anonKeyForInit, "0.13.5", healthReport);
+  const healthReport = collectHealthReport("0.13.6");
+  const initResult = await performInit(config, anonKeyForInit, "0.13.6", healthReport);
   if (generation !== registrationGeneration) return;
   if (initResult?.claimResult) {
     setResolvedApiKey(initResult.claimResult.newApiKey);
@@ -4124,7 +4172,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "0.13.5", generation, (newApiKey) => {
+    startHeartbeat(config, anonKeyForInit, "0.13.6", generation, (newApiKey) => {
       setResolvedApiKey(newApiKey);
       notifyApiKeyResolved();
     });