ログ
このプラグインのインストール手順とフルマークダウンガイドを含む設定プロンプトをコピーする。
アプリケーションログの理解
「アプリケーションログの理解」のセクションログページは、アプリケーションの更新イベントの詳細な履歴と診断情報を提供します。これは、更新プロセスの監視、問題のトラブルシューティング、Capgoとデバイスの相互作用の理解に不可欠です。アクセスするには アプリをクリック そして 「ログ」タブ（以前は「更新」に名前が付けられていました。古いスクリーンショットやドキュメントでは）をクリック.
そこから、ログエントリの一覧を表示するページが表示されます。
ログページインターフェイスには以下の機能が含まれます。
- ログタブ - ログビューにアクセスするためのナビゲーションタブ
- リロードボタン - 最新データでログリストを更新
- 時刻範囲とアクションフィルタ - 日付範囲とアクションタイプでログをフィルタリング (以下のセクションを参照)
各行には以下の情報が表示されます。
- タイムスタンプ (UTC)
- デバイスID
- アクション code イベントログ
- __CAPGO_KEEP_0__ アーカイブ
builtin)
デバイス詳細ページにジャンプするには、行をクリックしてください。
日付範囲でフィルタリング
日付範囲でフィルタリング日付ピッカーを使用して、特定の時間帯でログをフィルタリングできます。
- - 最新1時間、3時間、6時間、または12時間の一般的な時間範囲を選択します。 開始時間
- __CAPGO_KEEP_0__ - __CAPGO_KEEP_0__のカスタム開始時間を設定します
- End Time - __CAPGO_KEEP_0__のカスタム終了時間を設定します
- Calendar - カレンダービューで特定の日付を選択します
Click “Select” to apply your chosen date range, or “Cancel” to dismiss the picker.
イベントタイプによるフィルタリング
イベントタイプによるフィルタリングThe Actions dropdown lets you filter logs by specific event types:
Available action filters include:
- デバイスの心拍 - デバイスから周期的に健康チェック
- バージョンの削除が要求されました - バンドルバージョンが削除されたとき
- デフォルトバージョンに戻す - デバイスがビルトインバンドルに戻ったとき
- バージョンのインストールが成功しました - バンドルのインストールが成功
- 新しいバージョンがデバイスに送信されました - Capgo がデバイスにアップデートを送信したとき
- バージョンのインストールが失敗しました - バンドルのインストールが失敗
上部の検索ボックスを使用して、特定のアクションタイプを迅速に検索できます。複数のアクションを選択して、選択したタイプのいずれかを含むログを表示できます。
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__| 時刻 (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 | builtin | デバイスがリクエスト制限に当たった; 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 | バンドルがインストールされ、有効化されました |
デバイスはすでに最新のバージョンです
「デバイスはすでに最新のバージョンです」というセクションデバイスが最新のバージョンを確認するときにすでに最新のバージョンである場合
| 時間 | __CAPGO_KEEP_0__ ID | __CAPGO_KEEP_1__ | __CAPGO_KEEP_2__ | __CAPGO_KEEP_3__ |
|---|---|---|---|---|
| 14:30:00 | e5f6g7h8 | noNew | 1.2.0 | __CAPGO_KEEP_4__ |
__CAPGO_KEEP_5__
__CAPGO_KEEP_6____CAPGO_KEEP_7__
| __CAPGO_KEEP_8__ | __CAPGO_KEEP_9__ | __CAPGO_KEEP_10__ | __CAPGO_KEEP_11__ | 何が起こっているか |
|---|---|---|---|---|
| 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 | __CAPGO_KEEP_0__ | デバイスがバンドルバージョンに戻されました |
アクションが必要です: アプリが正常に初期化された後、 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_KEEP_0__ バックエンド enum).
「ログコード (Capgo バックエンド enum)」というセクション
これらのコードは、ダッシュボードの Capgo () で使用されている enum から来ています。UI で新しい __CAPGO_KEEP_0__ を見た場合は、__CAPGO_KEEP_1__ またはバックエンドによって生成され、このリストに検証されました。 stats_action enum used by the dashboard 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.
意味
| Code(s) | ログコード (__CAPGO_KEEP_0__ バックエンド enum) |
|---|---|
get | デバイスが Capgo に対して現在のチャンネルマニフェストを要求しました |
download_manifest_start, download_manifest_complete | マニフェストのダウンロードが開始/終了しました (デルタまたはマルチファイルのバンドル) |
download_zip_start, download_zip_complete | Zip アーカイブのダウンロードが開始/終了しました |
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呼び出し経由で取得されました。 |
新しいポリシーブロック/スロットルクイックフィックス
「新しいポリシーブロック/スロットルクイックフィックス」セクション| Code | なぜこれが起こるのか | 次のステップは何ですか |
|---|---|---|
invalidIp | Capgoは、Google/クラウドインフラストラクチャIPのトラフィックが見られるように検知されました。 | 実ユーザーには無視してください; 実機と通常のネットワークから再試行するか、あるいは時間を置いて確認してください。 |
needPlanUpgrade | 組織はプラン/デバイスの制限に達しました。 | ダッシュボードでプランをアップグレードするか、次の請求サイクルを待ってください。 |
semver_error | config内のネイティブアプリバージョンが存在しない、または有効なsemverではありません(「x.y.z). | セット plugins.CapacitorUpdater.version __CAPGO_KEEP_0__ SemVer テスター __CAPGO_KEEP_1__ |
disablePlatformIos | iOS の有効化はチャネル ポリシーでブロックされています。 | このことは間違いだった場合、iOS をそのチャネルで有効にし、ルーティングを再公開してください。iOS を意図的にこのトラックでブロックした場合は、iOS ビルドを別のチャネルに移動してください。 |
disablePlatformAndroid | Android の有効化はチャネル ポリシーでブロックされています。 | このことは間違いだった場合、Android をそのチャネルで有効にし、ルーティングを再公開してください。Android を意図的にこのトラックでブロックした場合は、Android ビルドを別のチャネルに移動してください。 |
disableAutoUpdate | チャネル 自動更新モードでは、この更新スタイルをブロックしています。 | チャネル 自動更新ポリシー (メジャー/マイナー/パッチ/メタデータ/なし) を変更して、意図したロールアウトを許可してください。 |
disableAutoUpdateUnderNative | チャネルは、デバイスのベースラインよりも古い更新をブロックしています。 | デバイスのベースライン以上のバージョンをプッシュするか、下位の保護を無効にしてください。 |
disableAutoUpdateMetadata | __CAPGO_KEEP_2__ min_update_version __CAPGO_KEEP_0__ | セット min_update_version このバンドルまたはリリース用に、より新しいネイティブ版から設定します。 |
disableAutoUpdateToMajor | このチャンネルでは、メジャーバージョンジャンプがブロックされています。 | このトラックの場合、メジャーバージョンを同じチャンネー戦略で維持するか、メジャージャンプを許可します。 |
disableAutoUpdateToMinor | このチャンネルでは、マイナーバージョンジャンプがブロックされています。 | このトラックの場合、マイナーバージョンを同じチャンネー戦略で維持するか、マイナージャンプを許可します。 |
disableAutoUpdateToPatch | このフローでは、このチャンネルではパッチレベルジャンプがブロックされています。 | リリースのペースを合わせるか、このトラックのチャンネルポリシーでパッチジャンプを開放します。 |
disableEmulator | このチャンネルでは、エミュレータの更新が許可されていません。 | この更新は間違いだった場合、エミュレータの更新を有効にして、エミュレータを検証するテストチャンネルでテストしてください。意図的だった場合は、このチャンネルでエミュレータをブロックし、エミュレータビルド用に別のチャンネルを使用してください。 |
disableDevBuild | このチャンネルでは、Devビルドがブロックされています。 | この操作は間違いだった場合、開発者用の更新を許可するか、このデバイスを開発者用のチャネルに移動してください。 これは意図的だった場合、リリースビルドのみにこのチャネルをロックしてください。 |
disableProdBuild | 生産モードで作成されたデバイス /updates、あなたのチャネルがブロックした | この操作は間違いだった場合、そのチャネルで生産用の更新を許可し、再発行してください。 これは意図的だった場合、制限を維持し、適切なチャネル/ビルドに生産用のビルドを送信してください。 |
cannotGetBundle | Capgo が選択したバンドルに対して有効なダウンロード URL を作成できませんでした。 | バンドルを再アップロードするか、manifest を再生成し、R2/public バンドル設定を確認してください。 |
cannotUpdateViaPrivateChannel | アプリがプライベートチャネルに自ら切り替えようとしたが、そのチャネルは自我割り当てを許可していません。 | 有効 allow_device_self_set チャネルまたはパブリック/許可されたチャネルに切り替えてください。 |
channelMisconfigured | チャネル自動更新ルールが必要なデータを欠いています (version_number なし min_update_version). | そのルールの欠落した設定を埋めてください、または自動更新モードを簡素化してください。 |
missingBundle | ダウンロード可能なペイロードが存在しません (存在しない external_url/r2_path バージョンを再構築/アップロードし、実際のファイル内容を持つバンドルが存在することを確認してください。 | このデバイスに該当するチャネルが存在しません (クラウドのデフォルトが設定されていない + 設定のフォールバックが設定されていない + オーバーライドが設定されていない). |
NoChannelOrOverride | デフォルトのチャネルをダッシュボードで設定するか、テスト | このビルドに保持してください。 defaultChannel 短時間内に多数のアップデート/チャネル呼び出しが発生しています (通常はレンダリング |
rateLimited | 呼び出しを停止してください。ユーザーがアクションを実行するときにのみ呼び出してください。 setChannel/getChannel). | in defaultChannel アプリとバンドルの暗号化キーIDが異なります ( capacitor.config. |
keyMismatch | vsdevice_key_id コンソールで、デバイスとバンドルのキーIDを比較してください。異なる場合、同じキーと一致する __CAPGO_KEEP_0__/プラグインバージョンで公開してください; キーはバージョン間でエンコード方法が異なる可能性があります。 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 | このチャンネルではElectronがブロックされています。 | もし間違ってしまった場合は、このチャンネルでElectronを有効にしてルーティングを再公開してください。もし意図的にブロックした場合は、ブロックを維持し、Electronユーザーを専用のチャンネルに送信してください。 |
customIdBlocked | カスタムデバイスIDが送信されましたが、このアプリはカスタムIDを受け付けていません。 | カスタムIDの送信をオフにしたり、カスタムIDを有効にする場合は、ワークフローがそれを必要とする場合にのみ有効にしてください。 |
blocked_by_server_url | このアプリは server.url で構成されています。したがって、CapacitorはローカルファイルではなくリモートURLを提供します。 | 削除/クリア server.url を実行して、プロダクションビルド用に更新パッケージをローカルに保持してください。 |
backend_refusal | アップデータは v4、ですが、バックエンドはそれを受け付けなくなっています。 | プラグイン/CLIをアップグレード v5+ (推奨 v8)でCapacitor v5+、次にbundleメタデータを再構築して再公開 |
| 設定またはポリシーブロック |
| 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 | 組織はプラン/デバイスの制限に達しました。 |
rateLimited | SDKはリスタートまでスロットルします。リクエストが多すぎます。 |
blocked_by_server_url, backend_refusal, invalidIp | サーバーサイドのルールがリクエストをブロックしました。 |
ダウンロード/整合性/インストールの失敗
| 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_* __CAPGO_KEEP_0__(s)と共に set | ダウンロードが完了しましたが、インストールフェーズが完了しませんでした |
実行時/プラットフォームイベント
「実行時/プラットフォームイベント」セクション| Code(s)の意味 | JavaScriptまたはネイティブ実行時レイヤーからクラッシュイベント。メタデータにはスタック、ソース、有効なバージョン情報が含まれます。 |
|---|---|
app_crash, app_crash_native | Androidはアプリケーションが応答していないことを報告しました |
app_anr | 実行時/プラットフォームイベント |
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 | WebViewライフサイクルとJS/レンダリングエラー。JSとネイティブレイヤー両方にSentryをインストールして、スタックトレース、セッション/デバイスコンテキスト、URL/状態をキャプチャし、より速い修正を実現します。 |
os_version_changed, native_app_version_changed | OSまたはネイティブアプリのバージョンが変更されました。この機能は、プラットフォームレベルのロールアウト効果とウェブバンドルの動作を区別するのに役立ちます。 |
➡️ code に関するより深いガイダンスが必要ですか？ Code のフルログ参照とデバッグガイド.
ログの詳細についてもっと知りたい
「ログの詳細についてもっと知りたい」のセクション特定のログエントリをクリックすると、通常、デバイスのページに移動します。 この機能により、特定のデバイスの全履歴を確認できます。これは、デバイス固有の問題を診断したり、その更新履歴を理解したりするのに非常に役立ちます。ログから続けて
__CAPGO_KEEP_0__
ログから続ける__CAPGO_KEEP_0__を使用している場合 ログ APIと連携して、ダッシュボードとAPIの操作を計画する APIの概要 APIの概要の実装詳細については、APIの概要を参照してください 導入 導入の実装詳細については、導入を参照してください APIのキー APIのキーについての実装詳細については、APIのキーを参照してください デバイス デバイスの実装詳細については、デバイスを参照してください バンドル バンドルの実装詳細について