로그

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함하여 __CAPGO_KEEP_0__를 설정하기 위한 지시를 복사하세요.

__CAPGO_KEEP_0__를 이해하는 방법

The Logs page provides a detailed history of update events and diagnostic information for your application. This is crucial for monitoring the update process, troubleshooting issues, and understanding how your devices interact with Capgo. You can access it by 앱을 클릭합니다. 그리고 '로그' 탭을 클릭합니다 (이전에는 '업데이트'라고 불렸습니다. 일부 이전 스크린샷이나 문서에서)..

From there you should see a page similar to this, displaying a list of log entries:

The logs page interface includes:

로그 탭 - 로그 뷰에 접근할 수 있는 네비게이션 탭
리로드 버튼 - 로그 목록을 최신 데이터로 갱신합니다
시간 범위 및 액션 필터 - 로그를 날짜 범위와 액션 유형으로 필터링 (아래 섹션 참조)

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

타임스탬프 (UTC)
디바이스 ID
액션 code (발생한 일)
버전 이름 (배포 또는 builtin)

디바이스 세부 정보 페이지로 이동하려면 행을 클릭하십시오.

날짜 범위로 필터링

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

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

클릭하여 선택한 날짜 범위를 적용하거나, 선택기를 취소하려면 “취소”를 클릭하세요.

작업 유형으로 필터링하기

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

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

디바이스 하트 비트 - 디바이스에서 주기적으로 건강 체크를 수행하는 것
버전 삭제 요청 - 버전이 삭제될 때
- Periodic health checks from devices - 기기에서 기본 빌드로 되돌아가면
버전이 성공적으로 설치되었습니다. - 빌드 설치가 성공적으로 완료되었습니다.
기기로 새로운 버전을 전송했습니다. - Capgo이 기기에 업데이트를 전송할 때
버전 설치가 실패했습니다. - 빌드 설치가 실패했습니다.

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

샘플 로그.snippet (가짜 데이터)

UTC 시간	기기 ID	액션	버전	무엇을 알려줍니다
2025-01-14 10:00:01	`A1B2C3`	`get`	2.4.1	Capgo 업데이트가 있는지 확인하라는 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	__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__이 설치되었으며 다음으로 실행될 예정인 시점
2025-01-14 10:05:00	`B9C8D7`	`disableAutoUpdateToMajor`	1.9.0	__CAPGO_KEEP_0__의 채널 정책이 2.x로의 전환을 차단한 시점
2025-01-14 10:05:05	`B9C8D7`	`rateLimited`	내장	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	기기는 이미 최신 버전이므로 업데이트가 필요하지 않습니다.

업데이트 실패 시 롤백

업데이트가 실패하고 장치가 롤백될 때:

시간	장치 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()` __CAPGO_KEEP_0__
11:15:11	`i9j0k1l2`	`reset`	__CAPGO_KEEP_0__	__CAPGO_KEEP_0__

__CAPGO_KEEP_0__앱이 __CAPGO_KEEP_0__을 호출하는지 확인하세요. notifyAppReady() 자세한 내용은 플러그인 문서를 참조하세요. 다운로드 실패 다운로드 실패

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

protectedTokens

texts	기기 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__	작업	버전	이것이 의미하는 바
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 백엔드 열거형 API (capgo/src/types/supabase.types.ts)에서 나옵니다. UI에서 새로운 code를 보게 되면, 이는 SDK 또는 백엔드에서 발생되었으며 이 목록에 대해 검증되었습니다.

행복한 경로 & 라이프 사이클

Code(s)	의미
`get`	장치가 Capgo으로 현재 채널 매니페스트를 요청했습니다.
`download_manifest_start`, `download_manifest_complete`	매니페스트 다운로드가 시작/완료되었습니다 (델타 또는 멀티 파일 배포)
`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 또는 fetched

새 정책-차단/속도 제한 빠른 고정

