> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 에어브릿지 디버그 로그 확인 가이드

## 개요

Airbridge SDK 연동 후 예상하지 못한 동작이나 오류가 발생할 때, 정확한 문제 진단을 위해서는 디버그 로그가 필수적입니다. 이 가이드는 각 플랫폼에서 Airbridge 디버그 로그를 확인하고 저장하는 방법을 설명합니다.

## 준비

디버그 로그를 확인하기 위해서는 먼저 Airbridge SDK 초기화 시 logLevel을 설정해야 합니다. logLevel 설정 방법은 플랫폼마다 다르므로, 아래의 플랫폼별 가이드를 참고하여 DEBUG 레벨로 설정한 후 진행해주세요.

## Android 로그 확인하기

### Android Studio 사용하기 로그 확인하기

1. **logLevel 설정 확인**: SDK 초기화 시 logLevel이 DEBUG로 설정되어 있는지 확인합니다.
2. **앱 빌드 및 실행**: Android Studio에서 앱을 빌드하여 테스트 기기에 설치합니다.
3. **Logcat 필터 설정**:
   1. Android Studio 하단의 **Logcat** 탭을 엽니다.
   2. 우측 상단 필터 입력란에 고객앱의 `패키지명`을 입력하고, `Airbridge`를 입력하여 Airbridge 로그만 표시되도록 설정합니다.
4. **이슈 재현**: 문제가 발생하는 상황을 재현합니다.
5. **로그 저장**:
   1. 약 30초 동안 앱을 활성화 상태로 유지합니다.
   2. Logcat의 모든 로그를 선택 후 복사합니다.
   3. 텍스트 에디터(메모장, VS Code 등)에 붙여넣어 파일로 저장합니다.

### adb 사용하여 로그 확인하기

터미널에서 adb 명령어를 사용하여 로그를 직접 수집할 수 있습니다. `Platform Tools`가 설치되어 있어야 합니다.

1. **Logcat 버퍼 초기화**:

```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
adb logcat -c
```

2. **이슈 재현**: 문제가 발생하는 상황을 재현합니다.
3. **파일에 기록**:

```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
adb logcat "Airbridge:V" "*:S" > airbridge_logs.txt
```

* 이슈 재현 후 30초 정도 기다린 후 로그 저장을 중단합니다.

4. **저장된 파일 확인**: 현재 디렉토리에 `airbridge_logs.txt` 파일이 생성됩니다.

## iOS 로그 확인하기

### Xcode 로 로컬 빌드가 가능한 경우 로그 확인하기

1. **logLevel 설정 확인**: SDK 초기화 시 logLevel이 DEBUG로 설정되어 있는지 확인합니다.
2. **디바이스 연결**: iOS 기기를 Mac에 연결합니다.
3. **앱 빌드 및 실행**: Xcode에서 앱을 빌드하여 연결된 기기에 설치 및 실행합니다.
4. **콘솔 필터 설정**:
   1. Xcode 하단의 **Console** 탭을 엽니다.
   2. 우측 하단의 필터 입력란에 `Airbridge`를 입력하여 Airbridge 로그만 표시되도록 설정합니다.
5. **이슈 재현**: 문제가 발생하는 상황을 재현합니다.
6. **로그 저장**:
   1. 약 30초 동안 앱을 활성화 상태로 유지합니다.
   2. Console의 모든 로그를 선택 후 복사합니다.
   3. 텍스트 에디터에 붙여넣어 파일로 저장합니다.

### console 앱을 사용하여 로그 확인하기

iOS 기기에서 직접 Xcode로 빌드할 수 없는 경우, Mac의 Console 앱을 사용하여 로그를 수집할 수 있습니다.

1. **디바이스 연결**: iOS 기기를 Mac에 연결합니다.
2. **Console 앱 열기**: Spotlight 검색(Cmd+Space)에서 "Console"을 검색하여 앱을 실행합니다.
3. **로그 스트림 시작**:
   1. Console 앱 상단의 검색란 옆 장치 선택 메뉴에서 연결된 iOS 기기를 선택합니다.
   2. 상단의 검색/필터 입력란에 앱의 `번들 ID`를 입력하여 필터링합니다.
4. **로그 초기화**: 이전 로그를 제거하기 위해 Console 창을 우클릭하여 "Clear Console"을 선택합니다.
5. **이슈 재현**: 문제가 발생하는 상황을 재현합니다.
6. **로그 저장**:
   1. 약 30초 동안 앱을 활성화 상태로 유지합니다.
   2. 표시된 모든 로그를 선택 후 복사합니다.
   3. 텍스트 에디터에 붙여넣어 파일로 저장합니다.

## 주의사항

### 로그 전달 시

* **수집범위**: 이슈 재현부터 30초 이상의 로그를 전달하여 초기화, 추적, 처리 과정 전체를 포함하도록 합니다.
* **필터링**: Airbridge 관련 로그만 포함하도록 필터링하는 것이 좋습니다.
* **파일 형식**: 되도록 텍스트 파일(.txt) 형식으로 저장하여 전달합니다.
* **환경 정보**: 다음 정보도 함께 제공하면 문제 분석이 빨라집니다.
  * SDK 버전
  * 앱 설치 방식 (일반 설치, 테스트 배포 등)
  * 기기 정보 (OS 버전, 모델명 등)
  * 발생 시점 (특정 이벤트 시, 앱 시작 시 등)
  * 재현 경로

### 배포 시

* DEBUG 로그는 민감한 내부 동작을 노출할 수 있습니다. 릴리즈 빌드에서는 반드시 제거하거나 WARNING 이상으로 복원해야 합니다.

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/developers/airbridge-debug-log-guide" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/developers/airbridge-debug-log-guide" />