로그
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 설정 프롬프트 복사
로그 및 로그 인사이트
로그 및 로그 인사이트 섹션앱 로그 탭이 열립니다 로그 인사이트 기본적으로 사용합니다. 인사이트를 사용하여 카테고리, 버전, 장치에 대한 1, 3, 7, 또는 30일 기간을 우선순위로 지정합니다. 로그 로그 subtab을 열면 디바이스 이벤트, 필터, 타임스탬프와 같은 하위 항목을 아래에 설명합니다.
애플리케이션 로그 이해
애플리케이션 로그 이해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 로그, 로그 subtab. 로그
원본 로그 인터페이스는 다음과 같습니다.
- 로그 서브 탭 — 로그 행별 탐색 제어.
- 재로드 버튼 — 로그 목록을 최신 데이터로 갱신합니다.
- 시간 범위 및 액션 필터 — 시간과 액션으로 이벤트 스트림을 좁힙니다.
각 행은 다음과 같습니다.
- 타임스탬프 (UTC)
- 기기 ID
- code (이벤트)
- 버전 이름 (번들 또는)
builtin)
기기 로그의 전체 기록을 보려면 기기 상세 페이지로 이동하세요.
날짜 범위에 따라 로그 필터링
날짜 범위에 따라 로그 필터링날짜 범위에 따라 로그를 필터링하려면 날짜 선택기를 사용하세요.
- 빠른 설정 - 1시간, 3시간, 6시간, 12시간 중 선택
- 시작 시간 - 사용자 지정 시작 시간을 설정
- 종료 시간 - 사용자 지정 종료 시간을 설정
- 달력 - 달력 보기에서 특정 날짜를 선택
선택 버튼을 클릭하여 선택한 날짜 범위를 적용하거나, 취소 버튼을 클릭하여 선택기 취소
행동 유형에 따라 필터링
행동 유형에 따라 필터링하는 섹션액션 드롭다운은 특정 이벤트 유형에 따라 로그를 필터링할 수 있습니다:
사용 가능한 액션 필터은 다음과 같습니다.
- 디바이스 하트 비트 - 디바이스에서 주기적으로 건강 체크
- 버전 삭제 요청 - 버전 삭제 요청 시
- 기본 버전으로 되돌리기 - 디바이스가 기본 빌드 버전으로 되돌았을 때
- 버전 설치 성공 - 빌드 버전 설치 성공 시
- 새로운 버전 전송 - 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 | 다운로드 패키지 설치 및 다음으로 실행할 준비 |
| 2025-01-14 10:05:00 | B9C8D7 | disableAutoUpdateToMajor | 1.9.0 | 채널 정책으로 2.x로의 점프를 차단 |
| 2025-01-14 10:05:05 | B9C8D7 | rateLimited | 내장 | SDK이 재시작할 때까지 요청 제한에 걸린 기기 |
성공적인 업데이트 흐름
로그에서 건강한 업데이트를 어떻게 나타나는지 보여줍니다.
다운로드 패키지 설치 및 다음으로 실행할 준비채널 정책으로 2.x로의 점프를 차단
| 시간 | 기기 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 | 장치가 내장 버전으로 되돌아갔습니다. | 액션 필요 |
: 앱이 호출되는지 확인하세요.: 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 로그 코드
Capgo 로그 코드 섹션__CAPGO_KEEP_0__ 로그 코드는 __CAPGO_KEEP_0__ ( stats_action 이 로그 코드는 UI에서 새로 보이는 __CAPGO_KEEP_1__ 또는 API 로그 코드가 백엔드에서 발생했으며 이 목록에 유효한지 검증했습니다.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 | 압축 파일 다운로드가 시작/완료되었습니다. |
download_10 … download_90 | 다운로드 진행률 마일스톤 |
download_0 | 다운로드 진행률 0% |
download_complete | 전체 번들이 다운로드되었습니다. |
set | 다음 런칭에 대비하여 번들이 준비되었습니다. |
reset | 기본 번들로 되돌아갔습니다. |
delete | 지역 저장소에서 번들이 삭제되었습니다. |
uninstall | 앱이 해제되었습니다. |
app_moved_to_foreground, app_moved_to_background | App lifecycle events recorded by SDK |
ping | 기기에서 건강/하트비트 체크 |
setChannel, getChannel | SDK를 통해 채널이 overridden되거나 fetched됩니다. |
새 정책-차단/압박 빠른 수정
제목: "새 정책-차단/압박 빠른 수정"| Code | 왜 이런 일이 발생하는지 | 다음 단계는 무엇입니까? |
|---|---|---|
invalidIp | Capgo는 봇 트래픽과 같은 트래픽을 감지했습니다 (Google/클라우드 인프라스트럭처 IP). | 실제 사용자에 대해 무시하십시오; 실제 장치와 일반 네트워크에서 다시 시도하거나 시간이 지나면 확인하십시오. |
needPlanUpgrade | 기업이 계획/장치 한계를 달성했습니다. | 대시보드에서 계획을 업그레이드하거나 다음 청구 주기까지 기다리십시오. |
semver_error | 설정에서 Native 앱 버전이 없거나 semver 형식이 올바르지 않습니다 (x.y.z). | 설정 plugins.CapacitorUpdater.version 유효한 semver 형식으로 설정하고 SemVer 테스터 에서 확인하고 앱을 다시 빌드하세요. |
disablePlatformIos | iOS는 채널 정책에서 비활성화되어 있습니다. | 이것이 실수로 발생한 경우, iOS를 활성화하고 라우팅을 다시 게시하세요. 만약에 의도적으로 iOS를 이 트랙에서 차단했다면, 계속해서 이 트랙에서 iOS 빌드를 차단하고 iOS 빌드를 별도의 채널로 이동하세요. |
disablePlatformAndroid | Android는 채널 정책에서 비활성화되어 있습니다. | 이것이 실수로 발생한 경우, Android를 활성화하고 라우팅을 다시 게시하세요. 만약에 의도적으로 Android를 이 트랙에서 차단했다면, 계속해서 이 트랙에서 Android 빌드를 차단하고 Android 빌드를 별도의 채널로 이동하세요. |
disableAutoUpdate | 채널 자동 업데이트 모드는 이 업데이트 스타일을 차단합니다. | 채널 자동 업데이트 정책을 변경하세요 (major/minor/patch/metadata/none)로 원하는 롤아웃을 허용하세요. |
disableAutoUpdateUnderNative | 채널은 기기 기준선보다 이전 버전의 업데이트를 차단합니다. | native 버전 기준 이하의 버전을 푸시하거나, native 기준 이하의 보호를 비활성화하세요. |
disableAutoUpdateMetadata | Channel은 min_update_version metadata와 앱이 더 오래된 경우 | 설정 min_update_version 새로운 native 버전에서 대상 버블 또는 릴리스를 위해 |
disableAutoUpdateToMajor | Channel은 주요 버전 업데이트를 차단합니다. | 이 트랙에 대해 주요 버전 업데이트를 허용하거나, 동일한 Channel 전략에서 주요 버전을 유지하세요. |
disableAutoUpdateToMinor | Channel은 이 트랙에 대해 부 버전 업데이트를 차단합니다. | 이 트랙에 대해 부 버전 업데이트를 허용하거나, 동일한 Channel 전략에서 부 버전을 유지하세요. |
disableAutoUpdateToPatch | 이 흐름에 대해 패치 수준 업데이트를 차단합니다. | 릴리스 주기와 일치하거나, 이 트랙에 대한 Channel 정책에서 패치 수준 업데이트를 열어주세요. |
disableEmulator | 이 채널에 대해 에뮬레이터 업데이트를 허용하지 않습니다. | 이것이 실수로 발생했다면, 테스트 채널에서 에뮬레이터를 검증하는 동안 에뮬레이터 업데이트를 활성화하세요. 의도적으로 발생했다면, 이 채널의 에뮬레이터를 차단하고 다른 채널에서 에뮬레이터 빌드를 사용하세요. |
disableDevBuild | 이 채널에서 개발자 빌드는 차단되어 있습니다. | 이것이 실수로 발생했다면, 개발자 업데이트를 허용하거나 이 기기를 개발자 채널을 활성화한 채널로 이동하세요. 의도적으로 발생했다면, 이 채널을 릴리스 빌드만 허용하도록 유지하세요. |
disableProdBuild | 생산 모드에서 생성된 기기 빌드 /updates, 채널이 이를 차단한 동안. | 이것이 실수로 발생했다면, 해당 채널에서 생산 업데이트를 허용하고 다시 게시하세요. 의도적으로 발생했다면, 제한을 유지하고 올바른 채널/빌드로 생산 빌드를 전송하세요. |
cannotGetBundle | Capgo이 선택한 번들을 위해 유효한 다운로드 URL을 빌드할 수 없습니다. | 번들을 다시 업로드하거나 매니페스트를 재생성하고 R2/public 번들을 설정하세요. |
cannotUpdateViaPrivateChannel | 앱이 자체 Switch를 시도하여 자체 assign을 허용하지 않는 비공개 채널로 이동했습니다. | 활성화 allow_device_self_set 채널 |
channelMisconfigured | 채널 자동 업데이트 규칙이 필요한 데이터가 누락되어 있습니다. (version_number without min_update_version). | Fill the missing config for that rule or switch to a simpler auto-update mode. |
missingBundle | Bundle has no downloadable payload (missing external_url/r2_path and no manifest). | Rebuild/re-upload the version and verify the bundle has real file content. |
NoChannelOrOverride | No channel matched this device (no cloud default + no config fallback + no override). | Set a channel default in dashboard or keep a test defaultChannel in that build. |
rateLimited | Too many update/channel calls in a short time (often render-loop setChannel/getChannel). | Stop calling in render. Only call on user action. Use defaultChannel in capacitor.config. |
keyMismatch | The app and bundle encryption key IDs differ (device_key_id vs bundle_key_id). | 콘솔에서 기기 및 번들 키 ID를 비교합니다. 키가 다르면 동일한 키와 일치하는 CLI/플러그인 버전으로 배포합니다. 키 인코딩은 버전 간에 다를 수 있습니다. |
disableDevice | 실제 휴대폰/태블릿이 차단되었습니다. 이 채널은 실장기기를 차단하도록 설정되어 있습니다. | 이것이 실수로 발생한 경우, 해당 채널에서 실장기기 업데이트를 활성화하세요. 의도적으로 차단한 경우, 차단을 유지하고 다른 채널로 실장기기를 라우팅하세요. |
disablePlatformElectron | 이 채널에서 이เลクト론이 차단되어 있습니다. | 이것이 실수로 발생한 경우, 이 채널에서 이레크론을 활성화하고 라우팅을 다시 배포하세요. 의도적으로 차단한 경우, 차단을 유지하고 이레크론 사용자를 전용 채널로 보냅니다. |
customIdBlocked | 사용자 정의 기기 ID가 전송되었습니다. 그러나 이 앱은 사용자 정의 ID를 받지 않습니다. | 사용자 정의 ID 전송을 끄거나, 사용자 정의 ID를 사용하는 경우에만 사용자 워크플로우가 필요합니다. |
blocked_by_server_url | 이 앱은 server.url 설정되어 있으므로 Capacitor은 원격 URL 대신 로컬 파일을 제공합니다. | 제거/클리어 server.url 생산 빌드에 대해 및 업데이트 패키지를 로컬로 유지하세요. |
backend_refusal | 업데이터는 v4이 업데이터는 백엔드가 더 이상 수락하지 않습니다. | 플러그인/CLI을 v5(업데이트를 v8), with Capacitor v5__CAPGO_KEEP_0__ |
| +로 업데이트하고 다시 빌드하고 배포 메타데이터를 다시 배포하세요. |
| Code(s) | __CAPGO_KEEP_0__(s) |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | 업데이트가 차단된 이유는 채널 전략이 이 |
disablePlatformIos, disablePlatformAndroid | semver 점프를 금지합니다. |
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(); 롤백이 트리거되었습니다. |
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/렌더링 오류. JS 및 네이티브层에서 Sentry를 설치하여 스택 추적, 세션/기기 컨텍스트 및 URL/상태를 캡처하여 더 빠른 수정을 위해. |
os_version_changed, native_app_version_changed | OS 또는 네이티브 앱 버전이 변경되었습니다. 이 기능은 웹 번들 동작과 플랫폼 수준 롤아웃 효과를 분리하는 데 도움이 됩니다. |
➡️ 더 깊은 code 지침이 필요합니까? Full Log Code Reference and Debugging Guide.
로그에 대한 더 많은 정보를 얻기
Section titled “로그에 대한 더 많은 정보를 얻기”특정 로그 항목을 클릭하면 일반적으로 기기의 페이지로 이동합니다. 이러한 기능은 특정 기기의 전체 기록을 볼 수 있게 해주며, 기기별 문제를 진단하거나 업데이트 여정을 이해하는 데 매우 유용합니다.로그에서 계속 진행하세요
Keep going from Logs
로그를 계속 진행하는 방법Capgo를 사용 중이라면 로그 to plan dashboard and API operations, connect it with API와 연결 API 개요 __CAPGO_KEEP_0__ 개요의 구현 세부 정보 소개 API 키 API 키의 구현 세부 정보 디바이스 디바이스의 구현 세부 정보 패키지 패키지 구현 세부 사항에 대한 정보입니다.