DatadogExporter

將 Tracing 資料傳送至 Datadog 的 LLM Observability 產品，以進行監控與分析。

資訊

如果您也使用 dd-trace APM 自動檢測，並需要正確將其設為 Mastra span 的子項，請改用 DatadogBridge。Exporter 會在執行完成後傳送 LLM Observability 資料，因此不會參與 dd-trace 的即時 scope。

建構函式

new DatadogExporter(config: DatadogExporterConfig)

DatadogExporterConfig

interface DatadogExporterConfig extends BaseExporterConfig {
  apiKey?: string
  mlApp?: string
  site?: string
  service?: string
  env?: string
  agentless?: boolean
  integrationsEnabled?: boolean
}

擴充 BaseExporterConfig，其中包括：

• logger?: IMastraLogger - Logger 執行個體
• logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error' - Log 層級（預設：INFO）

方法

exportTracingEvent

async exportTracingEvent(event: TracingEvent): Promise<void>

將 tracing 事件匯出至 Datadog LLM Observability。

flush

async flush(): Promise<void>

強制將所有緩衝的 span flush 至 Datadog，而不關閉 exporter。這在 serverless 環境中特別實用，可確保 runtime 結束前已匯出 span。

shutdown

async shutdown(): Promise<void>

Flush 待處理資料並關閉 exporter。取消所有待處理的清理 timer，並停用 LLM Observability。

使用方式

零設定（使用環境變數）

import { DatadogExporter } from '@mastra/datadog'

// Reads from DD_LLMOBS_ML_APP, DD_API_KEY, DD_SITE, DD_ENV
const exporter = new DatadogExporter()

明確設定

import { DatadogExporter } from '@mastra/datadog'

const exporter = new DatadogExporter({
  mlApp: 'my-llm-app',
  apiKey: process.env.DD_API_KEY,
  site: 'datadoghq.com',
  env: 'production',
})

搭配本機 Datadog Agent

const exporter = new DatadogExporter({
  mlApp: 'my-llm-app',
  agentless: false, // Use local Datadog Agent
  env: 'production',
})

Span 對應

Mastra span 類型會對應至 Datadog LLM Observability span kind：

Mastra SpanType	Datadog 種類
AGENT_RUN	agent
MODEL_GENERATION	workflow
MODEL_STEP	llm
TOOL_CALL	tool
MCP_TOOL_CALL	tool
PROVIDER_TOOL_CALL	tool
WORKFLOW_RUN	workflow
所有其他類型	task

所有未對應的 span 類型（包括 MODEL_CHUNK、WORKFLOW_STEP、GENERIC 與未來的 span 類型）都會自動預設為 task。

環境變數

Exporter 會從下列環境變數讀取設定：

變數	說明
DD_API_KEY	Datadog API key
DD_LLMOBS_ML_APP	ML 應用程式名稱
DD_SITE	Datadog site
DD_ENV	環境名稱
DD_LLMOBS_AGENTLESS_ENABLED	設為 'false' 或 '0' 以使用本機 Agent