Code	이것이 왜 발생하는지	다음 단계를 수행하세요
`invalidIp`	Capgo는 Google/클라우드 인프라 IP를 사용하는 봇 트래픽이 보이는 것을 감지했습니다.	실제 사용자에게는 무시하세요; 실제 장치에서 재시도하거나 일반 네트워크에서 재시도하거나 시간이 지난 후 확인하세요.
`needPlanUpgrade`	기업이 플랜/디바이스 제한치를 초과했습니다.	설정판에서 플랜을 업그레이드하거나 다음 청구 주기까지 기다리세요.
`semver_error`	config에서 설정된 네이티브 앱 버전이 없거나 유효하지 않은 semver입니다 (`x.y.z`).	설정 `plugins.CapacitorUpdater.version` 유효한 semver로 설정하세요, 그 다음 SemVer 테스터 에서 확인하고 앱을 다시 빌드하세요.
`disablePlatformIos`	iOS는 채널 정책에서 비활성화되어 있습니다.	이것이 실수로 발생한 경우, iOS를 활성화하고 라우팅을 다시 게시하세요. 만약에 의도적으로 iOS를 이 트랙에서 차단했다면, 계속해서 iOS를 차단하고 iOS 빌드를 별도의 채널로 이동하세요.
`disablePlatformAndroid`	Android은 채널 정책에서 비활성화되어 있습니다.	이것이 실수로 발생한 경우, Android을 해당 채널에서 활성화하고 다시 라우팅을 게시하세요. 만약에 Android을 이 트랙에서 의도적으로 차단했다면, 계속 차단하고 Android 빌드를 별도의 채널로 이동하세요.
`disableAutoUpdate`	채널 자동 업데이트 모드는 이 업데이트 스타일을 차단합니다.	채널 자동 업데이트 정책을 변경하여 (major/minor/patch/metadata/none) 의도된 롤아웃을 허용하세요.
`disableAutoUpdateUnderNative`	채널은 기기 기준선보다 이전의 업데이트를 차단합니다.	기기 기준선 이상의 버전을 푸시하거나, 기기 기준선 이하의 보호를 비활성화하세요.
`disableAutoUpdateMetadata`	채널은 `min_update_version` 메타데이터가 필요하고 앱은 더 오래된 버전입니다.	설정 `min_update_version` 새로운 네이티브 버전에서 대상 배포본 또는 릴리스를 위해
`disableAutoUpdateToMajor`	채널은 메이저 버전跳뛰기를 차단합니다.	메이저 버전을 같은 채널 전략에 유지하거나, 이 트랙에서 메이저 버전跳뛰기를 허용하세요.
`disableAutoUpdateToMinor`	The channel blocks minor version jumps.	이 트랙의 동일한 채널 전략에서 미니어처 버전을 유지하거나, 또는 이 트랙에 대해 미니어처 점프를 허용하세요.
`disableAutoUpdateToPatch`	The channel blocks patch-level jumps for this flow.	이 트랙의 동일한 채널 정책에서 릴리스 주기와 일치하거나, 또는 이 채널에서 패치 점프를 열어주세요.
`disableEmulator`	Emulator updates are not allowed for this channel.	이 채널에서 에뮬레이터 업데이트는 허용되지 않습니다. 만약 이는 실수로 발생했다면, 에뮬레이터 업데이트를 허용하는 테스트 채널에서 에뮬레이터를 검증하세요. 만약 이는 의도적으로 발생했다면, 이 채널에서 에뮬레이터 업데이트를 차단하고, 에뮬레이터 빌드를 위해 다른 채널을 사용하세요.
`disableDevBuild`	Dev builds are blocked for this channel.	이 채널에서 개발 빌드는 차단되어 있습니다. 만약 이는 실수로 발생했다면, 개발 업데이트를 허용하거나, 이 기기를 개발 빌드가 허용되는 채널로 이동하세요. 만약 이는 의도적으로 발생했다면, 이 채널에서 릴리스 빌드만 허용하세요.
`disableProdBuild`	A device build in production mode called `/updates`, while your channel blocked it.	릴리스 모드에서 빌드된 기기
`cannotGetBundle`	, 이 채널에서 차단되어 있습니다. 만약 이는 실수로 발생했다면, 이 채널에서 릴리스 업데이트를 허용하고, 다시 빌드하세요. 만약 이는 의도적으로 발생했다면, 이 제한을 유지하고, 릴리스 빌드를 올바른 채널/빌드로 전송하세요. Capgo could not build a valid download URL for the selected bundle.	__CAPGO_KEEP_0__ 다시 업로드하거나 매니페스트 재생성하고 R2/public 배포 설정을 확인하세요.
`cannotUpdateViaPrivateChannel`	앱이 자체 Switch를 시도하여 자체 assign을 허용하지 않는 개인 채널로 이동했습니다.	Enable `allow_device_self_set` 채널 또는 Switch로 허용된 Public 채널로 이동하세요.
`channelMisconfigured`	채널 자동 업데이트 규칙이 필요한 데이터가 누락되었습니다. (`version_number` without `min_update_version`).	누락된 구성 정보를 채워주거나 자동 업데이트 모드를 단순화하세요.
`missingBundle`	배포본이 다운로드 가능한 파일이 없습니다 (누락된 `external_url`/`r2_path` 그리고 매니페스트).	버전을 재생성/업로드하고 배포본이 실제 파일 내용을 가지고 있는지 확인하세요.
`NoChannelOrOverride`	이 장치에 해당하는 채널이 없습니다 (클라우드 기본값이 없으며 구성 fallback도 없으며 override도 없습니다).	설정판에서 채널 기본값을 설정하거나 테스트를 유지하세요. `defaultChannel` In 빌드에서.
`rateLimited`	짧은 시간 내에 update/channel 호출이 너무 많습니다 (가끔 render-loop `setChannel`/`getChannel`).	렌더링 중에 호출하지 마세요. 사용자 동작에만 호출하세요. `defaultChannel` 에서 `capacitor.config`.
`keyMismatch`	앱 및 배ंडल 암호화 키 ID가 다릅니다 (`device_key_id` vs `bundle_key_id`).	콘솔에서 기기 및 배ंडल 키 ID를 비교하세요. 다르면 동일한 키 및 일치하는 CLI/플러그인 버전으로 배포하세요; 키 인코딩은 버전 간에 다를 수 있습니다.
`disableDevice`	실제 전화/태블릿이 차단되었습니다. 이 채널은 실장기기를 차단하도록 설정되어 있습니다.	실수로 발생한 경우, 빌드 채널에서 실장기기 업데이트를 켜세요. 의도적으로 차단한 경우, 채널을 차단하고 다른 채널로 실장기기를 라우팅하세요.
`disablePlatformElectron`	이 채널에서 Electron이 차단되었습니다.	의도적으로 차단한 경우, 채널에서 Electron을 활성화하고 다시 라우팅하세요. 실수로 발생한 경우, 채널에서 Electron을 활성화하고 다시 배포하세요.
`customIdBlocked`	사용자 지정 기기 ID가 전송되었습니다. 그러나 이 앱은 사용자 지정 ID를 받지 않습니다.	사용자 고유 ID 전송을 끄거나, 사용자 고유 ID를 사용하는 경우에만 사용하도록 설정하세요.
`blocked_by_server_url`	앱은 `server.url` 설정되어 있으므로 Capacitor은 로컬 파일 대신远程 URL을 제공합니다.	제거/초기화 `server.url` 생산 빌드에 대해 및 로컬 업데이트 패키지를 유지하세요.
`backend_refusal`	업데이터는 `v4`,	업그레이드 플러그인/CLI를 `v5`+ (prefer `v8`), Capacitor `v5`+, 그리고 다시 빌드하고 배포 메타데이터를 업데이트하세요.
구성 또는 정책 블록

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`	회사에 도달한 플랜/장치 한도
`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_*` 이후에 `set`	설치 단계가 완료되지 않았습니다.

런타임 / 플랫폼 이벤트

Code(s)	의미
`app_crash`, `app_crash_native`	자바스크립트 또는 네이티브 런타임层에서 발생한 충돌 이벤트. 스택, 소스 및 활성 버전 정보가 포함된 메타데이터가 종종 포함됩니다.
`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 참조 및 디버깅 가이드.

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

특정 로그 항목을 클릭하면 일반적으로 기기를 위한 페이지로 이동합니다. 이것은 특정 기기의 전체 기록을 볼 수 있게 해주며, 기기별 문제를 진단하거나 업데이트의 여정을 이해하는 데 매우 도움이 됩니다.로그에서 계속

제목 ‘로그에서 계속’

__CAPGO_KEEP_0__ Overview __CAPGO_KEEP_0__ API API API 구현 세부 정보에 대한 개요를 위해 소개 __CAPGO_KEEP_0__ 키에 대한 구현 세부 정보를 위해 API 키 API 키에 대한 구현 세부 정보를 위해 장치 __CAPGO_KEEP_0__ 구현 세부 정보에 대한 장치에 대해 번들 __CAPGO_KEEP_0__ 구현 세부 정보에 대한 번들에 대해