로그
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 프롬프트를 복사합니다.
로그 및 로그 인사이트
로그 및 로그 인사이트앱 로그 탭을 열어줍니다. 로그 인사이트 기본적으로 사용하세요. 인사이트를 사용하여 카테고리, 버전, 기기 등 1, 3, 7, 또는 30일 기간으로 우선순위를 지정하세요. 로그 페이지/영역: Capgo 빌더 / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보는 곳: 페이지 native-build.astro. 메시지 키 `native_build_v2_trust_logs_lbl` (네이티브 빌드 V2 신뢰 로그 레이블).
하위 탭을 열면 디바이스 이벤트, 필터, 타임스탬프와 같은 하위 항목을 설명하는 내용이 나옵니다.
애플리케이션 로그 이해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 로그 하위 탭은 애플리케이션의 업데이트 이벤트와 진단 정보를 포함한 상세한 로그 히스토리를 제공합니다. 업데이트 경로를 문제 해결하거나 디바이스와의 상호작용을 이해하는 데 유용합니다. 앱을 열고 로그 페이지/영역: Capgo 빌더 / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. 보는 곳: 페이지 native-build.astro. 메시지 키 `native_build_v2_trust_logs_lbl` (네이티브 빌드 V2 신뢰 로그 레이블). , 그런 다음 하위 탭을 선택하세요.
원본 로그 인터페이스는 다음과 같습니다:
- 로그 서브 탭 — 로그 행별 탐색 제어.
- 재로드 버튼 — 로그 목록을 최신 데이터로 갱신합니다.
- 시간 범위 및 동작 필터 — 시간과 동작으로 이벤트 스트림을 좁힙니다.
각 행은 다음과 같습니다:
- 타임스탬프 (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은 재시작할 때까지 백오프합니다. |
예제 로그 시나리오
제목 "예제 로그 시나리오"로그가 무엇을 말하는지 이해하기 위해, 실제 장치 업데이트여행을 보여주는 예제 시퀀스를 보겠습니다.
성공적인 업데이트 흐름
제목 "성공적인 업데이트 흐름"로그에 보이는 건강한 업데이트가 무엇인지 보여드리겠습니다.
| 시간 | 기기 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 | __CAPGO_KEEP_0__ |
| 12:05:00 | y5z6a7b8 | disableEmulator | 1.2.0 | __CAPGO_KEEP_0__ |
| 12:10:00 | c9d0e1f2 | disableDevBuild | 1.2.0 | __CAPGO_KEEP_0__ |
__CAPGO_KEEP_0____CAPGO_KEEP_0__ __CAPGO_KEEP_0__.
Capgo
Capgo__CAPGO_KEEP_0__ stats_action APIcapgo/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.
__CAPGO_KEEP_0__
| 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 빌드를 별도의 채널로 이동하세요. |
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 | 이 채널에 대해 에뮬레이터 업데이트를 허용하지 않습니다. | metadata |
disableEmulator | app | 이것이 실수로 발생했다면, 테스트 채널에서 에뮬레이터를 검증하는 동안 에뮬레이터 업데이트를 활성화하세요. 의도적으로 발생했다면, 이 채널의 에뮬레이터를 차단하고 에뮬레이터 빌드를 위해 다른 채널을 사용하세요. |
disableDevBuild | 이 채널에서는 개발자 빌드가 차단되어 있습니다. | 이것이 실수로 발생했다면, 개발자 업데이트를 허용하거나 이 기기를 개발자 채널을 활성화한 채널로 이동하세요. 의도적으로 발생했다면, 이 채널을 릴리스 빌드만 허용하도록 유지하세요. |
disableProdBuild | 생산 모드에서 생성된 기기 빌드 /updates, 채널이 이를 차단하고 있습니다. | 이것이 실수로 발생했다면, 해당 채널에서 생산 업데이트를 허용하고 다시 게시하세요. 의도적으로 발생했다면, 제한을 유지하고 올바른 채널/빌드로 생산 빌드를 전송하세요. |
cannotGetBundle | Capgo는 선택한 번들을 위해 유효한 다운로드 URL을 빌드할 수 없습니다. | 번들을 다시 업로드하거나 매니페스트를 재생성하고 R2/public 번들 설정을 확인하세요. |
cannotUpdateViaPrivateChannel | 앱이 자체 Switch를 시도하여 자체 assign을 허용하지 않는 비공개 채널로 이동했습니다. | 활성화 allow_device_self_set 채널 |
channelMisconfigured | 채널 자동 업데이트 규칙이 필요한 데이터가 누락되어 있습니다 (version_number without min_update_version). | 해당 규칙 또는 단순한 자동 업데이트 모드로 Switch 하세요. |
missingBundle | Bundle은 다운로드 가능한 페이로드가 없으며 (없는 external_url/r2_path missing | ) |
NoChannelOrOverride | manifest도 없습니다. | 버전을 다시 빌드/업로드하고 Bundle이 실제 파일 내용을 가지고 있는지 확인하세요. defaultChannel 이 장치에 해당하는 채널이 없습니다 (클라우드 기본값이 없으며 구성 fallback도 없으며 override도 없습니다). |
rateLimited | 설정판얼에 채널 기본값을 설정하거나 테스트를 유지하세요. setChannel/getChannel). | 이 빌드에. defaultChannel 짧은 시간 내에 너무 많은 업데이트/채널 호출이 있습니다 (일반적으로 render-loop) capacitor.config. |
keyMismatch | Stop calling in render. Only call on user action. Use __CAPGO_KEEP_0__ in __CAPGO_KEEP_1__ instead. 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+ (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 | 회사에 대한 계획/기기 제한이 발생했습니다. |
다운로드/정합성/설치 실패
| 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/렌더링 오류. 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 Builder에서 로그를 사용 중이라면 로그 로그를 사용하여 대시보드와 API 운영을 계획하고 연결하세요. API 개요 API 개요에서 구현 세부 정보를 참조하세요. 소개 __CAPGO_KEEP_0__ 키 API 키에서 구현 세부 정보를 참조하세요. for the implementation detail in API Keys, 디바이스에서 구현 세부 정보를 참조하세요. __CAPGO_KEEP_0__ 패키지 패키지 구현 세부 사항에 대한 정보입니다.