ログ
__CAPGO_KEEP_0__
Understanding Application Logs
Section titled “Understanding Application Logs”The Logs page provides a detailed history of update events and diagnostic information for your application. This is crucial for monitoring the update process, troubleshooting issues, and understanding how your devices interact with Capgo. You can access it by clicking on your app and then clicking on the “Logs” tab (previously named “updates” in some older screenshots or documentation).
From there you should see a page similar to this, displaying a list of log entries:
The logs page interface includes:
- Logs Tab - The navigation tab to access the logs view
- 再読ボタン - 最新データでログリストを更新します
- 時間範囲 & アクションフィルタ - 日付範囲とアクションタイプでログをフィルタリングします (以下のセクションを参照)
各行は次の情報を表示します
- タイムスタンプ (UTC)
- デバイスID
- アクション code (発生したイベント)
- バージョン名 (バンドルまたは
builtin)
行をクリックすると、デバイスの詳細ページにフル履歴が表示されます。
日付範囲でフィルタリング
「日付範囲でフィルタリング」のセクション日付ピッカーを使用して、特定の時間帯でログをフィルタリングできます。
- クイックプリセット - 最新1時間、3時間、6時間、または12時間の一般的な時間範囲を選択
- 開始時間 - カスタムの開始時間を範囲に設定
- 終了時間 - カスタムの終了時間を範囲に設定
- カレンダー - カレンダー画面で特定の日付を選択します
選択した日付範囲を適用するには「Select」をクリック、またはログピッカーを閉じるには「Cancel」をクリック。
アクションタイプによるフィルタリング
「アクションタイプによるフィルタリング」のセクションアクションのドロップダウンメニューは、ログを特定のイベントタイプでフィルタリングするのに役立ちます:
利用可能なアクションフィルタには次のものがあります:
- デバイスのハートビート - デバイスから定期的に健康状態のチェックが行われます
- バージョンの削除要求 - バンドルバージョンが削除されたとき
- デフォルトバージョンに戻す - デバイスがビルトインバンドルに戻ったとき
- バージョンが正常にインストールされました - バンドルインストールに成功
- 新しいバージョンがデバイスに送信されました - Capgo がデバイスにアップデートを送信したとき
- バージョンインストールに失敗 - バンドルインストールに失敗
検索BOXを使用して、特定のアクションタイプを迅速に検索できます。複数のアクションを選択して、選択したタイプのいずれかにマッチするログを表示できます。
サンプルログスニペット (偽データ)
「サンプルログスニペット (偽データ)」というセクション| 時刻 (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 | Bundle が設定されました |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | App がクラッシュしたり、 notifyAppReady() 初期化されていなかったり - ロールバックがトリガーされました |
| 11:15:11 | i9j0k1l2 | reset | 組み込み | デバイスは組み込みバージョンに戻されました |
アクションが必要です: アプリが初期化後に呼び出されていることを確認してください。詳しくは notifyAppReady() プラグインのドキュメント を参照してください。 ダウンロード失敗
「ダウンロード失敗」のセクション
__CAPGO_KEEP_0__ネットワークの問題でダウンロードができません:
| 時間 | デバイス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 バックエンド列挙)」これらのコードは、 stats_action バックエンド列挙 API (capgo/src/types/supabase.types.ts) によって使用されます。UIで新しい code を見た場合、それは SDK またはバックエンドによって発行され、このリストと検証されました。
ハッピーパスとライフサイクル
| Code(s) | 意味 |
|---|---|
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は、ボットトラフィックに似た動作を検知した | 実際のユーザーには無視してください。実際のデバイスから正常なネットワークで再試行するか、ある程度の時間後に確認してください。 |
needPlanUpgrade | 組織がプラン/デバイスの制限に達した | ダッシュボードでプランをアップグレードするか、次の請求サイクルを待ってください。 |
semver_error | config内のネイティブアプリバージョンが存在しない、または有効なsemverではないx.y.z). | 有効なsemverに設定し、 plugins.CapacitorUpdater.version SemVerテスター で検証し、再度アプリをビルドしてください。 Set |
disablePlatformIos | __CAPGO_KEEP_0__.iOSはチャンネルポリシーで無効になっています。 | この操作が間違った場合、チャンネルでiOSを有効にしてルーティングを再公開してください。意図的にiOSをこのトラックでブロックした場合は、iOSをオフにし、iOSビルドを別のチャンネルに移動してください。 |
disablePlatformAndroid | __CAPGO_KEEP_0__.Androidはチャンネルポリシーで無効になっています。 | この操作が間違った場合、チャンネルでAndroidを有効にしてルーティングを再公開してください。意図的にAndroidをこのトラックでブロックした場合は、Androidをオフにし、Androidビルドを別のチャンネルに移動してください。 |
disableAutoUpdate | このアップデートスタイルはチャンネル自動アップデートモードでブロックされています。 | チャンネル自動アップデートポリシー(メジャー/マイナー/パッチ/メタデータ/なし)を変更して、意図したロールアウトを許可してください。 |
disableAutoUpdateUnderNative | このチャンネルは、デバイスのベースラインより古いアップデートをブロックしています。 | デバイスのベースライン以上のバージョンをプッシュしてください、または、ベースライン未満の保護を無効にしてください。 |
disableAutoUpdateMetadata | __CAPGO_KEEP_0__.このチャンネルは min_update_version メタデータとアプリケーションが古い場合を要求しています。 | この設定は min_update_version ターゲットパッケージまたはリリース用に、より新しいネイティブバージョンから取得してください。 |
disableAutoUpdateToMajor | The channel blocks major version jumps. | このチャンネルではメジャーバージョンジャンプをブロックします。 |
disableAutoUpdateToMinor | メジャーバージョンを同じチャンネル戦略に保つか、このトラックでメジャージャンプを許可します。 | The channel blocks minor version jumps. |
disableAutoUpdateToPatch | このチャンネルではマイナーバージョンジャンプをブロックします。 | マイナーバージョンを同じチャンネル戦略に保つか、このトラックでマイナージャンプを許可します。 |
disableEmulator | The channel blocks patch-level jumps for this flow. | このフローのパッチレベルジャンプはチャンネルポリシーでブロックされています。 |
disableDevBuild | リリースのキャデンスを合わせるか、このトラックのパッチジャンプを開放してください。 | Emulator updates are not allowed for this channel. |
disableProdBuild | このチャンネルではエミュレータの更新を許可していません。 /updatesエミュレータの更新を許可したい場合は、エミュレータを検証するテストチャンネルで有効にしてください。意図的であれば、このチャンネルでエミュレータをブロックし、エミュレータのビルドは別のチャンネルで行ってください。 | この場合、意図しないものだった場合は、生産更新をそのチャネルで許可し、再発行してください。意図的な場合は、制限を維持し、生産ビルドを適切なチャネル/ビルドに送信してください。 |
cannotGetBundle | Capgoは選択したバンドルに対して有効なダウンロードURLを作成できませんでした。 | バンドルを再アップロードするか、manifestを再生成し、R2/publicバンドル設定を確認してください。 |
cannotUpdateViaPrivateChannel | アプリは、自我割り当てを許可しないプライベートチャネルに自我切り替えを試みました。 | 有効 allow_device_self_set チャネルまたはプライベート/許可されたチャネルに切り替えてください。 |
channelMisconfigured | チャネル自動更新ルールは、必要なデータが不足しています（version_number ）without min_update_version). | そのルールの欠落した設定を埋めつつ、またはシンプルな自動更新モードに切り替えてください。 |
missingBundle | バンドルにはダウンロード可能なペイロードが存在しません（欠落している external_url/r2_path とmanifest）。 | バンドルを再構築/再アップロードし、バンドルが実際のファイルコンテンツを持つことを確認してください。 |
NoChannelOrOverride | このデバイスに該当するチャネルが見つかりませんでした (クラウドのデフォルト + config のフォールバック + override のない場合)。 | ダッシュボードでチャネルをデフォルトに設定するか、テスト用にそのビルドを保存してください。 defaultChannel 短時間内に多くの更新/チャネル呼び出し (レンダリングループ内 |
rateLimited | レンダリングループ内で呼び出しを止めましょう。ユーザーがアクションを起こすときにのみ呼び出してください。 setChannel/getChannel). | アプリとバンドル暗号化キーIDが異なります ( defaultChannel vs capacitor.config. |
keyMismatch | コンソールで、デバイスとバンドルキーIDを比較してください。IDが異なるときは、同じキーと一致する __CAPGO_KEEP_0__/プラグインバージョンで公開してください。バージョン間でキーがエンコードされる方法が異なる場合があります。device_key_id 実機がブロックされたのは、このチャネルが実機をブロックしているためです。 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 | このチャネルではElectronがブロックされています。 | __CAPGO_KEEP_0__ |
disablePlatformElectron | __CAPGO_KEEP_0__ | この操作は誤りだった場合、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、再構築および再公開のバンドルメタデータ。 |
| 設定またはポリシーブロック |
| 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_* 以降の set | ダウンロードは完了しましたが、インストールフェーズは終了せず |
Runtime / プラットフォームイベント
「Runtime / プラットフォームイベント」セクション| 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 | WebViewライフサイクルとJS/レンダリングエラー。JSとネイティブレイヤー両方にSentryをインストールして、スタックトレース、セッション/デバイスコンテキスト、URL/状態をキャプチャして、より早く修正できるようにする。 |
os_version_changed, native_app_version_changed | OS またはネイティブアプリのバージョンが変更された; これは、プラットフォームレベルのロールアウト効果とウェブバンドルの動作を区別するのに役立ちます。 |
➡️ code に関するより深いガイダンスが必要ですか? 以下を参照してください。 フル ログ Code リファレンスとデバッグ ガイド.
特定のログ エントリをクリックすると、通常、デバイスのページに移動します。
このページでは、特定のデバイスの全履歴を確認できます。これは、デバイス固有の問題を診断したり、その更新履歴を理解したりするのに非常に役立ちます。ログから続ける セクション「ログから続ける」ログを使用している場合、ログを使用してデバイスの履歴を確認できます。
ログ ログ ダッシュボードとAPIの運用計画を行い、 APIの概要 APIの概要の実装詳細については 導入 導入の実装詳細については APIのキー APIのキーについての実装詳細 デバイス デバイスの実装詳細 バンドル バンドルの実装詳細