로그
설치 단계 및 이 플러그인의 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
응용 프로그램 로그 이해
“애플리케이션 로그 이해하기”라는 제목의 섹션로그 페이지는 애플리케이션의 업데이트 이벤트와 진단 정보의 세부적인 기록을 제공합니다. 업데이트 프로세스를 모니터링하고 문제를 해결하는 데 중요하며, Capgo과 장치가 상호 작용하는 방식을 이해하는 데 도움이 됩니다. 이를 통해 애플리케이션을 클릭하여 그리고 “로그” 탭을 클릭하여 (이전에는 일부 오래된 스크린샷 또는 문서에서 “업데이트”라고 명명되었습니다).
그곳에서 로그 엔트리 목록을 표시하는 페이지를 볼 수 있습니다:
로그 페이지 인터페이스는 다음과 같습니다:
- 로그 탭 - 로그 뷰에 접근하기 위한 네비게이션 탭
- 리로드 버튼 - 로그 목록을 최신 데이터로 갱신하세요.
- 시간 범위 및 액션 필터 - 날짜 범위와 액션 유형(아래 섹션 참조)으로 로그를 필터하세요.
각 행은 다음과 같이 표시됩니다.
- 타임스탬프 (UTC)
- 디바이스 ID
- 액션 code (무엇이 발생했는지)
- 버전 이름 (번들 또는
builtin)
행을 클릭하여 디바이스 세부 정보 페이지로 이동하여 전체 기록을 확인하세요.
날짜 범위에 따라 필터링
날짜 범위에 따라 필터링 제목날짜 선택기를 사용하여 특정 시간 범위에 따라 로그를 필터링할 수 있습니다.
- 빠른 설정 - 일반적인 시간 범위 선택: 1시간, 3시간, 6시간, 또는 12시간
- 시작 시간 - 사용자 지정 시작 시간을 설정
- 종료 시간 - 사용자 지정 종료 시간을 설정
- 캘린더 - 캘린더 뷰를 사용하여 특정 날짜를 선택하세요.
선택한 날짜 범위를 적용하려면 '선택'을 클릭하거나 로그 픽커를 취소하려면 '취소'를 클릭하세요.
작업 유형으로 필터링하기
작업 유형으로 필터링하기로그를 특정 이벤트 유형으로 필터링할 수 있는 액션 드롭다운이 있습니다:
사용 가능한 액션 필터에는 다음과 같습니다:
- 디바이스 하트비트 디바이스에서 주기적으로 진행되는 건강 체크
- 버전 삭제 요청 버전이 삭제될 때
- __CAPGO_KEEP_0__으로 기본 버전으로 되돌리기 - 장치가 내장된 번들로 되돌아갈 때
- 버전 설치 성공 - 번들 설치 성공
- 장치에 업데이트 전송 - Capgo이 장치에 업데이트 보냈을 때
- 버전 설치 실패 - 번들 설치 실패
탑에 있는 검색 박스를 사용하여 특정 액션 유형을 빠르게 찾을 수 있습니다. 여러 액션을 선택하여 선택한 유형 중 하나와 일치하는 로그를 표시할 수 있습니다.
샘플 로그_snippet (가짜 데이터)
샘플 로그_snippet (가짜 데이터) 섹션| UTC 시간 | __CAPGO_KEEP_0__ ID | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ 버전 | __CAPGO_KEEP_0__이 알려주는 것 |
|---|---|---|---|---|
| 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이 매니페스트를 가져오고 SDK이 파일을 다운로드합니다 |
| 2025-01-14 10:00:07 | A1B2C3 | download_40 | 2.4.1 | __CAPGO_KEEP_0__이 다운로드 중 40% |
| 2025-01-14 10:00:12 | A1B2C3 | download_zip_complete | 2.4.1 | __CAPGO_KEEP_0__이 다운로드 완료 |
| 2025-01-14 10:00:13 | A1B2C3 | set | 2.4.1 | __CAPGO_KEEP_0__이 설치되었습니다. 다음으로 실행할 __CAPGO_KEEP_0__이 지정되었습니다 |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | __CAPGO_KEEP_0__ 정책으로 인해 2.x로 이동하는 것을 차단했습니다 |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | __CAPGO_KEEP_0__ | SDK이 요청 제한을 초과했습니다. 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 | 번들 설치 및 활성화 |
기기 이미 최신 버전입니다
기기 이미 최신 버전입니다기기가 최신 버전을 이미 가지고 있을 때:
| 시간 | 기기 ID | 액션 | 버전 | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | __CAPGO_KEEP_0__은 이미 최신 버전으로 업데이트되어 더 이상 업데이트가 필요하지 않습니다. |
__CAPGO_KEEP_0__ 업데이트에 실패하고 기존 버전으로 롤백되었습니다.
__CAPGO_KEEP_1____CAPGO_KEEP_2__ 업데이트가 실패하고 기존 버전으로 롤백될 때:
| __CAPGO_KEEP_3__ | __CAPGO_KEEP_4__ | __CAPGO_KEEP_5__ | __CAPGO_KEEP_6__ | __CAPGO_KEEP_7__ |
|---|---|---|---|---|
| 11:15:00 | i9j0k1l2 | get | 1.3.0 | __CAPGO_KEEP_8__ |
| 11:15:02 | i9j0k1l2 | download_complete | 1.3.0 | __CAPGO_KEEP_9__ |
| 11:15:03 | i9j0k1l2 | set | 1.3.0 | __CAPGO_KEEP_10__ |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | 앱이 충돌하거나 호출되지 않음 - 롤백 트리거 notifyAppReady() 내장 버전으로 되돌아감 |
| 11:15:11 | i9j0k1l2 | reset | Action needed | : 앱이 초기화가 성공적으로 완료된 후에 |
콜백 함수를 호출하는지 확인하세요. 자세한 내용은 플러그인 문서를 참조하세요. notifyAppReady() 다운로드 실패 네트워크 문제로 다운로드가 실패할 때 내장 버전으로 되돌아감
Action needed
: 앱이 초기화가 성공적으로 완료된 후에콜백 함수를 호출하는지 확인하세요. 자세한 내용은 플러그인 문서를 참조하세요.
| 시간 | 기기 ID | 액션 | 버전 | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 09:45:00 | m3n4o5p6 | get | 1.2.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 | - | 이 장치에서는 업데이트를 받지 못할 것입니다. 업그레이드 또는 청구 주기가 다시 시작될 때까지. |
필요한 액션: 계획을 업그레이드하세요 다음 청구 주기까지 기다려보세요.
채널 구성 업데이트 차단
채널 구성 업데이트 차단__CAPGO_KEEP_0__:
| __CAPGO_KEEP_0__ | __CAPGO_KEEP_1__ | __CAPGO_KEEP_2__ | __CAPGO_KEEP_3__ | 업데이트가 차단된 경우: |
|---|---|---|---|---|
| 12:00:00 | u1v2w3x4 | disableAutoUpdateToMajor | 2.0.0 | 시간 |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | 기기 ID |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | 액션 |
버전무슨 뜻인가? v1.x 기기에서는 v2.x (메이저 버전 업그레이드)로 자동 업데이트를 차단합니다. (메이저 버전 업그레이드 차단됨 ).
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.
__CAPGO_KEEP_0__
| Code(s) | 장치가 __CAPGO_KEEP_0__으로 현재 채널 매니페스트를 요청했습니다. |
|---|---|
get | Device asked Capgo for the current channel manifest |
download_manifest_start, download_manifest_complete | zip 아카이브 다운로드가 시작/완료되었습니다 |
download_zip_start, download_zip_complete | 다운로드 진행 단계 |
download_10 … download_90 | __CAPGO_KEEP_1__ |
download_complete | 전체 번들 다운로드 |
set | 다음 런칭을 위해 번들 준비 |
reset | 기본 번들로 디바이스 되돌리기 |
delete | 로컬 스토리지에서 번들 제거 |
uninstall | 앱 언인스톨 감지 |
app_moved_to_foreground, app_moved_to_background | SDK에 의해 SDK 이벤트 기록 |
ping | 디바이스에서 건강/하트비트 체크 |
setChannel, getChannel | SDK 호출을 통해 채널 오버라이드 또는 가져오기 |
구성 또는 정책 차단
| Code(s) | 업데이트가 차단된 이유 |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | 채널 전략이 이 작업을 금지합니다 __CAPGO_KEEP_0__ 버전 업그레이드 |
disablePlatformIos, disablePlatformAndroid | 채널에서 플랫폼이 비활성화되었습니다 |
disableDevBuild, disableEmulator | 개발자 빌드 또는 에뮬레이터 사용이 허용되지 않습니다 |
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured | 채널 선택 또는 오버라이드가 실패했습니다 |
missingBundle, cannotGetBundle | 매니페스트는 Capgo이 제공할 수 없는 번들 Capgo을 참조합니다 |
needPlanUpgrade | 기업이 계획/디바이스 제한을 초과했습니다 |
rateLimited | SDK이 재시작할 때까지 요청이 너무 많습니다; SDK이 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 | 인TEGRITY 검사 실패 또는 체크섬 누락 |
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail | 파일 시스템 또는 압축 해제 유효성 검사 실패 |
decrypt_fail | 암호화된 배포를 위한 암호화 실패 |
update_fail | 배포가 설치되었지만 앱이 호출되지 않았습니다 notifyAppReady(); rollback이 트리거되었습니다 |
download_zip_* 이후에 set | 다운로드가 완료되었지만 설치 단계가 완료되지 않았습니다 |
➡️ 더 깊은 code 지침이 필요합니다? Full Log Code 참조 및 디버깅 가이드.
로그에 대한 자세한 정보를 얻으려면
‘로그에 대한 자세한 정보를 얻으려면’라는 제목을 가진 섹션특정 로그 항목을 클릭하면 일반적으로 해당 장치 페이지로 이동합니다. 이로써 특정 장치의 전체 기록을 볼 수 있으며, 장치별 문제를 진단하거나 업데이트 경로를 이해하는 데 매우 유용합니다. 장치의 페이지장치별 문제를 진단하거나 업데이트 경로를 이해하는 데 매우 유용합니다.
로그에서 계속
로그에서 계속로그를 사용하여 대시보드와 __CAPGO_KEEP_0__ 작업을 계획하고 있다면 __CAPGO_KEEP_0__ Overview와 연결하세요. __CAPGO_KEEP_0__ Overview API Overview API Overview for the implementation detail in API Overview, 소개 __CAPGO_KEEP_0__ API 키 implementation 세부 정보에 대한 API 키 장치 implementation 세부 정보에 대한 장치 번들 implementation 세부 정보에 대한 번들