로그

Copy a setup prompt with the install steps and the full markdown guide for this plugin.

응용 프로그램 로그 이해

로그 페이지는 업데이트된 이벤트의 세부 정보와 디버그 정보를 제공하여 애플리케이션의 업데이트 프로세스를 모니터링하고 문제를 해결하고 Capgo과 장치 간의 상호 작용을 이해하는 데 중요합니다. 이에 대한 접근은 앱을 클릭하여 그리고 그 다음 ‘로그’ 탭을 클릭하세요 (이전에는 ‘업데이트’라고 불렀던 일부 이전 스크린샷 또는 문서에서).

그곳에서 로그 엔트리 목록과 같은 페이지를 볼 수 있습니다:

로그 페이지 인터페이스는 다음과 같습니다:

로그 탭 - 로그 뷰에 접근하는 탐색 탭
재로드 버튼 - 로그 목록을 최신 데이터로 갱신
시간 범위 및 액션 필터 - 로그를 날짜 범위와 액션 유형으로 필터링

각 행은 다음과 같이 표시됩니다:

시간대 (UTC)
기기 ID
액션 code (이벤트)
버전 이름 (배포 또는 builtin)

기기 상세 페이지로 이동하려면 행을 클릭하세요.

날짜 범위로 필터링

날짜 선택기를 사용하여 특정 시간 범위에 대한 로그를 필터링할 수 있습니다.

빠른 설정 - 일반적인 시간 범위 선택: 1시간, 3시간, 6시간, 또는 12시간
시작 시간 - 사용자 지정 시작 시간을 설정
종료 시간 - 사용자 지정 종료 시간을 설정
캘린더 - 캘린더 뷰를 사용하여 특정 날짜 선택

선택 버튼을 클릭하여 선택한 날짜 범위를 적용하거나, 취소 버튼을 클릭하여 필터기를 닫습니다.

작업 유형으로 필터링

액션 드롭다운은 로그를 특정 이벤트 타입으로 필터링할 수 있게 해줍니다:

사용 가능한 액션 필터는 다음과 같습니다:

디바이스 하트비트 - 디바이스에서 주기적으로 건강 체크를 수행하는 것
버전 삭제 요청 - 버전이 삭제될 때
기본 버전으로 되돌리기 - 디바이스가 빌트인 버전으로 되돌아갈 때
버전 설치 성공 - __CAPGO_KEEP_0__ 설치 성공
장치로 새로운 버전 전송 - Capgo이 장치로 업데이트를 보낼 때
버전 설치 실패 - 번들 설치가 실패할 때

상단의 검색 박스를 사용하여 특정 액션 유형을 빠르게 찾을 수 있습니다. 여러 액션을 선택하여 선택한 유형 중 하나와 일치하는 로그를 표시할 수 있습니다.

샘플 로그_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	__CAPGO_KEEP_0__이 압축 파일 다운로드가 완료되었습니다
2025-01-14 10:00:13	`A1B2C3`	`set`	2.4.1	번들이 설치되었으며 다음으로 실행할 준비가되었습니다
2025-01-14 10:05:00	`B9C8D7`	`disableAutoUpdateToMajor`	1.9.0	채널 정책으로 인해 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	설치 및 활성화 완료

장치가 이미 최신 버전입니다.

장치가 최신 버전을 확인했지만 이미 최신 버전이면:

시간	장치 ID	액션	버전	이것은 무엇을 의미합니까?
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	배포가 설정되었습니다
11:15:10	`i9j0k1l2`	`update_fail`	1.3.0	앱이 충돌하거나 `notifyAppReady()` 호출되지 않았습니다 - 롤백이 트리거되었습니다
11:15:11	`i9j0k1l2`	`reset`	내장	장치가 기본 버전으로 되돌아감

액션 필요: 앱이 __CAPGO_KEEP_0__을 호출하는지 확인하세요 notifyAppReady() 초기화가 성공적으로 완료된 후. 자세한 내용은 플러그인 문서를 참조하세요. 다운로드 실패

다운로드 실패 섹션

시간

장치 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`	-	이 기기는 업그레이드하거나 계정 결제 주기가 다시 시작될 때까지 업데이트를 받지 못합니다.

필요한 액션: 계획을 업그레이드하세요 다음 계정 결제 주기를 기다려보세요.

채널 구성 차단 업데이트

채널 설정이 업데이트를 차단할 때:

시간	기기 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 백엔드 열거형)

이 코드들은 stats_action enum 사용하는 API (capgo/src/types/supabase.types.ts) UI에서 새로운 code를 발견하면 SDK 또는 백엔드에서 발생했으며 이 목록에 대해 검증되었습니다.

happy path & lifecycle

Code(s)	의미
`get`	Device asked Capgo for the current channel manifest
`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 호출을 통해 채널 오버라이드 또는 가져오기

구성 또는 정책 블록

Code(s)	업데이트가 차단된 이유
`disableAutoUpdate`, `disableAutoUpdateToMajor`, `disableAutoUpdateToMinor`, `disableAutoUpdateToPatch`, `disableAutoUpdateMetadata`, `disableAutoUpdateUnderNative`	채널 전략이 이 semver 점프를 금지합니다
`disablePlatformIos`, `disablePlatformAndroid`	채널에서 플랫폼이 비활성화됨
`disableDevBuild`, `disableEmulator`	개발 빌드 또는 시뮬레이터가 허용되지 않음
`cannotUpdateViaPrivateChannel`, `NoChannelOrOverride`, `channelMisconfigured`	채널 선택 또는 오버라이드 실패
`missingBundle`, `cannotGetBundle`	Manifest는 Capgo이 제공할 수 없는 패키지 Capgo을 의미합니다.
`needPlanUpgrade`	회사 __CAPGO_KEEP_0__의 계획/장치 한도에 도달했습니다.
`rateLimited`	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`	무결성 검사 실패 또는 체크섬 누락
`unzip_fail`, `directory_path_fail`, `canonical_path_fail`, `windows_path_fail`	파일 시스템 또는 압축 해제 유효성 검사 실패
`decrypt_fail`	암호화된 배포 패키지의 암호 해독 실패
`update_fail`	설치된 패키지만 앱이 호출되지 않음 `notifyAppReady()`; 롤백이 트리거됨
`download_zip_*` 이후의 `set`	다운로드가 완료되었지만 설치 단계가 절대 완료되지 않았음

➡️ 더 깊은 code 단계의 지침이 필요합니까? Full Log Code 참조 및 디버깅 가이드.

로그에 대한 더 많은 정보를 얻기

특정 로그 항목을 클릭하면 일반적으로 장치의 페이지로 이동하게 됩니다. 이러한 장치의 전체 기록을 볼 수 있으므로 장치별 문제를 진단하거나 업데이트의 경로를 이해하는 데 매우 유용합니다.이 장치의 전체 기록을 볼 수 있으므로 장치별 문제를 진단하거나 업데이트의 경로를 이해하는 데 매우 유용합니다.