Arize수출업체

추적 데이터를 Arize Phoenix, Arize AX 또는 OpenInference 의미론적 규칙을 지원하는 OpenTelemetry 호환 관찰 플랫폼으로 보냅니다.

건설자

new ArizeExporter(config: ArizeExporterConfig)

ArizeExporterConfig

type ArizeExporterConfig = Omit<OtelExporterConfig, 'provider'> & {
  // Phoenix / OpenTelemetry configuration
  endpoint?: string
  apiKey?: string

  // Arize AX configuration
  spaceId?: string

  // Common configuration
  projectName?: string
  headers?: Record<string, string>
}

다음에서 상속됨OtelExporterConfig (excluding provider)에는 다음이 포함됩니다.

• 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 { ArizeExporter } from '@mastra/arize'

// For Phoenix: Set PHOENIX_COLLECTOR_ENDPOINT, PHOENIX_API_KEY, PHOENIX_PROJECT_NAME
// For Arize AX: Set ARIZE_SPACE_ID, ARIZE_API_KEY, ARIZE_PROJECT_NAME
const exporter = new ArizeExporter()

피닉스 구성

import { ArizeExporter } from '@mastra/arize'

const exporter = new ArizeExporter({
  endpoint: 'http://localhost:6006/v1/traces',
  apiKey: process.env.PHOENIX_API_KEY, // Optional for local Phoenix
  projectName: 'my-ai-project',
})

Arize AX 구성

import { ArizeExporter } from '@mastra/arize'

const exporter = new ArizeExporter({
  spaceId: process.env.ARIZE_SPACE_ID!,
  apiKey: process.env.ARIZE_API_KEY!,
  projectName: 'my-ai-project',
})

OpenInference의미론적 규칙

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

태그 지원

ArizeExporter는 분류 및 필터링을 위한 추적 태그 지정을 지원합니다. 태그는 루트 범위에만 적용되며 기본 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"]
}

관련된

• ArizeExporter 문서
• 피닉스 문서
• Arize AX 문서