로그
이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.
응용 프로그램 로그 이해
응용 프로그램 로그 이해로그 페이지는 업데이트 이벤트의 세부적인 기록과 디버그 정보를 제공하여 업데이트 프로세스를 모니터링하고 문제를 해결하고 Capgo과 장치가 상호 작용하는 방법을 이해하는 데 중요합니다. 앱을 클릭하고 그리고 로그 탭을 클릭합니다 (이전에는 일부 오래된 스크린샷 또는 문서에서 "업데이트"라고 명명되었습니다).
그곳에서 로그 항목 목록과 유사한 페이지를 볼 수 있습니다:
로그 페이지 인터페이스는 다음과 같습니다.
- 로그 탭 - 로그 뷰에 접근하기 위한 네비게이션 탭
- 재로드 버튼 - 로그 목록을 최신 데이터로 갱신
- 시간 범위 및 액션 필터 - 날짜 범위와 액션 유형(아래 섹션 참조)으로 로그 필터링
각 행은 다음과 같습니다.
- 타임스탬프 (UTC)
- 기기 ID
- 액션 code (무엇이 일어났나)
- 버전 이름 (압축 파일 또는
builtin)
기기 상세 페이지의 전체 기록으로 이동하기 위해 행을 클릭하세요.
날짜 범위로 필터링하기
날짜 범위로 필터링하기라는 제목날짜 범위로 로그를 필터링할 수 있습니다. 날짜 선택기 사용:
- 빠른 설정 - 1시간, 3시간, 6시간, 12시간 등 일반적인 시간 범위를 선택하세요.
- 시작 시간 - 사용자 지정 시작 시간을 설정하세요.
- 종료 시간 - 사용자 지정 종료 시간을 설정하세요.
- 달력 - 달력 보기에서 특정 날짜를 선택하세요.
선택
선택한 날짜 범위를 적용하거나 선택기를 취소하려면 "Cancel"을 클릭하세요.
작업 유형으로 필터링작업 유형으로 필터링하는 방법
사용 가능한 액션 필터는 다음과 같습니다.
- Device heartbeat - 기기에서 주기적인 건강 검사
- Version deletion requested - 버전 삭제 요청
- Reset to default version - 기기에서 기본 버전으로 되돌아감
- Version installed successfully - 버전 설치 성공
- New version sent to device - Capgo에서 기기로 업데이트를 보냄
- 버전 설치 실패 - 번들 설치 실패 시
위쪽 검색 박스에서 특정 액션 유형을 빠르게 찾을 수 있습니다. 여러 액션을 선택하여 선택한 유형 중 하나와 일치하는 로그를 표시할 수 있습니다.
샘플 로그.snippet (가짜 데이터)
샘플 로그.snippet (가짜 데이터) 섹션| UTC 시간 | 기기 ID | 액션 | 버전 | 이것이 무엇을 말하는지 |
|---|---|---|---|---|
| 2025-01-14 10:00:01 | A1B2C3 | get | 2.4.1 | 기기에서 Capgo 업데이트가 있는지 확인했습니다. |
| 2025-01-14 10:00:03 | A1B2C3 | download_manifest_start | 2.4.1 | 매니페스트 가져오기가 시작되었습니다; SDK이 파일을 다운로드하기 시작했습니다. |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | 다운로드 중 40% |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | Zip 다운로드 완료 |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | Bundle 설치 완료 및 다음으로 실행할 준비가되었습니다. |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | Channel 정책으로 인해 2.x로의 점프가 차단되었습니다. |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | 내장 | SDK이 재시작할 때까지 요청 제한을 초과한 기기입니다. |
예제 로그 시나리오
예제 로그 시나리오로그가 무엇을 말하는지 이해하기 위해, 실제 기기 업데이트의 여정에 대한 예시 시퀀스를 보여드리겠습니다.
업데이트 성공 흐름
로그에서 건강한 업데이트를 확인하는 방법입니다.]}
| 시간 | 기기 ID | 액션 | 버전 | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 10:00:01 | a1b2c3d4 | get | 1.2.0 | 기기가 업데이트를 확인하고 버전 1.2.0 정보를 받았습니다. |
| 10:00:02 | a1b2c3d4 | download_10 | 1.2.0 | 다운로드가 시작되었습니다. 10% 완료 |
| 10:00:03 | a1b2c3d4 | download_50 | 1.2.0 | 다운로드가 50% 완료되었습니다. |
| 10:00:05 | a1b2c3d4 | download_complete | 1.2.0 | 다운로드가 성공적으로 완료되었습니다. |
| 10:00:06 | a1b2c3d4 | set | 1.2.0 | 번들 설치 및 활성화 |
기기가 이미 최신 상태입니다.
기기 상태가 최신 상태라는 제목 ‘기기 상태가 최신 상태입니다.’__CAPGO_KEEP_0__:
| __CAPGO_KEEP_1__: | __CAPGO_KEEP_2__: | __CAPGO_KEEP_3__: | __CAPGO_KEEP_4__: | 업데이트가 이미 최신 버전입니다. |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | 시간 |
기기 ID
액션버전
| 이것은 무엇을 의미합니까? | 기기가 이미 최신 버전이므로 업데이트가 필요하지 않습니다. | 액션 | 버전 | 무슨 뜻인가요 |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | 기기 업데이트 정보를 받았습니다 |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | 다운로드가 완료되었습니다 |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | Bundle이 설정되었습니다 |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | 앱이 충돌하거나 notifyAppReady() 호출되지 않았습니다 - 롤백이 트리거되었습니다 |
| 11:15:11 | i9j0k1l2 | reset | 내장 | 기기에서 내장 버전으로 돌아갔습니다 |
액션 필요합니다: 앱이 호출하는지 확인하세요 notifyAppReady() 초기화가 성공적으로 완료되었습니다. 자세한 내용은 플러그인 문서를 참조하십시오. 다운로드 실패
다운로드 실패 섹션
네트워크 문제로 다운로드가 실패할 때:시간
| 기기 ID | 액션 | 버전 | 이것이 무엇을 의미하는지 | 기기가 업데이트 정보를 받았습니다. |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.0 | __CAPGO_KEEP_0__ |
| 09:45:01 | m3n4o5p6 | download_30 | 1.2.0 | 다운로드가 시작되었습니다만… |
| 09:45:15 | m3n4o5p6 | download_fail | 1.2.0 | 다운로드 실패 (네트워크 타임아웃, 연결이 끊어졌습니다 등) |
액션 필요: 앱을 다시 시작할 때 자동으로 다시 시도됩니다. 이 일이 자주 발생하는 경우에만 액션을 취하십시오.
계획 한계 초과
계획 한계 초과 제목계정에 장치 한계를 초과할 때:
| 시간 | 장치 ID | 액션 | 버전 | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | 이 장치에서는 업데이트를 받을 수 없습니다. 업그레이드하거나 계정 결제 주기가 다시 시작될 때까지. |
업데이트가 필요합니다.: 계획을 업그레이드하세요. 다음 계정 결제 주기까지 기다려보세요.
채널 구성이 업데이트를 차단합니다.
채널 구성이 업데이트를 차단하는 경우채널 설정이 업데이트를 차단할 때:
| 시간 | 장치 ID | 업데이트 | 버전 | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | v1.x 장치에서는 v2.x (주 버전 업데이트가 차단됨)로 자동 업데이트할 수 없습니다. |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | 에뮬레이터가 감지되었으며 채널은 에뮬레이터를 차단합니다. |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | 개발자 빌드가 감지되었으며 채널은 개발자 빌드를 차단합니다. |
액션 필요: 이러한 보호는 의도적으로 설정되었습니다. 업데이트를 허용하려면 채널 설정을 수정하세요. 채널 설정.
Capgo 백엔드 열거형에서 가져온 로그 코드입니다.
제목 "Capgo 백엔드 열거형에서 가져온 로그 코드"__CAPGO_KEEP_0__ 열거형이 사용되는 데시보드에서 가져온 코드입니다. ( stats_action )입니다. UI에서 새로운 API을 보게 되면 __CAPGO_KEEP_1__ 또는 백엔드에서 발생되었으며 이 목록에 유효한지 검증된 것입니다.capgo/src/types/supabase.types.ts). If you see a new code in the UI, it was emitted by the SDK or backend and validated against this list.
Happy path & lifecycle
| Code(s) | 의미 |
|---|---|
get | Capgo이 현재 채널 매니페스트를 요청했습니다. |
download_manifest_start, download_manifest_complete | 델타 또는 멀티 파일 배포용 매니페스트 다운로드 시작/완료 |
download_zip_start, download_zip_complete | zip 아카이브 다운로드 시작/완료 |
download_10 … download_90 | 다운로드 진행률 마일스톤 |
download_complete | 전체 배포가 다운로드되었습니다. |
set | 다음 런칭을 위해 배포를 준비했습니다. |
reset | 기본 빌트인 배포로 되돌아갔습니다. |
delete | 지역 저장소에서 배포를 제거했습니다. |
uninstall | 앱이 제거되었습니다. |
app_moved_to_foreground, app_moved_to_background | SDK이 앱의 라이프 사이클 이벤트를 기록했습니다. |
ping | 장치에서 심박수 체크 |
setChannel, getChannel | SDK를 통해 채널을 오버라이드하거나 가져옵니다. |
채널 오버라이드 또는 __CAPGO_KEEP_0__를 통해 가져온 채널
| Code | 업데이트가 차단된 이유 |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | 채널 전략이 이 것을 금지합니다. semver 점프 |
disablePlatformIos, disablePlatformAndroid | 채널에서 플랫폼이 비활성화되었습니다. |
disableDevBuild, disableEmulator | 개발 빌드 또는 에뮬레이터가 허용되지 않습니다. |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | 채널 선택 또는 오버라이드가 실패했습니다. |
missingBundle, cannotGetBundle | 매니페스트는 Capgo를 제공할 수 없는 번들을 참조합니다. |
needPlanUpgrade | 회사에 장치 또는 플랜 제한이 있습니다. |
rateLimited | 요청이 너무 많습니다; SDK이 재시작할 때까지 제한 |
blocked_by_server_url, backend_refusal, InvalidIp | 서버 측 규칙이 요청을 차단했습니다 |
다운로드 / 무결성 / 설치 오류
| Code(s) | 의미 |
|---|---|
download_fail | 배포 다운로드 실패 (네트워크 또는 응답 오류) |
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail | 매니페스트 파일을 가져오거나 유효성 검사할 수 없습니다 |
checksum_fail, checksum_required | 무결성 검사 실패 또는 체크섬 누락 |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | 파일 시스템 또는 압축 해제 유효성 검사 실패 |
decrypt_fail | 암호화 실패 (암호화된 배포) |
update_fail | 배포가 설치되었지만 앱이 호출되지 않았습니다 notifyAppReady(); 롤백이 트리거되었습니다 |
download_zip_* with no 후속 set | 다운로드 완료했지만 설치 단계가 절대 완료되지 않았습니다. |
➡️ 더 깊은 code 지침이 필요하십니까? Full Log Code 참조 및 디버깅 가이드.
특정 로그 항목을 클릭하면 일반적으로 장치의 페이지로 이동합니다.
이러한 장치의 전체 기록을 볼 수 있으므로 장치별 문제를 진단하거나 업데이트 경로를 이해하는 데 매우 도움이 됩니다.로그에서 계속 특정 로그 항목을 클릭하면 일반적으로 장치의 페이지로 이동합니다.이러한 장치의 전체 기록을 볼 수 있으므로 장치별 문제를 진단하거나 업데이트 경로를 이해하는 데 매우 도움이 됩니다.
로그에서 계속
이미 로그를 사용 중이시면이미 로그를 사용 중이시면 로그 API를 위한 대시보드와 API 운영을 계획하기 위해 연결하세요. API 개요 API 개요에서 구현 세부 정보를 위한 소개 소개에서 구현 세부 정보를 위한 API 키 API 키에서 구현 세부 정보를 위한 장치 장치에서 구현 세부 정보를 위한 패키지 패키지에서 구현 세부 정보를 위한