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

# Arize수출업체

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

## 건설자

```typescript
new ArizeExporter(config: ArizeExporterConfig)
```

## `ArizeExporterConfig`

```typescript
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`

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

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

### 내보내다

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

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

### 플러시

```typescript
async flush(): Promise<void>
```

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

### 일시 휴업

```typescript
async shutdown(): Promise<void>
```

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

## 용법

### Zero-Config(환경 변수 사용)

```typescript
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()
```

### 피닉스 구성

```typescript
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 구성

```typescript
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 시맨틱 규칙](https://github.com/Arize-ai/openinference/tree/main/spec)을 구현하여 서로 다른 Observability 플랫폼에서 표준화된 Trace 구조를 제공합니다.

## 태그 지원

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

### 용법

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

### 태그가 저장되는 방법

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

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

## 관련된

- [ArizeExporter 문서](https://mastra.zisheng.pro/ko/docs/observability/integrations/exporters/arize)
- [피닉스 문서](https://docs.arize.com/phoenix)
- [Arize AX 문서](https://docs.arize.com/)