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

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @mastra/otel-exporter
 
+## 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`, `LAMINAR_TEAM_ID`
+
+  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`, `LAMINAR_TEAM_ID` (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,16 @@ 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
+LAMINAR_TEAM_ID=your-team-id  # For backwards compatibility
+```
 
 ```typescript
 import { OtelExporter } from '@mastra/otel-exporter';
@@ -176,24 +248,28 @@ 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: {} } })],
       },
     },
   },
 });
 ```
 
+#### Explicit Configuration
+
+```typescript
+new OtelExporter({
+  provider: {
+    laminar: {
+      apiKey: 'your-api-key',
+      teamId: 'your-team-id', // Optional, for backwards compatibility
+      endpoint: 'https://api.lmnr.ai/v1/traces', // Optional
+    },
+  },
+});
+```
+
 **Note:** Laminar now only requires the `LMNR_PROJECT_API_KEY`. The `teamId` is optional.
 
 ### Zipkin
@@ -340,7 +416,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,16 +200,21 @@ 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 teamId = config.teamId ?? process.env.LAMINAR_TEAM_ID;
+  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;
+  if (teamId) {
+    headers["x-laminar-team-id"] = teamId;
   }
   return {
     endpoint,