로그

설치 단계와 이 플러그인에 대한 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하세요.

로그 및 로그 인사이트

앱 로그 기본적으로 탭이 열립니다. 1, 3, 7, 또는 30일 기간에 카테고리, 버전, 및 장치에 대한 우선순위를 설정하기 위해 인사이트를 사용하세요. 기본 탭으로 로그 인사이트를 전환하세요. 로그 인사이트 기본적으로 탭이 열립니다. 1, 3, 7, 또는 30일 기간에 카테고리, 버전, 및 장치에 대한 우선순위를 설정하기 위해 인사이트를 사용하세요. 기본 탭으로 로그 인사이트를 전환하세요. Logs __CAPGO_KEEP_0__

애플리케이션 로그 이해

The raw Logs subtab provides a detailed history of update events and diagnostic information for your application. It is useful for confirming the device-level evidence behind an Insight, troubleshooting an update path, and understanding how devices interact with Capgo. Open an app, choose The raw Logs subtab provides a detailed history of update events and diagnostic information for your application. It is useful for confirming the device-level evidence behind an Insight, troubleshooting an update path, and understanding how devices interact with __CAPGO_KEEP_0__. Open an app, choose로그 Logs , then choose the

subtab overview showing the main interface for raw Logs tab is not translated as it is a title and not a description, so it is kept as is: Raw Logs tab overview showing the main interface

로그 sub탭 — 개별 로그 행의 네비게이션 제어.
재로드 버튼 — 로그 목록을 최신 데이터로 갱신합니다.
시간 범위 및 액션 필터 — 시간과 액션으로 이벤트 스트림을 좁힙니다.

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

시간 스탬프 (UTC)
기기 ID
액션 code (발생한 일)
버전 이름 (번들 또는 builtin)

클릭하여 장치 세부 정보 페이지의 전체 기록으로 이동하세요.

날짜 범위에 따라 필터링

특정 시간 범위에 따라 로그를 필터링할 수 있습니다. 날짜 선택기 사용:

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

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

작업 유형으로 필터링

액션 드롭다운은 특정 이벤트 유형에 따라 로그를 필터링할 수 있습니다:

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

디바이스 하트비트 - 장치에서 주기적인 건강 검사
__CAPGO_KEEP_0__ 버전 삭제 요청 - 버전이 삭제된 경우
기본 버전으로 되돌리기 - 장치가 기본 빌드 버전으로 되돌았을 때
버전 설치 성공 - 빌드 설치 성공
__CAPGO_KEEP_0__에서 장치로 새로운 버전 전송 - Capgo에서 장치로 업데이트를 보냈을 때
버전 설치 실패 - 빌드 설치 실패

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

Sample log snippet (fake data)

