Skip to main content
Mastra v1 is coming in January 2026. Get ahead by starting new projects with the beta or upgrade your existing project today.

Telemetry API

The Telemetry API provides methods to retrieve and analyze traces from your Mastra application. This helps you monitor and debug your application's behavior and performance.

Getting TracesDirect link to Getting Traces

Retrieve traces with optional filtering and pagination:

const telemetry = await mastraClient.getTelemetry({
name: "trace-name", // Optional: Filter by trace name
scope: "scope-name", // Optional: Filter by scope
page: 1, // Optional: Page number for pagination
perPage: 10, // Optional: Number of items per page
attribute: {
// Optional: Filter by custom attributes
key: "value",
},
});

On this page