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

# Laminar Exporter

[Laminar](https://laminar.sh/) 是一個開放原始碼、原生支援 OpenTelemetry 的 AI Agent Observability 平台。只要在 `Observability` 設定中接上一個 `MastraExporter`，即可追蹤、除錯及監控每次 Mastra Agent 執行、模型步驟、Tool 呼叫與子 Agent。

## 安裝

**npm**:

```bash
npm install @lmnr-ai/lmnr
```

**pnpm**:

```bash
pnpm add @lmnr-ai/lmnr
```

**Yarn**:

```bash
yarn add @lmnr-ai/lmnr
```

**Bun**:

```bash
bun add @lmnr-ai/lmnr
```

## 設定

### 必要條件

1. **Laminar 專案**：在 Laminar 中建立或選取專案
2. **專案 API Key**：從 Laminar Project Settings 複製
3. **環境變數**：設定你的憑證

```bash
# Required
LMNR_PROJECT_API_KEY=lmnr_...

# Optional
LMNR_BASE_URL=https://api.lmnr.ai
```

### 零設定

設定環境變數後，即可使用不帶任何設定的 Exporter：

```typescript
import { Mastra } from '@mastra/core'
import { Observability } from '@mastra/observability'
import { Laminar, MastraExporter } from '@lmnr-ai/lmnr'

Laminar.initialize()

export const mastra = new Mastra({
  observability: new Observability({
    configs: {
      laminar: {
        serviceName: 'my-service',
        exporters: [new MastraExporter()],
      },
    },
  }),
})
```

### 明確設定

你也可以直接傳入憑證（優先於環境變數）：

```typescript
import { Mastra } from '@mastra/core'
import { Observability } from '@mastra/observability'
import { Laminar, MastraExporter } from '@lmnr-ai/lmnr'

Laminar.initialize({
  projectApiKey: process.env.LMNR_PROJECT_API_KEY!,
  baseUrl: process.env.LMNR_BASE_URL, // Optional
  // ...other options
})

export const mastra = new Mastra({
  observability: new Observability({
    configs: {
      laminar: {
        serviceName: 'my-service',
        exporters: [
          new MastraExporter({
            realtime: process.env.NODE_ENV === 'development', // Optional
          }),
        ],
      },
    },
  }),
})
```

> **備註:** 如需完整的 `MastraExporter` 選項與多 Agent Trace 範例等進階用法，請參閱 [Laminar 的 Mastra 整合指南](https://laminar.sh/docs/tracing/integrations/mastra)。

Mastra 也在 `@mastra/laminar` 中提供獨立的 [`LaminarExporter`](https://mastra.zisheng.pro/zh-TW/reference/observability/tracing/exporters/laminar)，可透過 OTLP/HTTP 傳送 span。它無法繼承啟用中的 OTel context，也無法將 Mastra span 完整對應至 Laminar 的原生格式。因此，如需 `observe()` wrapper、多 Agent root span 與準確的 Laminar 呈現結果，請使用上述 `@lmnr-ai/lmnr` 整合。

## 相關內容

- [Tracing 總覽](https://mastra.zisheng.pro/zh-TW/docs/observability/tracing/overview)
- [Laminar 文件](https://laminar.sh/docs)