Time (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	업데이트가 설치되어 다음으로 실행될 준비가되었습니다.
2025-01-14 10:05:00	`B9C8D7`	`disableAutoUpdateToMajor`	1.9.0	채널 정책으로 인해 2.x로의 점프가 차단되었습니다.
2025-01-14 10:05:05	`B9C8D7`	`rateLimited`	내장	장치가 요청 제한을 초과했습니다; SDK은 재시작할 때까지 백오프합니다.

예제 로그 시나리오

로그가 무엇을 말하는지 이해하는 데 도움이 될 수 있도록, 실제 장치 업데이트여행을 보여주는 예제 시퀀스를 보겠습니다.

성공적인 업데이트로직

시간

장치 ID	액션	action	버전	이것은 무엇을 의미합니까
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	__CAPGO_KEEP_0__ 정보가 받았습니다.
11:15:02	`i9j0k1l2`	`download_complete`	1.3.0	__CAPGO_KEEP_0__ 다운로드가 완료되었습니다.
11:15:03	`i9j0k1l2`	`set`	1.3.0	__CAPGO_KEEP_0__이 설정되었습니다.
11:15:10	`i9j0k1l2`	`update_fail`	1.3.0	__CAPGO_KEEP_0__이 실패하거나 `notifyAppReady()` 호출되지 않았습니다 - 롤백이 트리거되었습니다.
11:15:11	`i9j0k1l2`	`reset`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__으로 되돌아갔습니다.

__CAPGO_KEEP_0__이 필요합니다.__CAPGO_KEEP_1__이 성공적으로 초기화된 후 앱이 __CAPGO_KEEP_2__을 호출하는지 확인하세요. __CAPGO_KEEP_3__을 참조하세요. notifyAppReady() __CAPGO_KEEP_3__에서 __CAPGO_KEEP_4__에 대한 자세한 내용을 확인하세요. __CAPGO_KEEP_5__ __CAPGO_KEEP_6__

다운로드 실패

네트워크 문제로 다운로드가 실패할 때:

시간	기기 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_1__

__CAPGO_KEEP_3__

__CAPGO_KEEP_4__	__CAPGO_KEEP_5__	__CAPGO_KEEP_6__	__CAPGO_KEEP_7__	__CAPGO_KEEP_8__
12:00:00	`u1v2w3x4`	`disableAutoUpdateToMajor`	2.0.0	__CAPGO_KEEP_9__
12:05:00	`y5z6a7b8`	`disableEmulator`	1.2.0	__CAPGO_KEEP_10__
12:10:00	`c9d0e1f2`	`disableDevBuild`	1.2.0	__CAPGO_KEEP_11__

필요한 액션: 이들은 의도적인 보호입니다. 업데이트를 허용하려면 채널 설정을 수정하세요. 채널 설정.

로그 코드 (Capgo 백엔드 열거형)

이 코드들은 stats_action 백엔드 열거형 API (capgo/src/types/supabase.types.ts)에서 나옵니다. UI에서 새로운 code를 보게 되면, SDK 또는 백엔드에서 발생되었으며 이 목록에 대해 유효성 검사를 거쳤습니다.

happy path & lifecycle

Code(s)	의미
`get`	장치가 현재 채널 매니페스트를 요청했습니다 Capgo
`download_manifest_start`, `download_manifest_complete`	delta 또는 다중 파일 배포용으로 매니페스트 다운로드 시작/완료
`download_zip_start`, `download_zip_complete`	Zip 아카이브 다운로드 시작/완료
`download_10` … `download_90`	다운로드 진행률 마일스톤
`download_0`	처음 진행 이벤트의 진행률 0% 표시
`download_complete`	전체 배포 다운로드 완료
`set`	다음 런칭을 위해 배포 준비
`reset`	기본 제공 배포로 디바이스가 되돌아감
`delete`	로컬 스토리지에서 배포 제거
`uninstall`	앱 언인스톨 감지
`app_moved_to_foreground`, `app_moved_to_background`	SDK에 의해 기록된 앱 라이프 사이클 이벤트
`ping`	디바이스에서 건강/하트 비트 체크
`setChannel`, `getChannel`	SDK 호출을 통해 채널 overridden 또는 가져옴

새 정책 차단 / 속도 제한 빠른 해결

Code	이러한 현상이 발생하는 이유	다음 단계는 무엇인가요
`invalidIp`	Capgo는 Google/클라우드 인프라 IP를 가진 봇 트래픽이 보이는 것을 감지했습니다.	실제 사용자에게는 무시하십시오; 실제 장치 및 일반 네트워크에서 다시 시도하거나 시간이 지난 후 확인하십시오.
`needPlanUpgrade`	기업이 계획/장치 한도에 도달했습니다.	대시보드에서 계획을 업그레이드하거나 다음 청구 주기까지 기다리십시오.
`semver_error`	config에서 설정된 네이티브 앱 버전이 없거나 유효하지 않은 semver입니다 (`x.y.z`).	설정 `plugins.CapacitorUpdater.version` 유효한 semver로 설정하십시오. 그리고 그것을 확인하십시오. SemVer 테스터 앱을 다시 빌드하세요.
`disablePlatformIos`	iOS는 채널 정책에서 비활성화되어 있습니다.	이것이 실수로 발생한 경우, 해당 채널에서 iOS를 활성화하고 라우팅을 다시 게시하세요. 만약에 의도적으로 iOS를 이 트랙에서 차단하려면, 그대로 두고 iOS 빌드를 별도의 채널로 옮겨주세요.
`disablePlatformAndroid`	Android는 채널 정책에서 비활성화되어 있습니다.	이것이 실수로 발생한 경우, 해당 채널에서 Android를 활성화하고 라우팅을 다시 게시하세요. 만약에 의도적으로 Android를 이 트랙에서 차단하려면, 그대로 두고 Android 빌드를 별도의 채널로 옮겨주세요.
`disableAutoUpdate`	채널 자동 업데이트 모드는 이 업데이트 스타일을 차단합니다.	채널 자동 업데이트 정책을 변경하세요 (major/minor/patch/metadata/none)로 intended 롤아웃을 허용하세요.
`disableAutoUpdateUnderNative`	채널은 기기 기준선보다 이전 버전의 업데이트를 차단합니다.	기기 기준선 이상의 버전을 푸시하거나, 기기 기준선 이하의 보호를 비활성화하세요.
`disableAutoUpdateMetadata`	채널은 `min_update_version` 메타데이터가 필요하고 앱은 이전 버전입니다.	__CAPGO_KEEP_0__ `min_update_version` __CAPGO_KEEP_0__
`disableAutoUpdateToMajor`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
`disableAutoUpdateToMinor`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
`disableAutoUpdateToPatch`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
`disableEmulator`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
`disableDevBuild`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__
`disableProdBuild`	A __CAPGO_KEEP_0__이 생산 모드에서 빌드된 기기입니다. `/updates`__CAPGO_KEEP_0__가 블록된 채널에서 작동하지 않습니다.	이것이 실수로 발생한 경우, 해당 채널에서 생산 업데이트 허용하고 다시 게시하세요. 만약 이것이 의도한 행동이라면, 제한을 유지하고 올바른 채널/빌드에 생산 빌드를 보내세요.
`cannotGetBundle`	Capgo는 선택한 배포본에 대한 유효한 다운로드 URL을 생성할 수 없습니다.	배포본을 다시 업로드하거나 매니페스트를 재생성하고 R2/public 배포본 설정을 확인하세요.
`cannotUpdateViaPrivateChannel`	앱이 자체 ASSIGNMENT을 허용하지 않는 비공개 채널로 자체 SWITCH를 시도했습니다.	허용 `allow_device_self_set` 채널 또는 PUBLIC/ALLOWED 채널로 SWITCH하세요.
`channelMisconfigured`	채널 자동 업데이트 규칙이 필요한 데이터가 누락되어 있습니다 (`version_number` without `min_update_version`).	해당 규칙의 누락된 설정을 채우거나 AUTO-UPDATE 모드를 단순화하세요.
`missingBundle`	배포본이 다운로드 가능한 페이로드가 없습니다 (누락된 `external_url`/`r2_path` __CAPGO_KEEP_0__	버전을 재구축/재업로드하고 실제 파일 내용이 있는 번들을 확인하세요.
`NoChannelOrOverride`	이 기기와 일치하는 채널이 없습니다 (클라우드 기본값이 없으며 config fallback 및 override도 없습니다).	대시보드에서 채널 기본값을 설정하거나 테스트를 유지하세요. `defaultChannel` 이 빌드에 대해.
`rateLimited`	render-루프에서 자주 발생하는 경우 ( `setChannel`/`getChannel`).	render-루프에서 호출하지 마세요. 사용자 동작에만 호출하세요. 사용자 동작 시 호출하세요. `defaultChannel` 이 `capacitor.config`.
`keyMismatch`	vs`device_key_id` 콘솔에서 기기 및 번들의 암호화 키 ID를 비교하세요. 다르다면 동일한 키와 일치하는 __CAPGO_KEEP_0__/플러그인 버전으로 배포하세요. 키 인코딩은 버전 간에 다를 수 있습니다. `bundle_key_id`).	In the console, compare device and bundle key IDs. If they differ, publish with the same key and matching CLI/plugin version; key encoding can differ between versions.
`disableDevice`	__CAPGO_KEEP_0__	If accidental, real-device updates channel을 켜세요. 만약 의도적이면, real-device updates channel을 차단하고 다른 채널로 라우팅하세요.
`disablePlatformElectron`	이 채널에서 Electron은 차단되어 있습니다.	만약 실수로 이 채널에서 Electron을 차단했다면, 이 채널에서 Electron을 활성화하고 라우팅을 다시 배포하세요. 만약 의도적이면, 계속 차단하고 Electron 사용자에게 전용 채널로 보냅니다.
`customIdBlocked`	사용자 지정 디바이스 ID가 전송되었습니다. 그러나 이 앱은 사용자 지정 ID를 받지 않습니다.	사용자 지정 ID 전송을 끄거나, 사용자 지정 ID를 활성화하세요. 만약 워크플로우에서 사용자 지정 ID가 필요하다면.
`blocked_by_server_url`	이 앱은 `server.url` 구성되어 있으므로 Capacitor은 로컬 파일 대신 원격 URL을 제공합니다.	제거/초기화 `server.url` 생산 빌드용으로 사용하고 업데이트 패키지를 로컬로 유지하세요.
`backend_refusal`	업데이터는 `v4`, 이 백엔드가 더 이상 받아들이지 않습니다.	플러그인/CLI을 업그레이드하세요. `v5`+ (prefer `v8`), with Capacitor `v5`+, then rebuild and republish bundle metadata.
__CAPGO_KEEP_0__(s)가 설정된 구성 또는 정책 블록

Code(s)가 설정된 구성 또는 정책 블록	업데이트가 차단된 이유
`disableAutoUpdate`, `disableAutoUpdateToMajor`, `disableAutoUpdateToMinor`, `disableAutoUpdateToPatch`, `disableAutoUpdateMetadata`, `disableAutoUpdateUnderNative`	이 채널의 전략은 이 작업을 금지합니다. semver 업데이트가 허용되지 않습니다.
`disablePlatformIos`, `disablePlatformAndroid`	이 채널에서 플랫폼이 비활성화되었습니다.
`disableDevBuild`, `disableEmulator`	개발자 빌드 또는 에뮬레이터는 이 채널에서 허용되지 않습니다.
`disableProdBuild`, `disableDevice`, `disablePlatformElectron`	이 채널에서는 실제 기기나 Electron을 사용한 빌드가 허용되지 않습니다.
`customIdBlocked`	이 앱에 대한 사용자 지정 디바이스 ID가 허용되지 않습니다.
`cannotUpdateViaPrivateChannel`, `NoChannelOrOverride`, `channelMisconfigured`	채널 선택 또는 우선순위가 실패했습니다.
`missingBundle`, `cannotGetBundle`	매니페스트는 Capgo을 제공할 수 없는 번들에 대한 참조입니다.
`needPlanUpgrade`	회사에 도달한 한계입니다.

다운로드 / 무결성 / 설치 오류

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()`rollback이 트리거되었습니다.
`download_zip_*` 이후에 발생하지 않습니다. `set`	다운로드가 완료되었지만 설치 단계가 절대 완료되지 않았습니다.

런타임 / 플랫폼 이벤트

Code(s)	의 의미
`app_crash`, `app_crash_native`	JavaScript 또는 네이티브 런타임层에서 발생한 충돌 이벤트. 스택, 소스 및 활성 버전 정보가 포함된 메타데이터가 종종 포함됩니다.
`app_anr`	Android에서 응용 프로그램이 응답하지 않습니다.
`app_killed_low_memory`, `app_killed_excessive_resource_usage`	메모리 또는 자원 제한으로 인해 앱 프로세스가 종료되었습니다.
`app_initialization_failure`, `app_memory_warning`	정상적인 런타임 전에 시작이 중단되거나 메모리 압박이 관찰되었습니다.
`webview_javascript_error`, `webview_unhandled_rejection`, `webview_resource_error`, `webview_security_policy_violation`, `webview_unclean_restart`, `webview_render_process_gone`, `webview_content_process_terminated`	웹뷰 라이프사이클 및 JS/렌더링 오류. Sentry를 JS 및 네이티브层 모두에 설치하여 스택 추적, 세션/디바이스 컨텍스트 및 URL/상태를 더 빠른 수정을 위해 캡처하세요.
`os_version_changed`, `native_app_version_changed`	OS 또는 네이티브 앱 버전이 변경되었습니다; 이 도움이 플랫폼 수준의 배포 효과와 웹 번들의 동작을 분리하는 데 도움이 됩니다.

➡️ 더 자세한 code 지침이 필요하십니까? Full Log Code Reference and Debugging Guide.

__CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기

__CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기 __CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기__CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기

__CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기

__CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기 __CAPGO_KEEP_0__ 로그에 대한 자세한 정보를 얻기 API 운영을 계획하고 API 작업을 연결하기 위해 API 개요 API 개요에서 구현 세부 정보를 위한 소개 소개에서 구현 세부 정보를 위한 API 키 API 키에서 구현 세부 정보를 위한 기기 기기에서 구현 세부 정보를 위한 패키지 패키지에서 구현 세부 정보를 위한