로그
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 설정 프롬프트 복사
로그 및 로그 인사이트
로그 및 로그 인사이트앱 로그 탭이 열립니다. 로그 인사이트 기본적으로 사용합니다. 인사이트를 사용하여 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을 열면 장치 수준의 증거를 확인하고 업데이트 경로를 문제 해결하고 장치가 __CAPGO_KEEP_0__와 어떻게 상호작용하는지 이해할 수 있습니다. 로그 로그 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이 재시작할 때까지 요청 제한으로 장치가 충돌 |
예제 로그 시나리오
제목 "예제 로그 시나리오"로그가 무엇을 말하는지 이해하기 위해, 실제 장치 업데이트여행을 보여주는 예시 시퀀스를 보겠습니다.
성공적인 업데이트로직
제목 "성공적인 업데이트로직"로그에 보이는 건강한 업데이트를 보겠습니다.
| 시간 | 기기 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 | 번들 설치 및 활성화 |
기기가 이미 최신 버전입니다.
기기 Already Up-to-Date장치가 최신 버전을 이미 가지고 있을 때:
| 시간 | 장치 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 | 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 | 채널은 min_update_version 메타데이터가 필요하고 앱이 더 오래된 경우 | 설정 min_update_version 새로운 native 버전에서 대상 번들 또는 릴리스를 선택하세요. |
disableAutoUpdateToMajor | 채널은 메이저 버전 업데이트를 차단합니다. | 이 트랙에 대해 메이저 버전 업데이트를 유지하거나 허용하세요. |
disableAutoUpdateToMinor | 채널은 마이너 버전 업데이트를 차단합니다. | 이 트랙에 대해 마이너 버전 업데이트를 유지하거나 허용하세요. |
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). | 해당 규칙 또는 더 간단한 자동 업데이트 모드로 Switch 하세요. |
missingBundle | 다운로드 가능한 파일이 없는 (없는 external_url/r2_path ) | 버전을 다시 빌드/업로드하고 버블이 실제 파일 내용을 가지고 있는지 확인하세요. |
NoChannelOrOverride | 이 장치에 해당하는 채널이 없습니다 (클라우드 기본값이 없으며 구성 fallback 및 override도 없습니다). | 설정판얼에 채널 기본값을 설정하거나 테스트 defaultChannel 에서 유지하세요. |
rateLimited | 짧은 시간에 너무 많은 업데이트/채널 호출 (일반적으로 render- setChannel/getChannel). | Stop render에서 호출하세요. 사용자 동작에만 호출하세요. defaultChannel app 및 버블 암호화 키 ID가 다릅니다 ( capacitor.config. |
keyMismatch | __CAPGO_KEEP_0__device_key_id vs bundle_key_id). | 콘솔에서 기기 및 번들 키 ID를 비교합니다. 키가 다르다면 동일한 키와 일치하는 CLI/플러그인 버전으로 배포합니다. 키 인코딩은 버전 간에 다를 수 있습니다. |
disableDevice | 실제 기기/태블릿이 차단되었습니다. 이 채널은 실기기/태블릿을 차단하도록 설정되어 있습니다. | 실제 기기/태블릿이 실수로 차단된 경우, 해당 채널에서 실기기/태블릿 업데이트를 켭니다. 의도적으로 차단된 경우, 차단을 유지하고 다른 채널로 실기기/태블릿을 라우팅합니다. |
disablePlatformElectron | 이 채널에서 이 전자 프로그램이 차단되어 있습니다. | 실수로 차단된 경우, 이 채널에서 전자 프로그램을 활성화하고 라우팅을 다시 배포합니다. 의도적으로 차단된 경우, 차단을 유지하고 전자 프로그램 사용자를 전용 채널로 보냅니다. |
customIdBlocked | 사용자 정의 기기 ID가 전송되었습니다. 그러나 이 앱은 사용자 정의 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 | 자바스크립트 또는 네이티브 런타임层에서 발생한 충돌 이벤트. 스택, 소스 및 활성 버전 정보가 포함된 메타데이터가 종종 포함됩니다. |
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 “로그에 대한 더 많은 정보를 얻기”특정 로그 항목을 클릭하면 일반적으로 기기의 페이지로 이동합니다. 이러한 기능을 통해 특정 기기의 전체 기록을 볼 수 있으며, 기기별 문제를 진단하거나 업데이트 여정을 이해하는 데 도움이 됩니다.로그에서 계속 진행하세요
로그에서 계속
로그를 계속 진행하는 방법Capgo를 사용 중이라면 로그 to plan dashboard and API operations, connect it with API와 연결하여 API 개요 __CAPGO_KEEP_0__ 개요의 구현 세부 정보 소개 API 키의 구현 세부 정보 for the implementation detail in API Keys, __CAPGO_KEEP_0__의 구현 세부 정보 소개 패키지 패키지 구현 세부 정보에 대한 설명입니다.