로그
설치
로그 및 로그 인사이트
로그 및 로그 인사이트 섹션앱 로그 로그 탭이 열립니다. 로그 인사이트 기본적으로 사용됩니다. 인사이트를 사용하여 카테고리, 버전 및 장치에 대한 1, 3, 7 또는 30일 기간을 우선순위로 지정할 수 있습니다. 필요할 때 underlying 장치 이벤트, 필터 및 타임스탬프를 설명하는 하위 탭으로 Switch합니다. 로그 로그 인사이트
애플리케이션 로그 이해
애플리케이션 로그 이해 섹션Capgo의 디바이스 수준 증거를 확인하고 업데이트 경로를 문제 해결하고 디바이스가 Capgo과 어떻게 상호 작용하는지 이해하기 위해 상세한 로그 히스토리와 디버그 정보를 제공하는 로그 subtab입니다. 로그페이지/영역: Capgo 빌더 / 네이티브 클라우드 빌드 제품 페이지. 역할: 짧은 UI 레이블 또는 네비게이션 아이템. seen in: 페이지 native-build.astro. 메시지 키 native_build_v2_trust_logs_lbl (네이티브 빌드 V2 Trust Logs Lbl). 로그 ,
Raw Logs tab
- 로그(subtab) 로그 subtab
- 다시로드 버튼 — 로그 목록을 최신 데이터로 갱신합니다.
- 시간 범위 및 동작 필터 — 시간과 동작으로 이벤트 스트림을 좁힙니다.
각 행은 다음과 같이 표시됩니다.
- 타임스탬프 (UTC)
- 기기 ID
- 동작 code (이벤트)
- 버전 이름 (번들 또는
builtin)
클릭하여 장치 세부 정보 페이지로 이동하세요. 그곳에서 전체 기록을 확인할 수 있습니다.
날짜 범위별 필터링
날짜 범위별 필터링 섹션날짜 범위별로 로그를 필터링하려면 날짜 선택기를 사용하세요:
- 빠른 설정 - 일반적인 시간 범위 선택: 1시간, 3시간, 6시간, 또는 12시간
- 시작 시간 - 사용자 지정 시작 시간을 설정하세요.
- 종료 시간 - 사용자 지정 종료 시간을 설정하세요.
- 일정 - 일정 선택을 위해 캘린더 뷰를 사용하세요.
선택한 날짜 범위를 적용하려면 '선택' 버튼을 클릭하거나, 로그 픽커를 취소하려면 '취소' 버튼을 클릭하세요.
작업 유형별 필터링
작업 유형별 필터링로그 필터링을 위해 Actions 드롭다운을 사용하세요.
Actions 필터
- 사용 가능한 작업 필터는 다음과 같습니다. 장치 심박수
- - 장치에서 주기적으로 건강 체크를 수행합니다. (심박수는 장치의 상태를 나타냅니다.) - 버전이 삭제될 때
- 기본 버전으로 초기화 - 기존 버전으로 돌아간 장치
- 버전이 성공적으로 설치되었습니다 - 성공적으로 패키지 설치
- 장치로 새로운 버전을 전송 - 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 | 액션 | 버전 | Version | 이것은 무엇을 의미합니까? |
|---|---|---|---|---|
| 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 | Bundle 설정이 완료되었습니다. |
| 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 | - | 이 장치는 업그레이드하거나 계정 요금이 다시 시작될 때까지 업데이트를 받지 못합니다. |
필요한 액션: 계획을 업그레이드하십시오. 또는 다음 요금 계산기 주기까지 기다리십시오.
채널 구성이 업데이트를 차단합니다.
Channel Configuration Blocking Updates업데이트를 차단하는 채널 설정이 있을 때:
| 시간 | 기기 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 API 열거형이 UI에서 새로운 API를 내뿜게 되면, 이는 __CAPGO_KEEP_1__ 또는 백엔드에서 발생한 후 이 목록에 유효한 것으로 검증된 코드입니다.capgo/src/types/supabase.types.tsUI에서 새로운 code를 발견하면, 이는 SDK 또는 백엔드에서 발생한 것으로 이 목록에 대해 검증된 것입니다.
__CAPGO_KEEP_0__(s)
| Code(s) | Meaning |
|---|---|
get | 기기에서 Capgo으로 채널에 연결된 번들을 요청했습니다. |
download_manifest_start, download_manifest_complete | zip 아카이브 다운로드가 시작/완료되었습니다 |
download_zip_start, download_zip_complete | __CAPGO_KEEP_0__ |
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은 봇 트래픽(구글/클라우드 인프라 IP)이 보이는 트래픽을 감지했습니다. | 실제 사용자에게는 무시하십시오; 실제 장치에서 다시 시도하거나 일반 네트워크에서 다시 시도하거나, 시간이 지나면 확인하십시오. |
needPlanUpgrade | 기업이 계획/장치 한계를 초과했습니다. | 설정판을 업그레이드하거나 다음 청구 주기까지 기다리십시오. |
semver_error | 설정된 네이티브 앱 버전이 없거나 유효하지 않은 semver (x.y.z). | Set plugins.CapacitorUpdater.version SemVer 테스터 에서 확인한 후 앱을 다시 빌드하십시오. 애플리케이션을 다시 빌드하세요. |
disablePlatformIos | 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 | 이 채널은 부 버전 업데이트를 차단합니다. | 이 트랙에서 부 버전 업데이트를 유지하거나 허용하세요. |
disableAutoUpdateToPatch | 이 채널은 이 흐름의 패치 수준 업데이트를 차단합니다. | 릴리스 일정과 일치하거나 이 트랙의 채널 정책에서 패치 업데이트를 열어주세요. |
disableEmulator | 이 채널에서는 에뮬레이터 업데이트를 허용하지 않습니다. | 이것이 실수로 발생한 경우, 에뮬레이터 업데이트를 허용하는 테스트 채널에서 에뮬레이터를 검증하세요. 만약 의도적으로 발생한 경우, 이 채널에서 에뮬레이터 업데이트를 차단하고 에뮬레이터 빌드를 위해 다른 채널을 사용하세요. |
disableDevBuild | 이 채널에서는 개발자 빌드를 차단합니다. | 이것이 실수로 발생한 경우, 개발자 업데이트를 허용하거나 이 장치를 개발자 빌드 허용 채널로 이동하세요. 만약 의도적으로 발생한 경우, 이 채널에서 릴리스 빌드만 허용하세요. |
disableProdBuild | 생산 모드에서 빌드된 장치 /updates채널이 그것을 차단한 동안 | 이것이 실수로 발생했다면, 해당 채널에서 프로덕션 업데이트를 허용하고 다시 게시하십시오. 만약 이것이 의도적이었다면, 제한을 유지하고 프로덕션 빌드를 올바른 채널/빌드로 보내십시오. |
cannotGetBundle | Capgo이 선택한 번들을 위한 유효한 다운로드 URL을 생성할 수 없습니다. | 번들을 다시 업로드 하십시오 (delta 파일이 포함되길 원하신다면) 및 R2/public 번들 설정을 확인하십시오. --delta 앱이 자체적으로 개인 채널로 switch하려고 시도했으나, 자체 assignment을 허용하지 않는 채널입니다. |
cannotUpdateViaPrivateChannel | 채널 또는 public/허용된 채널로 switch하십시오. | Enable allow_device_self_set Fill the missing config for that rule or switch to a simpler auto-update mode. |
channelMisconfigured | 번들이 다운로드 가능한 페이로드를 가지고 있지 않습니다 (missing) 및 delta 파일도 없습니다.version_number without min_update_version). | 룰에 대한 미완성 구성 정보를 채우거나 더 간단한 자동 업데이트 모드로 전환하세요. |
missingBundle | 채널 또는 public/허용된 채널로 switch하십시오. external_url/r2_path 번들을 다시 업로드 하십시오 (delta 파일이 포함되길 원하신다면) 및 R2/public 번들 설정을 확인하십시오. | 버전을 재구축/재업로드하고, 실제 파일 내용이 있는 번들을 확인하세요. |
NoChannelOrOverride | 이 기기와 일치하는 채널이 없습니다 (클라우드 기본값 + config fallback + override 없음). | 설정판얼에서 채널 기본값을 설정하거나 테스트를 계속하세요. defaultChannel 해당 빌드에서. |
rateLimited | 단기간에 너무 많은 업데이트/채널 호출이 발생했습니다 (일반적으로 렌더링 루프에서). setChannel/getChannel). | 렌더링 루프에서 호출하지 마세요. 사용자 동작 시에만 호출하세요. 사용자 동작 시에만 호출하세요. defaultChannel in capacitor.config. |
keyMismatch | vsdevice_key_id vs bundle_key_id). | In the console, compare device and bundle key IDs. If they differ, publish with the same key and matching CLI/plugin version; key encoding can differ between versions. |
disableDevice | 의도적으로 차단된 경우, 다른 채널로 실제 기기를 라우팅하세요. 실수로 차단된 경우, 실제 기기 업데이트를 켜세요. | 실수로 차단된 경우, 실제 기기 업데이트를 켜세요. 의도적으로 차단된 경우, 차단을 유지하고 다른 채널로 실제 기기를 라우팅하세요. |
disablePlatformElectron | 이 전자 앱은 이 채널에서 차단되어 있습니다. | 이것이 실수로 발생한 경우 이 채널에서 전자 앱을 활성화하고 다시 라우팅을 게시하세요. 만약 의도적으로 차단한 경우 전자 앱 사용자를 전용 채널로 보내세요. |
customIdBlocked | 사용자 지정 장치 ID가 전송되었습니다. 그러나 이 앱은 사용자 지정 ID를 받지 않습니다. | 사용자 지정 ID 전송을 끄거나 사용자 지정 ID를 활성화하세요. 만약 워크플로우가 사용자 지정 ID를 필요로 한다면. |
blocked_by_server_url | 이 앱은 server.url 이 앱이 구성되었습니다. 따라서 Capacitor은 로컬 파일 대신远程 URL을 제공합니다. | 제거/클리어 server.url 생산 빌드용으로 사용하고 업데이트 패키지를 로컬에 유지하세요. |
backend_refusal | 업데이터는 v4, 이 백엔드가 더 이상 수락하지 않습니다. | 플러그인/CLI을 v5+ (prefer v8), with Capacitor v5+, 그리고 __CAPGO_KEEP_0__을 재구성하고 다시 배포하세요. |
| 구성 또는 정책 블록 |
| Code(s) | 업데이트가 차단된 이유 |
|---|---|
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative | 채널 전략이 이 작업을 금지합니다. 버전 업그레이드 |
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_* without any subsequent set | 설치 단계가 완료되지 않았습니다. |
실행 시간 / 플랫폼 이벤트
Runtime / platform events| 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에 대한 더 깊은 안내가 필요하세요? Code 로그 전체 참조 및 디버깅 가이드.
로그에 대한 더 많은 정보를 얻기
제목 ‘로그에 대한 더 많은 정보를 얻기’특정 로그 항목을 클릭하면 일반적으로 장치 페이지로 이동합니다. 이것은 특정 장치의 전체 기록을 볼 수 있게 해주며 장치별 문제를 진단하거나 업데이트 경로를 이해하는 데 매우 유용합니다.로그에서 계속
제목 ‘로그에서 계속’
__CAPGO_KEEP_0__을 사용하여로그 context 로그 계획 대시보드와 API 작업을 연결하기 위해 API 개요 API Overview 소개 소개 API 키 API 키 장치 장치 패키지 패키지