> Discover all available pages from the documentation index: https://mastra.zisheng.pro/llms.txt

# Telemetry API

Telemetry API 提供用于检索和分析 Mastra 应用中 Trace 的方法。这有助于监控和调试应用的行为与性能。

## 获取 Trace

检索 Trace，并可选择进行筛选和分页：

```typescript
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',
  },
})
```