ArthurExporter

추적 데이터를 다음으로 보냅니다.Arthur EngineOpenTelemetry 및 OpenInference 의미 체계 규칙을 사용합니다.

건설자

new ArthurExporter(config: ArthurExporterConfig)

ArthurExporterConfig

type ArthurExporterConfig = Omit<OtelExporterConfig, 'provider' | 'exporter'> & {
  apiKey?: string
  endpoint?: string
  taskId?: string
  headers?: Record<string, string>
}

OtelExporterConfig에서 상속됩니다(provider와 exporter 제외). 포함되는 항목은 다음과 같습니다.

• timeout?: number- 밀리초 단위로 내보내기 제한 시간(기본값: 30000)
• batchSize?: number- 배치당 스팬 수(기본값: 512)
• logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'- 로그 수준(기본값: WARN)
• resourceAttributes?: Record<string, any>- 사용자 정의 리소스 속성

메타데이터 패스스루

예약되지 않은 span 속성은 OpenInference metadata 페이로드로 직렬화됩니다. tracingOptions.metadata를 통해 추가하세요(예: companyId, tier). input, output, sessionId, 스레드/사용자 ID, OpenInference ID와 같은 예약 필드는 자동으로 제외됩니다.

행동 양식

exportTracingEvent

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

추적 이벤트를 구성된 엔드포인트로 내보냅니다.

내보내다

async export(spans: ReadOnlySpan[]): Promise<void>

일괄 내보내기는 OpenInference 의미 체계 규칙과 함께 OpenTelemetry를 사용하여 범위를 내보냅니다.

플러시

async flush(): Promise<void>

강제는 내보내기를 종료하지 않고 버퍼링된 모든 범위를 구성된 엔드포인트로 플러시합니다. 런타임이 종료되기 전에 범위를 내보내야 하는 서버리스 환경에 유용합니다.

일시 휴업

async shutdown(): Promise<void>

보류 중인 데이터를 플러시하고 클라이언트를 종료합니다.

용법

Zero-Config(환경 변수 사용)

import { ArthurExporter } from '@mastra/arthur'

// Set ARTHUR_API_KEY and ARTHUR_BASE_URL (optionally ARTHUR_TASK_ID)
const exporter = new ArthurExporter()

명시적 구성

import { ArthurExporter } from '@mastra/arthur'

const exporter = new ArthurExporter({
  apiKey: process.env.ARTHUR_API_KEY!,
  endpoint: 'http://localhost:3030',
  taskId: process.env.ARTHUR_TASK_ID, // Optional
})

OpenInference의미론적 규칙

ArthurExporter는 생성형 AI 애플리케이션을 위한 OpenInference 시맨틱 규칙을 구현하여 서로 다른 Observability 플랫폼에서 표준화된 Trace 구조를 제공합니다.

태그 지원

ArthurExporter는 분류 및 필터링을 위한 추적 태그 지정을 지원합니다. 태그는 루트 범위에만 적용되며 기본 OpenInference에 매핑됩니다.tag.tags semantic convention.

용법

const result = await agent.generate('Hello', {
  tracingOptions: {
    tags: ['production', 'experiment-v2', 'user-request'],
  },
})

태그가 저장되는 방법

태그는 OpenInference를 사용하여 저장됩니다.tag.tags attribute:

{
  "tag.tags": ["production", "experiment-v2", "user-request"]
}

관련된

• ArthurExporter 문서
• Arthur 엔진 문서
• Arthur 엔진 저장소