Logs
このプラグインのインストール手順とフルマークダウンガイドをコピーします。
ログとログインサイト
ログとログインサイトアプリ ログ ログを開く ログ インサイト デフォルトでは使用します。 インサイトを使用して、カテゴリ、バージョン、デバイスを 1 日、3 日、7 日、または 30 日間優先します。 「ログ」に切り替えると、次の情報が表示されます。 ログ イベントログのサブタブは、下記のイベント、フィルタ、タイムスタンプを含むデバイスのイベントを表示します。
ログ サブタブを使用すると、次の情報が表示されます。
アプリケーション ログの理解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_KEEP_0__ とどのように相互作用するかを理解したりするのに役立ちます。アプリを開き、次のオプションを選択します。 ログ 、
ログの表示インターフェイスには以下の機能が含まれます。
- ログサブタブ — ログの各行のナビゲーション制御。
- リロードボタン — 最新のデータでログリストを更新します。
- 時刻範囲とアクションフィルタ — 時間とアクションでイベントストリームを絞り込む。
各行には以下の情報が表示されます。
- タイムスタンプ (UTC)
- デバイスID
- アクション code (何が起こったか)
- バージョン名 (バンドルまたは)
builtin)
行をクリックすると、デバイスの詳細ページにフルヒストリが表示されます。
日付範囲でフィルタリングする
日付範囲でフィルタリングするセクション日付ピッカーを使用して、特定の時間範囲でログをフィルタリングできます。
- クイックプリセット - 最新の1時間、3時間、6時間、または12時間の時間範囲を選択します。
- 開始時間 __CAPGO_KEEP_0__
- 終了時間 __CAPGO_KEEP_0__
- カレンダー __CAPGO_KEEP_0__
選択した日付範囲を適用するには、「選択」ボタンをクリックしてください。キャンセルする場合は、「キャンセル」ボタンをクリックしてください。
__CAPGO_KEEP_0__
アクションタイプによるフィルタリング__CAPGO_KEEP_0__
利用可能なアクションフィルタは次のとおりです:
- デバイスの心拍 - デバイスから周期的に健康チェック
- バージョンの削除が要求されました - バンドルのバージョンが削除されたとき
- デフォルトバージョンに戻す - デバイスがビルトインのバンドルに戻ったとき
- バージョンのインストールが成功しました - バンドルのインストールが成功したとき
- 新しいバージョンがデバイスに送信されました - Capgoがデバイスにアップデートを送信したとき
- バージョンのインストールが失敗しました - インストールが失敗した場合のバンドル
上部の検索ボックスを使用して、特定のアクションタイプを迅速に検索できます。複数のアクションを選択して、選択したタイプのいずれかに該当するログを表示できます。
サンプルログスニペット (偽のデータ)
サンプルログスニペット (偽のデータ) のセクション| 時刻 (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 | バンドルがインストールされ、有効化されました |
デバイスは最新のバージョンでした
「デバイスは最新のバージョンです」デバイスが最新のバージョンをチェックしたときのこと
| 時刻 | デバイス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 | builtin | アクションが必要です |
: アプリが正常に初期化された後、あなたのアプリが呼び出されるようにしてください。詳しくは notifyAppReady() https://capgo.io/docs/webapp/logs/ プラグインドキュメント 詳しくはこちら
ダウンロード失敗
セクション「ダウンロード失敗」ネットワークの問題によりダウンロードができません。
| 時間 | デバイス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.tscodeが新しく表示された場合、それはSDKまたはバックエンドによって生成され、このリストと検証されたものです。
__CAPGO_KEEP_0__(s)
| 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は、Google/クラウドインフラストラクチャIPのbotトラフィックが見つかった | 実際のユーザーには無視して、実際のデバイスから正常なネットワークでリトライするか、あるいは時間を置いて確認する |
needPlanUpgrade | 組織がプラン/デバイスの制限に達した | ダッシュボードでプランをアップグレードするか、次の請求サイクルを待つ |
semver_error | ネイティブアプリのバージョンが設定ファイルに欠落しているか、または不正なsemver形式であるx.y.z). | 設定 plugins.CapacitorUpdater.version バージョンを有効なsemverに設定し、次に SemVerテスター とアプリを再構築します。 |
disablePlatformIos | iOSはチャンネルポリシーで無効化されています。 | このことが間違った場合、チャンネルでiOSを有効化し、ルーティングを再公開してください。意図的にiOSをこのトラックでブロックした場合は、iOSを別のチャンネルに移動してください。 |
disablePlatformAndroid | Androidはチャンネルポリシーで無効化されています。 | このことが間違った場合、チャンネルでAndroidを有効化し、ルーティングを再公開してください。意図的にAndroidをこのトラックでブロックした場合は、Androidを別のチャンネルに移動してください。 |
disableAutoUpdate | チャンネル自動更新モードはこの更新スタイルをブロックしています。 | チャンネル自動更新ポリシーを変更して、意図したロールアウトを許可してください (メジャー/マイナー/パッチ/メタデータ/なし)。 |
disableAutoUpdateUnderNative | チャンネルは、デバイスのベースラインより古い更新をブロックしています。 | デバイスのベースライン以上のバージョンをプッシュするか、下位の保護を無効化してください。 |
disableAutoUpdateMetadata | チャンネルは min_update_version メタデータが必要であり、古いアプリケーションです。 | Capgo min_update_version 新しいネイティブ版から、ターゲットバンドルまたはリリース向けに。 |
disableAutoUpdateToMajor | ターゲットバンドルまたはリリースのために、より新しいネイティブバージョンからメタデータが必要です。 | このチャンネルはメジャーバージョンジャンプをブロックします。 |
disableAutoUpdateToMinor | メジャーバージョンを同じチャンネル戦略に維持するか、このトラックでメジャージャンプを許可するか。 | このチャンネルはマイナーバージョンジャンプをブロックします。 |
disableAutoUpdateToPatch | マイナーバージョンを同じチャンネル戦略に維持するか、このトラックでマイナージャンプを許可するか。 | このフローでパッチレベルジャンプをブロックします。 |
disableEmulator | リリースサイクルを調整するか、このトラックのチャンネルポリシーでパッチジャンプを開放するか。 | エミュレータの更新はこのチャンネルで許可されていません。 |
disableDevBuild | このチャンネルでは、Devビルドがブロックされています。 | この操作が間違って行われた場合、Devアップデートを許可するか、このデバイスをDevビルドを許可したチャンネルに移動してください。意図的に行われた場合は、このチャンネルをリリースビルドのみにロックしてください。 |
disableProdBuild | 生産モードで作成されたデバイスビルドは /updatesこのチャンネルがブロックしているため、 | この操作が間違って行われた場合、生産アップデートを許可するチャンネンに移動してください。生産ビルドを正しいチャンネル/ビルドに送信する場合は、制限を維持してください。 |
cannotGetBundle | Capgoは選択したバンドルに対して有効なダウンロードURLを生成できませんでした。 | バンドルを再アップロードしてください(Δファイルを含める場合は) --delta アプリはプライベートチャンネルに自動的に切り替えようとしているが、そのチャンネルでは自我割り当てを許可していません。 |
cannotUpdateViaPrivateChannel | チャンネルに | Enable allow_device_self_set チャンネル自動アップデートルールには必要なデータが不足しています(" |
channelMisconfigured | requiredversion_number without min_update_version). | そのルールまたはシンプルな自動更新モードに切り替えて、欠落している設定を埋めます。 |
missingBundle | Bundleにはダウンロード可能なペイロードが存在しません (欠落している external_url/r2_path とデルタファイルもありません)。 | バージョンを再構築/再アップロードし、バンドルの実際のファイルコンテンツが存在することを確認してください。 |
NoChannelOrOverride | このデバイスに該当するチャンネルが存在しません (クラウドデフォルトなし + 設定フォールバックなし + オーバーライドなし)。 | デフォルトのチャンネルをダッシュボードに設定するか、テスト defaultChannel をそのビルドに残してください。 |
rateLimited | 短時間に多くの更新/チャンネル呼び出しがあります (通常はレンダリングループ setChannel/getChannel). | 呼び出しを停止してください。ユーザーアクションのみで呼び出してください。 defaultChannel in capacitor.config. |
keyMismatch | アプリとバンドルの暗号化キーIDが異なります (device_key_id vs bundle_key_id). | コンソールで、デバイスとバンドルキーIDを比較します。IDが異なる場合、同じキーと一致するCLI/プラグインバージョンで公開します。キーはバージョン間でエンコードが異なる場合があります。 |
disableDevice | 実機がブロックされています。チャンネル設定が実機をブロックしているためです。 | このブロックは意図的でしたかどうかを確認してください。実機の更新を有効にすると、ブロックが解除されます。そうでない場合は、実機を別のチャンネルにルーティングするようにしてください。 |
disablePlatformElectron | Electronはこのチャンネルでブロックされています。 | このブロックが偶然の場合、Electronをこのチャンネルで有効にして再度ルーティングを公開してください。そうでない場合は、Electronユーザーを専用チャンネルに送信するようにしてください。 |
customIdBlocked | カスタムデバイスIDが送信されましたが、このアプリはカスタムIDを受け付けていません。 | カスタムIDの送信をオフにしたり、カスタムIDを有効にする場合は、ワークフローがそれを必要とする場合にのみ行ってください。 |
blocked_by_server_url | アプリはログを表示しています。 server.url 設定されていれば、CapacitorはローカルファイルではなくリモートURLを提供します。 | プロダクションビルド用に削除/クリアしてください。 server.url __CAPGO_KEEP_0__はローカルファイルをサーバーから取得するように設定されています。 |
backend_refusal | アップデーターは v4バックエンドは、更新を拒否します。 | プラグイン/CLIを v5にアップグレードする v8Capacitor 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 | 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 のフルログ参照とデバッグガイド.
ログの詳細を取得する方法
「ログの詳細を取得する方法」のセクション特定のログエントリをクリックすると、通常、デバイスのページに移動します。 この機能は、デバイス固有の問題を診断したり、そのアップデートの履歴を理解したりするのに役立ちます。ログから続けて進みます
ログの詳細を取得する方法
Section titled “ログから続ける”Capgo Builderで使用している場合 ログ 計画ダッシュボードとAPIの運用を計画し、 API まとめ APIの実装詳細について Capgo Builderの実装詳細 導入 API キー API キーの実装詳細について Devices デバイス バンドル バンドルの実装詳細について
