toad-eye 2.4.2 → 2.4.4

package/README.md

@@ -120,6 +120,8 @@ const result = await traceLLMCall(
 
 > Or skip this entirely — use `instrument: ['openai']` for zero-code instrumentation.
 
+> **Note:** In short-lived scripts, call `await shutdown()` before exit to flush buffered spans. Long-running servers (Express, Hono, Next.js) don't need this — spans flush automatically.
+
 </details>
 
 ## Budget guards

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { execFileSync, spawn } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, realpathSync, writeFileSync, } from "node:fs";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { initObservability, traceLLMCall, shutdown, calculateCost, } from "./index.js";
@@ -277,8 +277,9 @@ function runCli() {
             process.exit(1);
     }
 }
-// Only auto-execute when run as CLI entry point, not when imported (e.g., in tests)
+// Only auto-execute when run as CLI entry point, not when imported (e.g., in tests).
+// Use realpathSync to resolve symlinks (npx creates a symlink in node_modules/.bin/).
 if (process.argv[1] !== undefined &&
-    fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
+    fileURLToPath(import.meta.url) === realpathSync(resolve(process.argv[1]))) {
     runCli();
 }

package/dist/core/tracer.js

@@ -3,7 +3,7 @@ import { resourceFromAttributes } from "@opentelemetry/resources";
 import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
 import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
-import { TraceIdRatioBasedSampler, ParentBasedSampler, } from "@opentelemetry/sdk-trace-node";
+import { TraceIdRatioBasedSampler, ParentBasedSampler, BatchSpanProcessor, } from "@opentelemetry/sdk-trace-node";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 import { initMetrics, resetMetrics } from "./metrics.js";
 import { resetCustomPricing } from "./pricing.js";
@@ -74,9 +74,11 @@ export function initObservability(config) {
         exporter: metricExporter,
         exportIntervalMillis: isCloudMode ? 10_000 : 5_000,
     });
-    // Add Vercel AI SDK SpanProcessor if 'ai' is in instrument list
+    // When custom SpanProcessors are needed (e.g., Vercel AI SDK),
+    // we must also include a BatchSpanProcessor for trace export —
+    // NodeSDK won't create one automatically when spanProcessors is provided.
     const spanProcessors = config.instrument?.includes("ai")
-        ? [new ToadEyeAISpanProcessor()]
+        ? [new BatchSpanProcessor(traceExporter), new ToadEyeAISpanProcessor()]
         : [];
     // SDK-side head sampling (default: 1.0 = send everything to Collector)
     const sdkRate = config.sampling?.sdkRate ?? 1.0;

package/package.json

@@ -1,30 +1,35 @@
 {
   "name": "toad-eye",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "Auto-instrumentation, cost tracking, budget guards, and observability for LLM services",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     },
     "./alerts": {
+      "types": "./dist/alerts/index.d.ts",
       "import": "./dist/alerts/index.js",
-      "types": "./dist/alerts/index.d.ts"
+      "default": "./dist/alerts/index.js"
     },
     "./drift": {
+      "types": "./dist/drift/index.d.ts",
       "import": "./dist/drift/index.js",
-      "types": "./dist/drift/index.d.ts"
+      "default": "./dist/drift/index.js"
     },
     "./export": {
+      "types": "./dist/export.d.ts",
       "import": "./dist/export.js",
-      "types": "./dist/export.d.ts"
+      "default": "./dist/export.js"
     },
     "./vercel": {
+      "types": "./dist/vercel.d.ts",
       "import": "./dist/vercel.js",
-      "types": "./dist/vercel.d.ts"
+      "default": "./dist/vercel.js"
     }
   },
   "bin": {

package/templates/otel-collector.yml

@@ -9,31 +9,29 @@ processors:
     timeout: 1s
 
   # Tail-based sampling: keeps 100% errors + slow traces, samples healthy traffic.
-  # Only applies to traces pipeline — metrics always get 100%.
-  # To disable: remove tail_sampling from traces pipeline processors.
+  # Disabled by default for local development (100% of traces kept).
+  # To enable for production: change sampling_percentage to 10 (or your desired rate)
+  # and uncomment tail_sampling in the traces pipeline processors below.
   tail_sampling:
     decision_wait: 10s
     num_traces: 100000
     expected_new_traces_per_sec: 100
     policies:
-      # Keep all traces with errors
       - name: errors-always
         type: status_code
         status_code:
           status_codes: [ERROR]
-      # Keep all slow traces (> 2s)
       - name: slow-traces
         type: latency
         latency:
           threshold_ms: 2000
-      # Sample 10% of remaining healthy traffic
       - name: probabilistic-fallback
         type: probabilistic
         probabilistic:
-          sampling_percentage: 10
+          sampling_percentage: 100
 
 exporters:
-  otlphttp/jaeger:
+  otlp_http/jaeger:
     endpoint: http://jaeger:4318
     tls:
       insecure: true
@@ -45,8 +43,8 @@ service:
   pipelines:
     traces:
       receivers: [otlp]
-      processors: [tail_sampling, batch]
-      exporters: [otlphttp/jaeger]
+      processors: [batch]
+      exporters: [otlp_http/jaeger]
     metrics:
       receivers: [otlp]
       processors: [batch]