@mastra/datadog 1.4.5-alpha.0 → 1.4.5-alpha.1

package/README.md

@@ -5,132 +5,38 @@ Datadog LLM Observability exporter for Mastra. Exports observability data to [Da
 ## Installation
 
 ```bash
-pnpm add @mastra/datadog
+npm install @mastra/datadog
 ```
 
-## Requirements
-
-- **Node.js >=22.13.0** (Node.js 22.x recommended; `dd-trace` native modules ship prebuilt binaries for this ABI)
-- Datadog account with LLM Observability enabled
-- Datadog API key (available in your Datadog account settings)
-
 ## Usage
 
 ### Basic Setup
 
 ```typescript
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
+import { Observability } from '@mastra/observability';
 import { DatadogExporter } from '@mastra/datadog';
 
-const datadog = new DatadogExporter({
-  mlApp: 'my-llm-app',
-  apiKey: process.env.DD_API_KEY,
-});
-
-const mastra = new Mastra({
-  observability: {
+export const mastra = new Mastra({
+  observability: new Observability({
     configs: {
-      default: {
+      datadog: {
         serviceName: 'my-service',
-        exporters: [datadog],
+        exporters: [new DatadogExporter()],
       },
     },
-  },
-});
-```
-
-### With Local Datadog Agent (Optional)
-
-If you have a Datadog Agent running locally, you can use agent mode instead:
-
-```typescript
-const datadog = new DatadogExporter({
-  mlApp: 'my-llm-app',
-  agentless: false, // Use local Datadog Agent instead of direct HTTPS
-  env: 'production',
+  }),
 });
 ```
 
-### Configuration Options
-
-| Option                | Description                                          | Default                        |
-| --------------------- | ---------------------------------------------------- | ------------------------------ |
-| `apiKey`              | Datadog API key (required)                           | `DD_API_KEY` env var           |
-| `mlApp`               | ML application name for grouping traces (required)   | `DD_LLMOBS_ML_APP` env var     |
-| `site`                | Datadog site (e.g., 'datadoghq.com', 'datadoghq.eu') | `DD_SITE` or `'datadoghq.com'` |
-| `agentless`           | Use direct HTTPS intake (no local agent required)    | `true`                         |
-| `service`             | Service name for the application                     | Uses `mlApp` value             |
-| `env`                 | Environment name (e.g., 'production', 'staging')     | `DD_ENV` env var               |
-| `integrationsEnabled` | Enable dd-trace automatic integrations               | `false`                        |
-
-Note that the `site` is also used to specify non-default regions, e.g. `us3.datadoghq.com` instead of `us1.datadoghq.com`.
-
-### Environment Variables
-
-The exporter reads configuration from environment variables:
-
-- `DD_API_KEY` - Datadog API key (required)
-- `DD_LLMOBS_ML_APP` - ML application name
-- `DD_SITE` - Datadog site
-- `DD_ENV` - Environment name
-- `DD_LLMOBS_AGENTLESS_ENABLED` - Set to 'false' or '0' to use local Datadog Agent
+## Documentation
 
-## Span Type Mapping
+- [@mastra/datadog documentation](https://mastra.ai/integrations/observability/datadog)
 
-Mastra span types are mapped to Datadog LLMObs span kinds:
+## Changelog
 
-| Mastra SpanType    | Datadog Kind |
-| ------------------ | ------------ |
-| `AGENT_RUN`        | `agent`      |
-| `MODEL_GENERATION` | `workflow`   |
-| `MODEL_STEP`       | `llm`        |
-| `TOOL_CALL`        | `tool`       |
-| `MCP_TOOL_CALL`    | `tool`       |
-| `WORKFLOW_RUN`     | `workflow`   |
-| All other types    | `task`       |
-
-All unmapped span types (including `MODEL_CHUNK`, `GENERIC`, etc., and future span types) automatically default to `task`.
-
-## Features
-
-- **Completion-only pattern**: Spans are emitted at completion for efficient tracing
-- **Message formatting**: LLM inputs/outputs formatted as message arrays
-- **Metadata as tags**: Span metadata is flattened into searchable Datadog tags
-- **Error tracking**: Error spans include error tags with message, ID, and category
-- **Parent/child hierarchy**: Spans are emitted parent-first to preserve trace trees in Datadog
-
-## Troubleshooting
-
-### Native module ABI errors
-
-If you see errors like `No native build was found for runtime=node abi=137`:
-
-These are non-blocking warnings. The `dd-trace` native modules (`@datadog/native-metrics`, etc.) are **optional** and provide performance monitoring features. Core tracing works without them.
-
-**Options:**
-
-1. **Use Node.js 22.x** - Prebuilt binaries for `dd-trace` native modules target Node.js 22 (ABI 127/131). Newer Node.js versions have different ABIs.
-2. **Ignore the errors** - These are warnings, not fatal errors. LLM observability tracing functions normally without native modules.
-
-### Bundler configuration
-
-When using bundlers, mark `dd-trace` and native modules as external:
-
-```typescript
-// src/mastra/index.ts
-export const mastra = new Mastra({
-  bundler: {
-    externals: [
-      'dd-trace',
-      '@datadog/native-metrics',
-      '@datadog/native-appsec',
-      '@datadog/native-iast-taint-tracking',
-      '@datadog/pprof',
-    ],
-  },
-});
-```
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/observability/datadog/CHANGELOG.md) for version history and release notes.
 
-## License
+## Support
 
-Apache-2.0
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/datadog",
-  "version": "1.4.5-alpha.0",
+  "version": "1.4.5-alpha.1",
   "description": "Datadog LLM Observability exporter for Mastra - exports tracing data to Datadog's LLM Observability product",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "dd-trace": "^5.117.0",
-    "@mastra/observability": "1.17.5-alpha.0"
+    "@mastra/observability": "1.17.5-alpha.1"
   },
   "devDependencies": {
     "@types/node": "22.20.1",
@@ -34,9 +34,9 @@
     "tsdown": "0.22.9",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.129",
-    "@mastra/core": "1.64.0-alpha.2",
-    "@internal/types-builder": "0.0.104"
+    "@internal/types-builder": "0.0.104",
+    "@mastra/core": "1.64.0-alpha.7",
+    "@internal/lint": "0.0.129"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.16.0-0 <2.0.0-0",