@mastra/observability 1.4.0 → 1.5.0
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.
- package/CHANGELOG.md +28 -0
- package/README.md +9 -9
- package/dist/bus/observability-bus.d.ts +19 -10
- package/dist/bus/observability-bus.d.ts.map +1 -1
- package/dist/config.d.ts +8 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/context/metrics.d.ts +15 -24
- package/dist/context/metrics.d.ts.map +1 -1
- package/dist/default.d.ts +16 -3
- package/dist/default.d.ts.map +1 -1
- package/dist/exporters/default.d.ts +39 -49
- package/dist/exporters/default.d.ts.map +1 -1
- package/dist/exporters/event-buffer.d.ts +63 -0
- package/dist/exporters/event-buffer.d.ts.map +1 -0
- package/dist/exporters/test.d.ts +5 -7
- package/dist/exporters/test.d.ts.map +1 -1
- package/dist/index.cjs +529 -655
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +529 -655
- package/dist/index.js.map +1 -1
- package/dist/instances/base.d.ts +2 -1
- package/dist/instances/base.d.ts.map +1 -1
- package/dist/metrics/auto-extract.d.ts +15 -31
- package/dist/metrics/auto-extract.d.ts.map +1 -1
- package/package.json +7 -7
package/dist/instances/base.d.ts
CHANGED
|
@@ -152,6 +152,7 @@ export declare abstract class BaseObservabilityInstance extends MastraBase imple
|
|
|
152
152
|
* Process a span through all output processors
|
|
153
153
|
*/
|
|
154
154
|
private processSpan;
|
|
155
|
+
/** Process a span through output processors and export it, returning undefined if filtered out. */
|
|
155
156
|
getSpanForExport(span: AnySpan): AnyExportedSpan | undefined;
|
|
156
157
|
/**
|
|
157
158
|
* Emit a span started event.
|
|
@@ -176,7 +177,7 @@ export declare abstract class BaseObservabilityInstance extends MastraBase imple
|
|
|
176
177
|
*
|
|
177
178
|
* The bus routes the event to each registered exporter's and bridge's
|
|
178
179
|
* onTracingEvent handler and triggers auto-extracted metrics (e.g.,
|
|
179
|
-
*
|
|
180
|
+
* mastra_agent_duration_ms, mastra_model_duration_ms).
|
|
180
181
|
*/
|
|
181
182
|
private emitTracingEvent;
|
|
182
183
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/instances/base.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EACV,IAAI,EACJ,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,OAAO,EAGP,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACT,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAI7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D;;GAEG;AACH,8BAAsB,yBAA0B,SAAQ,UAAW,YAAW,qBAAqB;IACjG,SAAS,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE9C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAE7C;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;gBAEnC,MAAM,EAAE,2BAA2B;IAuC/C;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa;IAyBjC,SAAS,KAAK,SAAS,IAAI,qBAAqB,EAAE,CAEjD;IAED,SAAS,KAAK,oBAAoB,IAAI,mBAAmB,EAAE,CAE1D;IAMD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,SAAS,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAqEhF;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,KAAK,SAAS,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IA2B7E;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,QAAQ,EAAE,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAMrG;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,2BAA2B,CAAC;IAQlD;;OAEG;IACH,YAAY,IAAI,SAAS,qBAAqB,EAAE;IAIhD;;OAEG;IACH,uBAAuB,IAAI,SAAS,mBAAmB,EAAE;IAIzD;;OAEG;IACH,SAAS,IAAI,mBAAmB,GAAG,SAAS;IAI5C;;OAEG;IACH,SAAS;IAIT;;;;OAIG;IACH,mBAAmB,IAAI,gBAAgB;IAQvC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa;IAuB/C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc;
|
|
1
|
+
{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/instances/base.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,47 +1,31 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* AutoExtractedMetrics - Converts
|
|
3
|
-
* into MetricEvents automatically.
|
|
2
|
+
* AutoExtractedMetrics - Converts TracingEvents into MetricEvents automatically.
|
|
4
3
|
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* generation stats (including token usage).
|
|
4
|
+
* When a tracing span ends, this class emits metric events for duration
|
|
5
|
+
* and token usage (for model spans).
|
|
8
6
|
*/
|
|
9
|
-
import type { TracingEvent
|
|
7
|
+
import type { TracingEvent } from '@mastra/core/observability';
|
|
10
8
|
import type { ObservabilityBus } from '../bus/index.js';
|
|
11
|
-
|
|
9
|
+
/**
|
|
10
|
+
* Converts tracing span lifecycle events into metric events automatically.
|
|
11
|
+
* Emits duration metrics for agent, tool, workflow, and model spans, plus
|
|
12
|
+
* token usage metrics for model generation spans.
|
|
13
|
+
*/
|
|
12
14
|
export declare class AutoExtractedMetrics {
|
|
13
15
|
private observabilityBus;
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* @param observabilityBus - Bus used to emit derived MetricEvents.
|
|
17
|
-
* @param cardinalityFilter - Optional filter applied to metric labels before emission.
|
|
18
|
-
*/
|
|
19
|
-
constructor(observabilityBus: ObservabilityBus, cardinalityFilter?: CardinalityFilter | undefined);
|
|
16
|
+
constructor(observabilityBus: ObservabilityBus);
|
|
20
17
|
/**
|
|
21
|
-
* Route a tracing event to the appropriate
|
|
22
|
-
*
|
|
23
|
-
* duration histogram, and (for model spans) token counters.
|
|
18
|
+
* Route a tracing event to the appropriate handler.
|
|
19
|
+
* SPAN_ENDED emits duration and token metrics (for model spans).
|
|
24
20
|
*/
|
|
25
21
|
processTracingEvent(event: TracingEvent): void;
|
|
26
|
-
/** Emit
|
|
27
|
-
processScoreEvent(event: ScoreEvent): void;
|
|
28
|
-
/** Emit a `mastra_feedback_total` counter for a feedback event. */
|
|
29
|
-
processFeedbackEvent(event: FeedbackEvent): void;
|
|
30
|
-
/** Emit a started counter (e.g. `mastra_agent_runs_started`) for the span type. */
|
|
31
|
-
private onSpanStarted;
|
|
32
|
-
/** Emit ended counter, duration histogram, and token counters (for model spans). */
|
|
22
|
+
/** Emit duration and token metrics when a span ends. */
|
|
33
23
|
private onSpanEnded;
|
|
34
24
|
/** Build base metric labels from a span's entity and model attributes. */
|
|
35
25
|
private extractLabels;
|
|
36
|
-
/** Emit token usage
|
|
26
|
+
/** Emit token usage metrics from UsageStats. */
|
|
37
27
|
private extractTokenMetrics;
|
|
38
|
-
/** Map a span type to its `*
|
|
39
|
-
private getStartedMetricName;
|
|
40
|
-
/** Map a span type to its `*_ended` counter metric name, or `null` for unsupported types. */
|
|
41
|
-
private getEndedMetricName;
|
|
42
|
-
/** Map a span type to its `*_duration_ms` histogram metric name, or `null` for unsupported types. */
|
|
28
|
+
/** Map a span type to its `*_duration_ms` metric name, or `null` for unsupported types. */
|
|
43
29
|
private getDurationMetricName;
|
|
44
|
-
/** Build an ExportedMetric, apply cardinality filtering, and emit it through the bus. */
|
|
45
|
-
private emit;
|
|
46
30
|
}
|
|
47
31
|
//# sourceMappingURL=auto-extract.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auto-extract.d.ts","sourceRoot":"","sources":["../../src/metrics/auto-extract.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"auto-extract.d.ts","sourceRoot":"","sources":["../../src/metrics/auto-extract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA0D,MAAM,4BAA4B,CAAC;AAEvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAEtD;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAM9C,wDAAwD;IACxD,OAAO,CAAC,WAAW;IAqBnB,0EAA0E;IAC1E,OAAO,CAAC,aAAa;IAiBrB,gDAAgD;IAChD,OAAO,CAAC,mBAAmB;IA4B3B,2FAA2F;IAC3F,OAAO,CAAC,qBAAqB;CAc9B"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/observability",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.5.0",
|
|
4
4
|
"description": "Core observability package for Mastra - includes tracing and scoring features",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -32,14 +32,14 @@
|
|
|
32
32
|
"typescript": "^5.9.3",
|
|
33
33
|
"vitest": "4.0.18",
|
|
34
34
|
"zod": "^4.3.6",
|
|
35
|
-
"@internal/
|
|
36
|
-
"@internal/
|
|
37
|
-
"@internal/ai-sdk-v4": "0.0.
|
|
38
|
-
"@internal/
|
|
39
|
-
"@mastra/core": "1.
|
|
35
|
+
"@internal/lint": "0.0.69",
|
|
36
|
+
"@internal/types-builder": "0.0.44",
|
|
37
|
+
"@internal/ai-sdk-v4": "0.0.16",
|
|
38
|
+
"@internal/ai-sdk-v5": "0.0.16",
|
|
39
|
+
"@mastra/core": "1.13.0"
|
|
40
40
|
},
|
|
41
41
|
"peerDependencies": {
|
|
42
|
-
"@mastra/core": ">=1.
|
|
42
|
+
"@mastra/core": ">=1.13.0-0 <2.0.0-0"
|
|
43
43
|
},
|
|
44
44
|
"homepage": "https://mastra.ai",
|
|
45
45
|
"repository": {
|