@mastra/otel-exporter 1.0.0-beta.11 → 1.0.0-beta.13

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @mastra/otel-exporter
 
+## 1.0.0-beta.13
+
+### Minor Changes
+
+- Added `TrackingExporter` base class with improved handling for: ([#11870](https://github.com/mastra-ai/mastra/pull/11870))
+  - **Out-of-order span processing**: Spans that arrive before their parents are now queued and processed once dependencies are available
+  - **Delayed cleanup**: Trace data is retained briefly after spans end to handle late-arriving updates
+  - **Memory management**: Configurable limits on pending and total traces to prevent memory leaks
+
+  New configuration options on `TrackingExporterConfig`:
+  - `earlyQueueMaxAttempts` - Max retry attempts for queued events (default: 5)
+  - `earlyQueueTTLMs` - TTL for queued events in ms (default: 30000)
+  - `traceCleanupDelayMs` - Delay before cleaning up completed traces (default: 30000)
+  - `maxPendingCleanupTraces` - Soft cap on traces awaiting cleanup (default: 100)
+  - `maxTotalTraces` - Hard cap on total traces (default: 500)
+
+  Updated @mastra/braintrust, @mastra/langfuse, @mastra/langsmith, @mastra/posthog to use the new TrackingExporter
+
+- Export getAttributes and getSpanName GenAI semantic convention helpers ([#11890](https://github.com/mastra-ai/mastra/pull/11890))
+
+  These functions were previously internal but are now exported to support:
+  - The new @mastra/sentry exporter which uses them for consistent attribute formatting
+  - Custom exporter implementations that want to follow GenAI semantic conventions
+
+### Patch Changes
+
+- Fixed formatting of model_step, model_chunk, and tool_call spans in Arize Exporter. ([#11922](https://github.com/mastra-ai/mastra/pull/11922))
+
+  Also removed `tools` output from `model_step` spans for all exporters.
+
+- Updated dependencies [[`ebae12a`](https://github.com/mastra-ai/mastra/commit/ebae12a2dd0212e75478981053b148a2c246962d), [`c61a0a5`](https://github.com/mastra-ai/mastra/commit/c61a0a5de4904c88fd8b3718bc26d1be1c2ec6e7), [`69136e7`](https://github.com/mastra-ai/mastra/commit/69136e748e32f57297728a4e0f9a75988462f1a7), [`449aed2`](https://github.com/mastra-ai/mastra/commit/449aed2ba9d507b75bf93d427646ea94f734dfd1), [`eb648a2`](https://github.com/mastra-ai/mastra/commit/eb648a2cc1728f7678768dd70cd77619b448dab9), [`0131105`](https://github.com/mastra-ai/mastra/commit/0131105532e83bdcbb73352fc7d0879eebf140dc), [`9d5059e`](https://github.com/mastra-ai/mastra/commit/9d5059eae810829935fb08e81a9bb7ecd5b144a7), [`ef756c6`](https://github.com/mastra-ai/mastra/commit/ef756c65f82d16531c43f49a27290a416611e526), [`b00ccd3`](https://github.com/mastra-ai/mastra/commit/b00ccd325ebd5d9e37e34dd0a105caae67eb568f), [`3bdfa75`](https://github.com/mastra-ai/mastra/commit/3bdfa7507a91db66f176ba8221aa28dd546e464a), [`e770de9`](https://github.com/mastra-ai/mastra/commit/e770de941a287a49b1964d44db5a5763d19890a6), [`52e2716`](https://github.com/mastra-ai/mastra/commit/52e2716b42df6eff443de72360ae83e86ec23993), [`27b4040`](https://github.com/mastra-ai/mastra/commit/27b4040bfa1a95d92546f420a02a626b1419a1d6), [`610a70b`](https://github.com/mastra-ai/mastra/commit/610a70bdad282079f0c630e0d7bb284578f20151), [`8dc7f55`](https://github.com/mastra-ai/mastra/commit/8dc7f55900395771da851dc7d78d53ae84fe34ec), [`8379099`](https://github.com/mastra-ai/mastra/commit/8379099fc467af6bef54dd7f80c9bd75bf8bbddf), [`b06be72`](https://github.com/mastra-ai/mastra/commit/b06be7223d5ef23edc98c01a67ef713c6cc039f9), [`8c0ec25`](https://github.com/mastra-ai/mastra/commit/8c0ec25646c8a7df253ed1e5ff4863a0d3f1316c), [`ff4d9a6`](https://github.com/mastra-ai/mastra/commit/ff4d9a6704fc87b31a380a76ed22736fdedbba5a), [`69821ef`](https://github.com/mastra-ai/mastra/commit/69821ef806482e2c44e2197ac0b050c3fe3a5285), [`1ed5716`](https://github.com/mastra-ai/mastra/commit/1ed5716830867b3774c4a1b43cc0d82935f32b96), [`4186bdd`](https://github.com/mastra-ai/mastra/commit/4186bdd00731305726fa06adba0b076a1d50b49f), [`7aaf973`](https://github.com/mastra-ai/mastra/commit/7aaf973f83fbbe9521f1f9e7a4fd99b8de464617)]:
+  - @mastra/core@1.0.0-beta.22
+  - @mastra/observability@1.0.0-beta.11
+
+## 1.0.0-beta.12
+
+### Minor Changes
+
+- feat(observability): add zero-config environment variable support for all exporters ([#11686](https://github.com/mastra-ai/mastra/pull/11686))
+
+  All observability exporters now support zero-config setup via environment variables. Set the appropriate environment variables and instantiate exporters with no configuration:
+  - **Langfuse**: `LANGFUSE_PUBLIC_KEY`, `LANGFUSE_SECRET_KEY`, `LANGFUSE_BASE_URL`
+  - **Braintrust**: `BRAINTRUST_API_KEY`, `BRAINTRUST_ENDPOINT`
+  - **PostHog**: `POSTHOG_API_KEY`, `POSTHOG_HOST`
+  - **Arize/Phoenix**: `ARIZE_SPACE_ID`, `ARIZE_API_KEY`, `ARIZE_PROJECT_NAME`, `PHOENIX_ENDPOINT`, `PHOENIX_API_KEY`, `PHOENIX_PROJECT_NAME`
+  - **OTEL Providers**:
+    - Dash0: `DASH0_API_KEY`, `DASH0_ENDPOINT`, `DASH0_DATASET`
+    - SigNoz: `SIGNOZ_API_KEY`, `SIGNOZ_REGION`, `SIGNOZ_ENDPOINT`
+    - New Relic: `NEW_RELIC_LICENSE_KEY`, `NEW_RELIC_ENDPOINT`
+    - Traceloop: `TRACELOOP_API_KEY`, `TRACELOOP_DESTINATION_ID`, `TRACELOOP_ENDPOINT`
+    - Laminar: `LMNR_PROJECT_API_KEY`, `LAMINAR_ENDPOINT`
+
+  Example usage:
+
+  ```typescript
+  // Zero-config - reads from environment variables
+  new LangfuseExporter();
+  new BraintrustExporter();
+  new PosthogExporter();
+  new ArizeExporter();
+  new OtelExporter({ provider: { signoz: {} } });
+  ```
+
+  Explicit configuration still works and takes precedence over environment variables.
+
+### Patch Changes
+
+- Updated dependencies [[`08766f1`](https://github.com/mastra-ai/mastra/commit/08766f15e13ac0692fde2a8bd366c2e16e4321df), [`ae8baf7`](https://github.com/mastra-ai/mastra/commit/ae8baf7d8adcb0ff9dac11880400452bc49b33ff), [`cfabdd4`](https://github.com/mastra-ai/mastra/commit/cfabdd4aae7a726b706942d6836eeca110fb6267), [`a0e437f`](https://github.com/mastra-ai/mastra/commit/a0e437fac561b28ee719e0302d72b2f9b4c138f0), [`bec5efd`](https://github.com/mastra-ai/mastra/commit/bec5efde96653ccae6604e68c696d1bc6c1a0bf5), [`9eedf7d`](https://github.com/mastra-ai/mastra/commit/9eedf7de1d6e0022a2f4e5e9e6fe1ec468f9b43c)]:
+  - @mastra/core@1.0.0-beta.21
+
 ## 1.0.0-beta.11
 
 ### Patch Changes

package/README.md

@@ -4,6 +4,18 @@ Export Mastra traces to any OpenTelemetry-compatible observability platform.
 
 > **⚠️ Important:** This package requires you to install an additional exporter package based on your provider. Each provider section below includes the specific installation command.
 
+## Environment Variables
+
+All providers support zero-config setup via environment variables. Set the appropriate variables and the exporter will automatically use them:
+
+| Provider  | Environment Variables                                                                       |
+| --------- | ------------------------------------------------------------------------------------------- |
+| Dash0     | `DASH0_API_KEY` (required), `DASH0_ENDPOINT` (required), `DASH0_DATASET` (optional)         |
+| SigNoz    | `SIGNOZ_API_KEY` (required), `SIGNOZ_REGION` (optional), `SIGNOZ_ENDPOINT` (optional)       |
+| New Relic | `NEW_RELIC_LICENSE_KEY` (required), `NEW_RELIC_ENDPOINT` (optional)                         |
+| Traceloop | `TRACELOOP_API_KEY` (required), `TRACELOOP_DESTINATION_ID`, `TRACELOOP_ENDPOINT` (optional) |
+| Laminar   | `LMNR_PROJECT_API_KEY` (required), `LAMINAR_ENDPOINT` (optional)                            |
+
 ## Supported Providers
 
 ### Dash0
@@ -15,7 +27,16 @@ Export Mastra traces to any OpenTelemetry-compatible observability platform.
 npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
 ```
 
-#### Configuration
+#### Zero-Config Setup
+
+```bash
+# Required
+DASH0_API_KEY=your-api-key
+DASH0_ENDPOINT=ingress.us-west-2.aws.dash0.com:4317
+
+# Optional
+DASH0_DATASET=production
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -26,24 +47,28 @@ const mastra = new Mastra({
   observability: {
     configs: {
       otel: {
-        serviceName: 'mastra-service',
-        exporters: [
-          new OtelExporter({
-            provider: {
-              dash0: {
-                apiKey: process.env.DASH0_API_KEY, // Required at runtime
-                endpoint: 'ingress.us-west-2.aws.dash0.com:4317', // Required at runtime
-                dataset: 'production', // Optional: dataset name
-              }
-            },
-          })
-        ],
+        serviceName: 'my-service',
+        exporters: [new OtelExporter({ provider: { dash0: {} } })],
       },
     },
   },
 });
 ```
 
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    dash0: {
+      apiKey: 'your-api-key',
+      endpoint: 'ingress.us-west-2.aws.dash0.com:4317',
+      dataset: 'production', // Optional
+    },
+  },
+});
+```
+
 **Note:** Get your endpoint from your Dash0 dashboard. It should be in the format `ingress.{region}.aws.dash0.com:4317`.
 
 ### SigNoz
@@ -54,7 +79,16 @@ const mastra = new Mastra({
 npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
 ```
 
-#### Configuration
+#### Zero-Config Setup
+
+```bash
+# Required
+SIGNOZ_API_KEY=your-api-key
+
+# Optional
+SIGNOZ_REGION=us  # 'us' | 'eu' | 'in'
+SIGNOZ_ENDPOINT=https://my-signoz.example.com  # For self-hosted
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -65,24 +99,28 @@ const mastra = new Mastra({
   observability: {
     configs: {
       otel: {
-        serviceName: 'mastra-service',
-        exporters: [
-          new OtelExporter({
-            provider: {
-              signoz: {
-                apiKey: process.env.SIGNOZ_API_KEY, // Required at runtime
-                region: 'us', // Optional: 'us' | 'eu' | 'in', defaults to 'us'
-                // endpoint: 'https://my-signoz.example.com', // Optional: for self-hosted
-              }
-            },
-          })
-        ],
+        serviceName: 'my-service',
+        exporters: [new OtelExporter({ provider: { signoz: {} } })],
       },
     },
   },
 });
 ```
 
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    signoz: {
+      apiKey: 'your-api-key',
+      region: 'us', // Optional: 'us' | 'eu' | 'in'
+      endpoint: 'https://my-signoz.example.com', // Optional: for self-hosted
+    },
+  },
+});
+```
+
 ### New Relic
 
 #### Installation
@@ -91,7 +129,15 @@ const mastra = new Mastra({
 npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
 ```
 
-#### Configuration
+#### Zero-Config Setup
+
+```bash
+# Required
+NEW_RELIC_LICENSE_KEY=your-license-key
+
+# Optional
+NEW_RELIC_ENDPOINT=https://otlp.eu01.nr-data.net  # For EU region
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -102,23 +148,27 @@ const mastra = new Mastra({
   observability: {
     configs: {
       otel: {
-        serviceName: 'mastra-service',
-        exporters: [
-          new OtelExporter({
-            provider: {
-              newrelic: {
-                apiKey: process.env.NEW_RELIC_LICENSE_KEY, // Required at runtime
-                // endpoint: 'https://otlp.eu01.nr-data.net', // Optional: for EU region
-              }
-            },
-          })
-        ],
+        serviceName: 'my-service',
+        exporters: [new OtelExporter({ provider: { newrelic: {} } })],
       },
     },
   },
 });
 ```
 
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    newrelic: {
+      apiKey: 'your-license-key',
+      endpoint: 'https://otlp.eu01.nr-data.net', // Optional: for EU region
+    },
+  },
+});
+```
+
 ### Traceloop
 
 #### Installation
@@ -128,7 +178,16 @@ const mastra = new Mastra({
 npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-http
 ```
 
-#### Configuration
+#### Zero-Config Setup
+
+```bash
+# Required
+TRACELOOP_API_KEY=your-api-key
+
+# Optional
+TRACELOOP_DESTINATION_ID=my-destination
+TRACELOOP_ENDPOINT=https://custom.traceloop.com
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -139,24 +198,28 @@ const mastra = new Mastra({
   observability: {
     configs: {
       otel: {
-        serviceName: 'mastra-service',
-        exporters: [
-          new OtelExporter({
-            provider: {
-              traceloop: {
-                apiKey: process.env.TRACELOOP_API_KEY, // Required at runtime
-                destinationId: 'my-destination', // Optional
-                // endpoint: 'https://custom.traceloop.com', // Optional
-              }
-            },
-          })
-        ],
+        serviceName: 'my-service',
+        exporters: [new OtelExporter({ provider: { traceloop: {} } })],
       },
     },
   },
 });
 ```
 
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    traceloop: {
+      apiKey: 'your-api-key',
+      destinationId: 'my-destination', // Optional
+      endpoint: 'https://custom.traceloop.com', // Optional
+    },
+  },
+});
+```
+
 ### Laminar
 
 #### Installation
@@ -165,7 +228,15 @@ const mastra = new Mastra({
 npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
 ```
 
-#### Configuration
+#### Zero-Config Setup
+
+```bash
+# Required
+LMNR_PROJECT_API_KEY=your-api-key
+
+# Optional
+LAMINAR_ENDPOINT=https://api.lmnr.ai/v1/traces
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -176,25 +247,26 @@ const mastra = new Mastra({
   observability: {
     configs: {
       otel: {
-        serviceName: 'mastra-service',
-        exporters: [
-          new OtelExporter({
-            provider: {
-              laminar: {
-                apiKey: process.env.LMNR_PROJECT_API_KEY, // Required at runtime
-                // teamId: process.env.LAMINAR_TEAM_ID, // Optional, for backwards compatibility
-                // endpoint: 'https://api.lmnr.ai/v1/traces', // Optional
-              }
-            },
-          })
-        ],
+        serviceName: 'my-service',
+        exporters: [new OtelExporter({ provider: { laminar: {} } })],
       },
     },
   },
 });
 ```
 
-**Note:** Laminar now only requires the `LMNR_PROJECT_API_KEY`. The `teamId` is optional.
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    laminar: {
+      apiKey: 'your-api-key',
+      endpoint: 'https://api.lmnr.ai/v1/traces', // Optional
+    },
+  },
+});
+```
 
 ### Zipkin
 
@@ -340,7 +412,7 @@ The OtelExporter uses OpenTelemetry's `BatchSpanProcessor` for efficient span ex
 - **Default batch size**: 512 spans (configurable via `batchSize`)
 - **Export interval**: Every 5 seconds or when batch is full
 - **Queue size**: Up to 2048 spans queued in memory
-- **Production-ready**: Optimized for high-throughput applications
+- **High-throughput support**: Handles large volumes of spans efficiently
 
 This approach ensures:
 

package/dist/index.cjs

@@ -106,24 +106,31 @@ function resolveProviderConfig(config) {
   }
 }
 function resolveDash0Config(config) {
-  if (!config.apiKey) {
-    console.error("[OtelExporter] Dash0 configuration requires apiKey. Tracing will be disabled.");
+  const apiKey = config.apiKey ?? process.env.DASH0_API_KEY;
+  const configEndpoint = config.endpoint ?? process.env.DASH0_ENDPOINT;
+  const dataset = config.dataset ?? process.env.DASH0_DATASET;
+  if (!apiKey) {
+    console.error(
+      "[OtelExporter] Dash0 configuration requires apiKey. Set DASH0_API_KEY environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  if (!config.endpoint) {
-    console.error("[OtelExporter] Dash0 configuration requires endpoint. Tracing will be disabled.");
+  if (!configEndpoint) {
+    console.error(
+      "[OtelExporter] Dash0 configuration requires endpoint. Set DASH0_ENDPOINT environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  let endpoint = config.endpoint;
+  let endpoint = configEndpoint;
   if (!endpoint.includes("/v1/traces")) {
     endpoint = `${endpoint}/v1/traces`;
   }
   const headers = {
-    authorization: `Bearer ${config.apiKey}`
+    authorization: `Bearer ${apiKey}`
     // lowercase for gRPC metadata
   };
-  if (config.dataset) {
-    headers["dash0-dataset"] = config.dataset;
+  if (dataset) {
+    headers["dash0-dataset"] = dataset;
   }
   return {
     endpoint,
@@ -133,44 +140,58 @@ function resolveDash0Config(config) {
   };
 }
 function resolveSignozConfig(config) {
-  if (!config.apiKey) {
-    console.error("[OtelExporter] SigNoz configuration requires apiKey. Tracing will be disabled.");
+  const apiKey = config.apiKey ?? process.env.SIGNOZ_API_KEY;
+  const region = config.region ?? process.env.SIGNOZ_REGION;
+  const configEndpoint = config.endpoint ?? process.env.SIGNOZ_ENDPOINT;
+  if (!apiKey) {
+    console.error(
+      "[OtelExporter] SigNoz configuration requires apiKey. Set SIGNOZ_API_KEY environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  const endpoint = config.endpoint || `https://ingest.${config.region || "us"}.signoz.cloud:443/v1/traces`;
+  const endpoint = configEndpoint || `https://ingest.${region || "us"}.signoz.cloud:443/v1/traces`;
   return {
     endpoint,
     headers: {
-      "signoz-ingestion-key": config.apiKey
+      "signoz-ingestion-key": apiKey
     },
     protocol: "http/protobuf"
   };
 }
 function resolveNewRelicConfig(config) {
-  if (!config.apiKey) {
-    console.error("[OtelExporter] New Relic configuration requires apiKey (license key). Tracing will be disabled.");
+  const apiKey = config.apiKey ?? process.env.NEW_RELIC_LICENSE_KEY;
+  const configEndpoint = config.endpoint ?? process.env.NEW_RELIC_ENDPOINT;
+  if (!apiKey) {
+    console.error(
+      "[OtelExporter] New Relic configuration requires apiKey (license key). Set NEW_RELIC_LICENSE_KEY environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  const endpoint = config.endpoint || "https://otlp.nr-data.net:443/v1/traces";
+  const endpoint = configEndpoint || "https://otlp.nr-data.net:443/v1/traces";
   return {
     endpoint,
     headers: {
-      "api-key": config.apiKey
+      "api-key": apiKey
     },
     protocol: "http/protobuf"
   };
 }
 function resolveTraceloopConfig(config) {
-  if (!config.apiKey) {
-    console.error("[OtelExporter] Traceloop configuration requires apiKey. Tracing will be disabled.");
+  const apiKey = config.apiKey ?? process.env.TRACELOOP_API_KEY;
+  const destinationId = config.destinationId ?? process.env.TRACELOOP_DESTINATION_ID;
+  const configEndpoint = config.endpoint ?? process.env.TRACELOOP_ENDPOINT;
+  if (!apiKey) {
+    console.error(
+      "[OtelExporter] Traceloop configuration requires apiKey. Set TRACELOOP_API_KEY environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  const endpoint = config.endpoint || "https://api.traceloop.com/v1/traces";
+  const endpoint = configEndpoint || "https://api.traceloop.com/v1/traces";
   const headers = {
-    Authorization: `Bearer ${config.apiKey}`
+    Authorization: `Bearer ${apiKey}`
   };
-  if (config.destinationId) {
-    headers["x-traceloop-destination-id"] = config.destinationId;
+  if (destinationId) {
+    headers["x-traceloop-destination-id"] = destinationId;
   }
   return {
     endpoint,
@@ -179,17 +200,18 @@ function resolveTraceloopConfig(config) {
   };
 }
 function resolveLaminarConfig(config) {
-  if (!config.apiKey) {
-    console.error("[OtelExporter] Laminar configuration requires apiKey. Tracing will be disabled.");
+  const apiKey = config.apiKey ?? process.env.LMNR_PROJECT_API_KEY;
+  const configEndpoint = config.endpoint ?? process.env.LAMINAR_ENDPOINT;
+  if (!apiKey) {
+    console.error(
+      "[OtelExporter] Laminar configuration requires apiKey. Set LMNR_PROJECT_API_KEY environment variable or pass it in config. Tracing will be disabled."
+    );
     return null;
   }
-  const endpoint = config.endpoint || "https://api.lmnr.ai/v1/traces";
+  const endpoint = configEndpoint || "https://api.lmnr.ai/v1/traces";
   const headers = {
-    Authorization: `Bearer ${config.apiKey}`
+    Authorization: `Bearer ${apiKey}`
   };
-  if (config.teamId) {
-    headers["x-laminar-team-id"] = config.teamId;
-  }
   return {
     endpoint,
     headers,
@@ -334,10 +356,10 @@ function getSpanIdentifier(span) {
   switch (span.type) {
     case observability.SpanType.MODEL_GENERATION: {
       const attrs = span.attributes;
-      return attrs?.model ?? "unknown";
+      return attrs?.model;
     }
     default:
-      return span.entityName ?? span.entityId ?? "unknown";
+      return span.entityName ?? span.entityId;
   }
 }
 function getSpanName(span) {
@@ -701,16 +723,15 @@ var OtelExporter = class extends observability$1.BaseExporter {
   async setupExporter() {
     if (this.isSetup || this.exporter) return;
     if (!this.config.provider) {
-      this.logger.error(
+      this.setDisabled(
         '[OtelExporter] Provider configuration is required. Use the "custom" provider for generic endpoints.'
       );
-      this.isDisabled = true;
       this.isSetup = true;
       return;
     }
     const resolved = resolveProviderConfig(this.config.provider);
     if (!resolved) {
-      this.isDisabled = true;
+      this.setDisabled("[OtelExporter] Provider configuration validation failed.");
       this.isSetup = true;
       return;
     }
@@ -724,7 +745,7 @@ var OtelExporter = class extends observability$1.BaseExporter {
     const providerName = Object.keys(this.config.provider)[0];
     const ExporterClass = await loadExporter(protocol, providerName);
     if (!ExporterClass) {
-      this.isDisabled = true;
+      this.setDisabled(`[OtelExporter] Exporter not available for protocol: ${protocol}`);
       this.isSetup = true;
       return;
     }
@@ -743,13 +764,11 @@ var OtelExporter = class extends observability$1.BaseExporter {
             metadata.set(key, value);
           });
         } catch (grpcError) {
-          this.logger.error(
+          this.setDisabled(
             `[OtelExporter] Failed to load gRPC metadata. Install required packages:
-  npm install @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
-`,
-            grpcError
+  npm install @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js`
           );
-          this.isDisabled = true;
+          this.logger.error("[OtelExporter] gRPC error details:", grpcError);
           this.isSetup = true;
           return;
         }
@@ -766,8 +785,8 @@ var OtelExporter = class extends observability$1.BaseExporter {
         });
       }
     } catch (error) {
-      this.logger.error(`[OtelExporter] Failed to create exporter:`, error);
-      this.isDisabled = true;
+      this.setDisabled("[OtelExporter] Failed to create exporter.");
+      this.logger.error("[OtelExporter] Exporter creation error details:", error);
       this.isSetup = true;
       return;
     }
@@ -836,6 +855,8 @@ var OtelExporter = class extends observability$1.BaseExporter {
 
 exports.OtelExporter = OtelExporter;
 exports.SpanConverter = SpanConverter;
+exports.getAttributes = getAttributes;
 exports.getSpanKind = getSpanKind;
+exports.getSpanName = getSpanName;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map