> ## Documentation Index
> Fetch the complete documentation index at: https://daehan-base.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 텔레메트리 · Base Account

> Base Account의 익명 텔레메트리 시스템 및 설정 방법을 이해합니다.

Base Account에는 Base Account가 애플리케이션 전반에서 어떻게 사용되는지 더 잘 이해하고 개발자 경험을 개선하기 위한 익명 텔레메트리 시스템이 포함되어 있습니다. 이 익명 프로그램 참여는 선택 사항입니다. 사용 데이터를 공유하고 싶지 않다면 쉽게 옵트아웃할 수 있습니다.

### 텔레메트리를 수집하는 이유는 무엇인가요?

Base Account는 트랜잭션 및 메시지 서명, 서명자 관리 등의 기능을 갖춘 온체인 애플리케이션을 위한 중요한 지갑 인프라를 제공합니다. 텔레메트리 데이터를 수집함으로써 다음이 가능합니다:

* **지갑 작동 성공 모니터링**: 가장 신뢰할 수 있는 지갑 작동(서명, 연결, 트랜잭션)을 추적하고 실패 패턴 파악
* **데이터 기반 개선**: 엔지니어링 팀이 미래의 지갑 향상 및 신뢰성 개선을 이끄는 인사이트 생성
* **사전 이슈 감지**: 운영 메트릭 및 오류 모니터링을 통해 새로운 SDK 릴리스나 지갑 작동의 문제를 신속하게 감지

### 어떤 데이터가 수집되나요?

텔레메트리 데이터는 완전히 익명이며 기능 메트릭에 초점을 맞춥니다. 구체적으로 수집되는 데이터는 다음과 같습니다:

* **요청 성공 메트릭**: 신뢰성 문제를 파악하기 위한 지갑 요청의 성공 및 실패율 정보
* **오류 이벤트**: Base Account 신뢰성 개선을 위한 운영 컨텍스트가 포함된 일반 오류 이벤트
* **UI 컴포넌트 사용량**: 최적의 신뢰성을 보장하기 위한 인터페이스 컴포넌트 기능에 관한 익명 메트릭

**프라이버시 우선**: 개인 키, 트랜잭션 내용, 사용자 주소 또는 개인 정보와 같은 민감한 데이터는 절대 수집되지 않습니다.

### 어떻게 작동하나요?

텔레메트리는 Base Account SDK에 통합되어 있으며 특정 지갑 이벤트가 발생할 때 자동으로 트리거됩니다(구성에서 텔레메트리가 활성화된 경우). 데이터는 분석을 위해 안전한 Coinbase 엔드포인트로 전송됩니다.

예를 들어, 지갑 요청이 발생하면 다음과 같은 텔레메트리 이벤트가 전송됩니다:

```bash theme={null}
curl 'https://cca-lite.coinbase.com/amp' \
  -H 'content-type: application/x-www-form-urlencoded; charset=utf-8' \
  -H 'origin: https://your-app.com' \
  --data-raw 'e=[{"event_type":"scw_signer.request.started","event_properties":{"method":"eth_requestAccounts","correlationId":"abc123-def456","sdkVersion":"4.3.2","appName":"Your App Name","appOrigin":"https://your-app.com"}}]'
```

페이로드에는 운영 데이터가 포함된 텔레메트리 이벤트 배열이 들어 있습니다:

* **event\_type**: 추적 중인 특정 지갑 작동
* **method**: 호출되는 지갑 메서드 (예: `eth_requestAccounts`)
* **correlationId**: 요청 추적을 위한 고유 식별자
* **sdkVersion**: Base Account SDK 버전
* **appName**: 애플리케이션 이름
* **appOrigin**: 애플리케이션의 도메인

### 옵트아웃하려면 어떻게 하나요?

기본적으로 텔레메트리 수집은 옵트아웃 모델을 따릅니다. Base Account SDK를 사용하는 앱에서 텔레메트리를 비활성화하려면 SDK 초기화 중에 설정할 수 있습니다:

```typescript theme={null}
import { createBaseAccountSDK } from "@base-org/account";

const sdk = createBaseAccountSDK({
  appName: "My App",
  appLogoUrl: "https://example.com/logo.png",
  preference: {
    telemetry: false, // [!code focus]
  },
});

const provider = sdk.getProvider();
```

레거시 Coinbase Wallet SDK 클래스 기반 컴포넌트의 경우:

```tsx theme={null}
import { CoinbaseWalletSDK } from "@coinbase/wallet-sdk";

const sdk = new CoinbaseWalletSDK({
  appName: "My App",
  appLogoUrl: "https://example.com/logo.png",
});

const provider = sdk.getProvider({
  telemetry: false, // [!code focus]
});
```

이 텔레메트리 이니셔티브가 가장 중요한 지갑 작동에 개선을 집중하고 문제를 조기에 발견하여 모든 개발자를 위한 Base Account를 더욱 발전시키는 데 도움이 될 것으로 기대합니다. 질문이나 피드백이 있으시면 Base Account 팀에 연락해 주세요.

Base Account와 함께 즐거운 개발 되세요!

— Base Account 팀