DatadogExporter

監視と分析のために、Tracing データを Datadog の LLM Observability 製品へ送信します。

情報

dd-trace APM 自動インストルメンテーションも使用し、Mastra Span の配下に正しく関連付ける必要がある場合は、代わりに DatadogBridge を使用してください。exporter は実行完了後に LLM Observability データを送信するため、dd-trace のライブスコープには関与しません。

コンストラクター

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' - ログレベル（デフォルト：INFO）

メソッド

exportTracingEvent

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

Tracing イベントを Datadog LLM Observability へエクスポートします。

flush

async flush(): Promise<void>

exporter をシャットダウンせず、バッファー内のすべての Span を Datadog へ強制的にフラッシュします。ランタイム終了前に Span が確実にエクスポートされるようにする必要がある、サーバーレス環境で役立ちます。

shutdown

async shutdown(): Promise<void>

保留中のデータをフラッシュし、exporter をシャットダウンします。保留中のクリーンアップタイマーをすべてキャンセルし、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 Kind
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 キー
DD_LLMOBS_ML_APP	ML アプリケーション名
DD_SITE	Datadog サイト
DD_ENV	環境名
DD_LLMOBS_AGENTLESS_ENABLED	ローカル Agent を使用するには 'false' または '0' に設定