@mastra/datadog 1.4.4 → 1.4.5-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +14 -108
  2. package/dist/bridge.d.ts.map +1 -1
  3. package/dist/tracing.d.ts.map +1 -1
  4. package/package.json +7 -8
  5. package/CHANGELOG.md +0 -1451
package/README.md CHANGED
@@ -5,132 +5,38 @@ Datadog LLM Observability exporter for Mastra. Exports observability data to [Da
5
5
  ## Installation
6
6
 
7
7
  ```bash
8
- pnpm add @mastra/datadog
8
+ npm install @mastra/datadog
9
9
  ```
10
10
 
11
- ## Requirements
12
-
13
- - **Node.js >=22.13.0** (Node.js 22.x recommended; `dd-trace` native modules ship prebuilt binaries for this ABI)
14
- - Datadog account with LLM Observability enabled
15
- - Datadog API key (available in your Datadog account settings)
16
-
17
11
  ## Usage
18
12
 
19
13
  ### Basic Setup
20
14
 
21
15
  ```typescript
22
- import { Mastra } from '@mastra/core';
16
+ import { Mastra } from '@mastra/core/mastra';
17
+ import { Observability } from '@mastra/observability';
23
18
  import { DatadogExporter } from '@mastra/datadog';
24
19
 
25
- const datadog = new DatadogExporter({
26
- mlApp: 'my-llm-app',
27
- apiKey: process.env.DD_API_KEY,
28
- });
29
-
30
- const mastra = new Mastra({
31
- observability: {
20
+ export const mastra = new Mastra({
21
+ observability: new Observability({
32
22
  configs: {
33
- default: {
23
+ datadog: {
34
24
  serviceName: 'my-service',
35
- exporters: [datadog],
25
+ exporters: [new DatadogExporter()],
36
26
  },
37
27
  },
38
- },
39
- });
40
- ```
41
-
42
- ### With Local Datadog Agent (Optional)
43
-
44
- If you have a Datadog Agent running locally, you can use agent mode instead:
45
-
46
- ```typescript
47
- const datadog = new DatadogExporter({
48
- mlApp: 'my-llm-app',
49
- agentless: false, // Use local Datadog Agent instead of direct HTTPS
50
- env: 'production',
28
+ }),
51
29
  });
52
30
  ```
53
31
 
54
- ### Configuration Options
55
-
56
- | Option | Description | Default |
57
- | --------------------- | ---------------------------------------------------- | ------------------------------ |
58
- | `apiKey` | Datadog API key (required) | `DD_API_KEY` env var |
59
- | `mlApp` | ML application name for grouping traces (required) | `DD_LLMOBS_ML_APP` env var |
60
- | `site` | Datadog site (e.g., 'datadoghq.com', 'datadoghq.eu') | `DD_SITE` or `'datadoghq.com'` |
61
- | `agentless` | Use direct HTTPS intake (no local agent required) | `true` |
62
- | `service` | Service name for the application | Uses `mlApp` value |
63
- | `env` | Environment name (e.g., 'production', 'staging') | `DD_ENV` env var |
64
- | `integrationsEnabled` | Enable dd-trace automatic integrations | `false` |
65
-
66
- Note that the `site` is also used to specify non-default regions, e.g. `us3.datadoghq.com` instead of `us1.datadoghq.com`.
67
-
68
- ### Environment Variables
69
-
70
- The exporter reads configuration from environment variables:
71
-
72
- - `DD_API_KEY` - Datadog API key (required)
73
- - `DD_LLMOBS_ML_APP` - ML application name
74
- - `DD_SITE` - Datadog site
75
- - `DD_ENV` - Environment name
76
- - `DD_LLMOBS_AGENTLESS_ENABLED` - Set to 'false' or '0' to use local Datadog Agent
32
+ ## Documentation
77
33
 
78
- ## Span Type Mapping
34
+ - [@mastra/datadog documentation](https://mastra.ai/integrations/observability/datadog)
79
35
 
80
- Mastra span types are mapped to Datadog LLMObs span kinds:
36
+ ## Changelog
81
37
 
82
- | Mastra SpanType | Datadog Kind |
83
- | ------------------ | ------------ |
84
- | `AGENT_RUN` | `agent` |
85
- | `MODEL_GENERATION` | `workflow` |
86
- | `MODEL_STEP` | `llm` |
87
- | `TOOL_CALL` | `tool` |
88
- | `MCP_TOOL_CALL` | `tool` |
89
- | `WORKFLOW_RUN` | `workflow` |
90
- | All other types | `task` |
91
-
92
- All unmapped span types (including `MODEL_CHUNK`, `GENERIC`, etc., and future span types) automatically default to `task`.
93
-
94
- ## Features
95
-
96
- - **Completion-only pattern**: Spans are emitted at completion for efficient tracing
97
- - **Message formatting**: LLM inputs/outputs formatted as message arrays
98
- - **Metadata as tags**: Span metadata is flattened into searchable Datadog tags
99
- - **Error tracking**: Error spans include error tags with message, ID, and category
100
- - **Parent/child hierarchy**: Spans are emitted parent-first to preserve trace trees in Datadog
101
-
102
- ## Troubleshooting
103
-
104
- ### Native module ABI errors
105
-
106
- If you see errors like `No native build was found for runtime=node abi=137`:
107
-
108
- 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.
109
-
110
- **Options:**
111
-
112
- 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.
113
- 2. **Ignore the errors** - These are warnings, not fatal errors. LLM observability tracing functions normally without native modules.
114
-
115
- ### Bundler configuration
116
-
117
- When using bundlers, mark `dd-trace` and native modules as external:
118
-
119
- ```typescript
120
- // src/mastra/index.ts
121
- export const mastra = new Mastra({
122
- bundler: {
123
- externals: [
124
- 'dd-trace',
125
- '@datadog/native-metrics',
126
- '@datadog/native-appsec',
127
- '@datadog/native-iast-taint-tracking',
128
- '@datadog/pprof',
129
- ],
130
- },
131
- });
132
- ```
38
+ See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/observability/datadog/CHANGELOG.md) for version history and release notes.
133
39
 
134
- ## License
40
+ ## Support
135
41
 
136
- Apache-2.0
42
+ 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/dist/bridge.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EAKZ,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,OAAO,EACR,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA+DhE;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,mBAAmB;IAC5E,IAAI,SAAoB;IAExB,OAAO,CAAC,MAAM,CAA8E;IAC5F,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,GAAE,mBAAwB;IAgD5C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,SAAS;IA2ErE;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrE;;OAEG;IACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIjD,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCpD,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;cACa,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvE,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAwD7B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMlD,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,gBAAgB;IAiGxB,OAAO,CAAC,YAAY;IASd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BhC"}
1
+ {"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EAKZ,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,OAAO,EACR,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA+DhE;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,mBAAmB;IAC5E,IAAI,SAAoB;IAExB,OAAO,CAAC,MAAM,CAA8E;IAC5F,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,cAAc,CAA6B;IAEnD,YAAY,MAAM,GAAE,mBAAwB,EA8C3C;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,SAAS,CAyEpE;IAED;;OAEG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEpE;IAED;;OAEG;IACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtD;IAEK,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCnD;IAED,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,UAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BtE;IAED,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAwD7B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAIjD;IAED,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,gBAAgB;IAiGxB,OAAO,CAAC,YAAY;IASd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB3B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B9B;CACF"}
package/dist/tracing.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EAKZ,UAAU,EACX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA6DhE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,IAAI,SAAa;IAEjB,OAAO,CAAC,MAAM,CAAkF;IAChG,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,UAAU,CAAiC;gBAEvC,MAAM,GAAE,qBAA0B;IA6C9C;;OAEG;cACa,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCvE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2HxB;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDpD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgD7B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAgFzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA2CrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAmDrB"}
1
+ {"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EAKZ,UAAU,EACX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AA6DhE;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,IAAI,SAAa;IAEjB,OAAO,CAAC,MAAM,CAAkF;IAChG,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,UAAU,CAAiC;IAEnD,YAAY,MAAM,GAAE,qBAA0B,EA2C7C;IAED;;OAEG;IACH,UAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCtE;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2HxB;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CnD;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC9B;IAED;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgD7B;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAgFzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA2CrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAsCxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAmDrB"}
package/package.json CHANGED
@@ -1,13 +1,12 @@
1
1
  {
2
2
  "name": "@mastra/datadog",
3
- "version": "1.4.4",
3
+ "version": "1.4.5-alpha.1",
4
4
  "description": "Datadog LLM Observability exporter for Mastra - exports tracing data to Datadog's LLM Observability product",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",
8
8
  "files": [
9
- "dist",
10
- "CHANGELOG.md"
9
+ "dist"
11
10
  ],
12
11
  "exports": {
13
12
  ".": {
@@ -25,7 +24,7 @@
25
24
  "license": "Apache-2.0",
26
25
  "dependencies": {
27
26
  "dd-trace": "^5.117.0",
28
- "@mastra/observability": "1.17.4"
27
+ "@mastra/observability": "1.17.5-alpha.1"
29
28
  },
30
29
  "devDependencies": {
31
30
  "@types/node": "22.20.1",
@@ -33,11 +32,11 @@
33
32
  "@vitest/ui": "4.1.10",
34
33
  "eslint": "^10.7.0",
35
34
  "tsdown": "0.22.9",
36
- "typescript": "^6.0.3",
35
+ "typescript": "^7.0.2",
37
36
  "vitest": "4.1.10",
38
- "@internal/lint": "0.0.128",
39
- "@internal/types-builder": "0.0.103",
40
- "@mastra/core": "1.63.1"
37
+ "@internal/types-builder": "0.0.104",
38
+ "@mastra/core": "1.64.0-alpha.7",
39
+ "@internal/lint": "0.0.129"
41
40
  },
42
41
  "peerDependencies": {
43
42
  "@mastra/core": ">=1.16.0-0 <2.0.0-0",