로그
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사합니다.
로그 및 로그 인사이트
로그 및 로그 인사이트앱 로그 탭이 열립니다. 로그 인사이트 기본적으로 사용합니다. 인사이트를 사용하여 카테고리, 버전, 기기 및 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시간 중 선택
- 시작 시간 - 사용자 지정 시작 시간을 설정
- 종료 시간 - 사용자 지정 종료 시간을 설정
- 달력 - 달력 보기에서 특정 날짜를 선택
선택
을 클릭하여 선택한 날짜 범위를 적용하거나
를 클릭하여 선택기 취소행동 유형으로 필터링
사용 가능한 액션 필터는 다음과 같습니다:
- Device heartbeat - 장치에서 주기적으로 진행되는 건강 체크
- Version deletion requested - 버전 삭제 요청
- Reset to default version - 장치가 기본 버전으로 되돌아감
- Version installed successfully - 버전 설치 성공
- New version sent to device - 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이 재시작할 때까지 요청 제한에 걸린 기기 |
예제 로그 시나리오
제목 ‘예제 로그 시나리오’로그가 무엇을 말하는지 이해하기 위해, 실제 기기 업데이트여행을 보여주는 예제 시퀀스를 보겠습니다.
성공적인 업데이트 흐름
제목 ‘성공적인 업데이트 흐름’로그에 보이는 건강한 업데이트가 무엇인지 보여드리겠습니다.
| 시간 | 기기 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__ ( 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.
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를 통해 채널 override 또는 fetch |
새 정책 차단 / 속도 제한 빠른 수정
새 정책 차단 / 속도 제한 빠른 수정| Code | 이게 왜 일어나는지 | 다음 단계 |
|---|---|---|
invalidIp | Capgo는 봇 트래픽과 같은 트래픽을 감지했습니다 (Google/클라우드 인프라 IP). | 실제 사용자에게 무시; 실제 장치 및 일반 네트워크에서 다시 시도하거나 시간이 지나면 확인하십시오. |
needPlanUpgrade | 기업이 계획/장치 제한을 초과했습니다. | 대시보드에서 계획을 업그레이드하거나 다음 청구 주기까지 기다리십시오. |
semver_error | 설정에서 Native 앱 버전이 없거나 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)하여 의도한 롤아웃을 허용하세요. |
disableAutoUpdateUnderNative | 채널은 기기 기준선보다 이전 버전의 업데이트를 차단합니다. | native 버전 기준 이하의 버전을 푸시하거나, native 보다 낮은 보호를 비활성화하세요. |
disableAutoUpdateMetadata | Channel은 min_update_version metadata와 앱이 더 오래된 경우 | 설정 min_update_version 새로운 native 버전에서 대상 버블 또는 릴리스를 위해 |
disableAutoUpdateToMajor | Channel은 메이저 버전 업데이트를 차단합니다. | 이 트랙에 대해 메이저 버전 업데이트를 허용하거나, 동일한 채널 전략에서 메이저 버전을 유지하세요. |
disableAutoUpdateToMinor | Channel은 이 트랙에 대해 마이너 버전 업데이트를 차단합니다. | 이 트랙에 대해 마이너 버전 업데이트를 허용하거나, 동일한 채널 전략에서 마이너 버전을 유지하세요. |
disableAutoUpdateToPatch | 이 흐름에 대해 패치 레벨 업데이트를 차단합니다. | 릴리스 주기와 일치하거나, 이 트랙에 대한 채널 정책에서 패치 레벨 업데이트를 열어주세요. |
disableEmulator | 이 채널에 대한 에뮬레이터 업데이트를 허용하지 않습니다. | 이것이 실수로 발생한 경우, 에뮬레이터 업데이트를 테스트 채널에서 활성화하고 에뮬레이터를 검증하세요. 만약 의도적으로 발생한 경우, 이 채널의 에뮬레이터를 차단하고 다른 채널에서 에뮬레이터 빌드를 사용하세요. |
disableDevBuild | 이 채널에서 개발 빌드는 차단되어 있습니다. | 이것이 실수로 발생한 경우, 개발 업데이트를 허용하거나 이 기기를 개발 채널로 이동하세요. 만약 의도적으로 발생한 경우, 이 채널을 개발 빌드만 허용하도록 유지하세요. |
disableProdBuild | 생산 모드에서 생성된 기기 빌드 /updates, 채널이 이를 차단하고 있습니다. | 이것이 실수로 발생한 경우, 해당 채널에서 생산 업데이트를 허용하고 다시 게시하세요. 만약 의도적으로 발생한 경우, 제한을 유지하고 올바른 채널/빌드로 생산 빌드를 전송하세요. |
cannotGetBundle | Capgo는 선택한 번들을 위해 유효한 다운로드 URL을 빌드할 수 없습니다. | 번들을 다시 업로드하거나 매니페스트를 재생성하고 R2/public 번들을 확인하세요. |
cannotUpdateViaPrivateChannel | 앱이 자체 Switch를 시도하여 자체 assign을 허용하지 않는 비공개 채널로 이동했습니다. | 채널 또는 Switch를 허용된 공용 채널로 이동하세요. allow_device_self_set 채널 자동 업데이트 규칙이 필요한 데이터가 누락되어 있습니다 ( |
channelMisconfigured | Channel auto-update rule is missing required data (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), 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 | 회사에 대한 계획/기기 제한이 발생했습니다. |
다운로드/인TEGRITY/설치 실패
| 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(); 롤백이 트리거되었습니다. |
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.
로그에 대한 더 많은 정보를 얻기
제목 ‘로그에 대한 더 많은 정보를 얻기’특정 로그 항목을 클릭하면 일반적으로 기기의 페이지로 이동합니다. 이러한 기능을 통해 특정 기기의 전체 기록을 볼 수 있으며, 이는 기기별 문제를 진단하거나 업데이트 여정을 이해하는 데 매우 도움이 됩니다.로그에서 계속 진행하세요
로그에서 계속
로그를 계속 진행하는 방법Capgo를 사용 중이라면 로그 to plan dashboard and API operations, connect it with API와 연결하여 API 개요 __CAPGO_KEEP_0__ 개요에서 구현 세부 정보를 참조하십시오. 소개 API 키 API 키에서 구현 세부 정보를 참조하십시오. 디바이스 디바이스에서 구현 세부 정보를 참조하십시오. 패키지 패키지 구현 세부 사항에 대한 정보입니다.