可觀測性

Mastra 會透過 src/mastra/ 直屬的 observability.ts 檔案設定可觀測性。該檔案會預設匯出一個 Observability 實例，為項目設定追蹤、日誌、指標及意見回饋。

本頁說明檔案式慣例。如需了解訊號模型、匯出器、儲存空間及多重設定，請參閱可觀測性概覽及可觀測性設定。

快速開始

建立 src/mastra/observability.ts，並預設匯出一個 Observability 實例：

src/mastra/observability.ts

import { MastraStorageExporter, Observability } from '@mastra/observability'

export default new Observability({
  configs: {
    default: {
      serviceName: 'mastra',
      exporters: [new MastraStorageExporter()],
    },
  },
})

可觀測性與儲存空間

observability.ts 會設定收集哪些訊號，以及將其匯出至何處。storage.ts 則設定可持久保存可觀測性記錄的項目儲存空間。如需了解各類訊號的儲存支援，請參閱可觀測性訊號支援。

與程式碼設定的優先次序

以程式碼註冊的可觀測性設定優先於 observability.ts。如果整個項目使用一項設定已足夠，請使用 observability.ts；如果設定取決於 src/mastra/index.ts 中的執行階段連接方式，請使用程式碼註冊。