> Discover all available pages from the documentation index: https://mastra.zisheng.pro/zh-HK/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',
  },
})
```