@autter/runtime-node 1.2.1 → 1.3.0

package/dist/index.cjs

@@ -238,6 +238,7 @@ function createBrowserRelayHandler(opts) {
 
 // src/server.ts
 var import_node_http = require("http");
+var import_node_crypto = require("crypto");
 var import_api = require("@opentelemetry/api");
 var import_core2 = require("@opentelemetry/core");
 var import_exporter_metrics_otlp_http = require("@opentelemetry/exporter-metrics-otlp-http");
@@ -764,12 +765,16 @@ function withSampledFlag(span) {
   };
 }
 var ErrorTraceRetentionProcessor = class {
-  constructor(inner) {
+  constructor(inner, retainErrors = true, slowThresholdMs = 0) {
     this.inner = inner;
+    this.retainErrors = retainErrors;
+    this.slowThresholdMs = slowThresholdMs;
     this.sweeper = setInterval(() => this.sweep(), RETENTION_SWEEP_INTERVAL_MS);
     this.sweeper.unref?.();
   }
   inner;
+  retainErrors;
+  slowThresholdMs;
   traces = /* @__PURE__ */ new Map();
   bufferedSpans = 0;
   sweeper;
@@ -781,7 +786,7 @@ var ErrorTraceRetentionProcessor = class {
     const entry = this.entryFor(ctx.traceId);
     if (entry.retained) {
       this.forward(span);
-    } else if (spanIndicatesError(span)) {
+    } else if (this.retainErrors && spanIndicatesError(span) || this.slowThresholdMs > 0 && span.kind === import_api.SpanKind.SERVER && span.duration[0] * 1e3 + span.duration[1] / 1e6 >= this.slowThresholdMs) {
       entry.retained = true;
       this.flush(entry);
       this.forward(span);
@@ -815,6 +820,10 @@ var ErrorTraceRetentionProcessor = class {
   entryFor(traceId) {
     let entry = this.traces.get(traceId);
     if (!entry) {
+      if (this.traces.size >= RETENTION_MAX_BUFFERED_SPANS) {
+        const oldest = this.traces.keys().next().value;
+        if (oldest) this.drop(oldest);
+      }
       entry = { spans: [], retained: false, firstSeenAtMs: Date.now() };
       this.traces.set(traceId, entry);
     }
@@ -996,6 +1005,7 @@ function initAutterServer(options) {
   activeRedactor = makeRedactor(options.redactAttributes ?? true);
   const resource = new import_resources.Resource({
     [import_semantic_conventions.ATTR_SERVICE_NAME]: options.service,
+    "service.instance.id": (0, import_node_crypto.randomUUID)(),
     ...options.release ? { [import_semantic_conventions.ATTR_SERVICE_VERSION]: options.release } : {},
     "deployment.environment": environment,
     // Tells the ingester request metrics arrive on the metrics pipe, so
@@ -1007,15 +1017,19 @@ function initAutterServer(options) {
     root: new import_sdk_trace_base.TraceIdRatioBasedSampler(options.traceSampleRate ?? 0.01)
   });
   const retainOnError = options.retainTracesOnError !== false;
-  let sampler = retainOnError ? new RecordUnsampledSampler(headSampler) : headSampler;
+  const slowThresholdMs = Number.isFinite(options.retainTracesAboveMs) ? Math.max(0, options.retainTracesAboveMs) : 0;
+  const retainTraces = retainOnError || slowThresholdMs > 0;
+  let sampler = retainTraces ? new RecordUnsampledSampler(headSampler) : headSampler;
   if (options.llmTracing !== false) sampler = new LlmAwareSampler(sampler);
-  const errorTraceBuffer = retainOnError ? new ErrorTraceRetentionProcessor(
+  const errorTraceBuffer = retainTraces ? new ErrorTraceRetentionProcessor(
     new import_sdk_trace_base.BatchSpanProcessor(
       new CountingExporter(
         new import_exporter_trace_otlp_http.OTLPTraceExporter({ url: `${endpoint}/v1/traces`, headers })
       ),
       { scheduledDelayMillis: 2e3 }
-    )
+    ),
+    retainOnError,
+    slowThresholdMs
   ) : null;
   const mainSpanProcessor = new import_sdk_trace_base.BatchSpanProcessor(
     new CountingExporter(
@@ -1042,6 +1056,14 @@ function initAutterServer(options) {
       ...errorTraceBuffer ? [errorTraceBuffer] : []
     ],
     metricReader,
+    views: [
+      new import_sdk_metrics.View({ instrumentName: "http.server.duration", aggregation: new import_sdk_metrics.ExplicitBucketHistogramAggregation(
+        [5, 10, 25, 50, 100, 250, 500, 750, 1e3, 1500, 2e3, 3e3, 5e3, 7500, 1e4, 15e3, 2e4, 3e4, 6e4, 12e4]
+      ) }),
+      new import_sdk_metrics.View({ instrumentName: "http.server.request.duration", aggregation: new import_sdk_metrics.ExplicitBucketHistogramAggregation(
+        [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 1, 1.5, 2, 3, 5, 7.5, 10, 15, 20, 30, 60, 120]
+      ) })
+    ],
     instrumentations: [
       new import_instrumentation_http.HttpInstrumentation({ responseHook: captureExpressRoute }),
       ...options.instrumentations ?? []

package/dist/index.d.cts

@@ -116,6 +116,7 @@ interface AutterServerOptions {
      * Default true.
      */
     retainTracesOnError?: boolean;
+    retainTracesAboveMs?: number;
     /** Metric export interval. Default 60_000 ms. */
     metricIntervalMs?: number;
     /** Capture crashing exceptions via process.uncaughtExceptionMonitor (default true). */

package/dist/index.d.ts

@@ -116,6 +116,7 @@ interface AutterServerOptions {
      * Default true.
      */
     retainTracesOnError?: boolean;
+    retainTracesAboveMs?: number;
     /** Metric export interval. Default 60_000 ms. */
     metricIntervalMs?: number;
     /** Capture crashing exceptions via process.uncaughtExceptionMonitor (default true). */

package/dist/index.js

@@ -199,6 +199,7 @@ function createBrowserRelayHandler(opts) {
 
 // src/server.ts
 import { ServerResponse } from "http";
+import { randomUUID } from "crypto";
 import {
   context,
   trace,
@@ -214,7 +215,7 @@ import {
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
 import { Resource } from "@opentelemetry/resources";
-import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
+import { ExplicitBucketHistogramAggregation, PeriodicExportingMetricReader, View } from "@opentelemetry/sdk-metrics";
 import { NodeSDK } from "@opentelemetry/sdk-node";
 import {
   BatchSpanProcessor,
@@ -744,12 +745,16 @@ function withSampledFlag(span) {
   };
 }
 var ErrorTraceRetentionProcessor = class {
-  constructor(inner) {
+  constructor(inner, retainErrors = true, slowThresholdMs = 0) {
     this.inner = inner;
+    this.retainErrors = retainErrors;
+    this.slowThresholdMs = slowThresholdMs;
     this.sweeper = setInterval(() => this.sweep(), RETENTION_SWEEP_INTERVAL_MS);
     this.sweeper.unref?.();
   }
   inner;
+  retainErrors;
+  slowThresholdMs;
   traces = /* @__PURE__ */ new Map();
   bufferedSpans = 0;
   sweeper;
@@ -761,7 +766,7 @@ var ErrorTraceRetentionProcessor = class {
     const entry = this.entryFor(ctx.traceId);
     if (entry.retained) {
       this.forward(span);
-    } else if (spanIndicatesError(span)) {
+    } else if (this.retainErrors && spanIndicatesError(span) || this.slowThresholdMs > 0 && span.kind === SpanKind.SERVER && span.duration[0] * 1e3 + span.duration[1] / 1e6 >= this.slowThresholdMs) {
       entry.retained = true;
       this.flush(entry);
       this.forward(span);
@@ -795,6 +800,10 @@ var ErrorTraceRetentionProcessor = class {
   entryFor(traceId) {
     let entry = this.traces.get(traceId);
     if (!entry) {
+      if (this.traces.size >= RETENTION_MAX_BUFFERED_SPANS) {
+        const oldest = this.traces.keys().next().value;
+        if (oldest) this.drop(oldest);
+      }
       entry = { spans: [], retained: false, firstSeenAtMs: Date.now() };
       this.traces.set(traceId, entry);
     }
@@ -976,6 +985,7 @@ function initAutterServer(options) {
   activeRedactor = makeRedactor(options.redactAttributes ?? true);
   const resource = new Resource({
     [ATTR_SERVICE_NAME]: options.service,
+    "service.instance.id": randomUUID(),
     ...options.release ? { [ATTR_SERVICE_VERSION]: options.release } : {},
     "deployment.environment": environment,
     // Tells the ingester request metrics arrive on the metrics pipe, so
@@ -987,15 +997,19 @@ function initAutterServer(options) {
     root: new TraceIdRatioBasedSampler(options.traceSampleRate ?? 0.01)
   });
   const retainOnError = options.retainTracesOnError !== false;
-  let sampler = retainOnError ? new RecordUnsampledSampler(headSampler) : headSampler;
+  const slowThresholdMs = Number.isFinite(options.retainTracesAboveMs) ? Math.max(0, options.retainTracesAboveMs) : 0;
+  const retainTraces = retainOnError || slowThresholdMs > 0;
+  let sampler = retainTraces ? new RecordUnsampledSampler(headSampler) : headSampler;
   if (options.llmTracing !== false) sampler = new LlmAwareSampler(sampler);
-  const errorTraceBuffer = retainOnError ? new ErrorTraceRetentionProcessor(
+  const errorTraceBuffer = retainTraces ? new ErrorTraceRetentionProcessor(
     new BatchSpanProcessor(
       new CountingExporter(
         new OTLPTraceExporter({ url: `${endpoint}/v1/traces`, headers })
       ),
       { scheduledDelayMillis: 2e3 }
-    )
+    ),
+    retainOnError,
+    slowThresholdMs
   ) : null;
   const mainSpanProcessor = new BatchSpanProcessor(
     new CountingExporter(
@@ -1022,6 +1036,14 @@ function initAutterServer(options) {
       ...errorTraceBuffer ? [errorTraceBuffer] : []
     ],
     metricReader,
+    views: [
+      new View({ instrumentName: "http.server.duration", aggregation: new ExplicitBucketHistogramAggregation(
+        [5, 10, 25, 50, 100, 250, 500, 750, 1e3, 1500, 2e3, 3e3, 5e3, 7500, 1e4, 15e3, 2e4, 3e4, 6e4, 12e4]
+      ) }),
+      new View({ instrumentName: "http.server.request.duration", aggregation: new ExplicitBucketHistogramAggregation(
+        [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 1, 1.5, 2, 3, 5, 7.5, 10, 15, 20, 30, 60, 120]
+      ) })
+    ],
     instrumentations: [
       new HttpInstrumentation({ responseHook: captureExpressRoute }),
       ...options.instrumentations ?? []

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@autter/runtime-node",
-	"version": "1.2.1",
+	"version": "1.3.0",
 	"description": "Autter Runtime for Node.js: same-origin browser relay handler + curated OpenTelemetry server tracker",
 	"license": "MIT",
 	"type": "module",