ログ
このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーします。
ログとログインサイト
「ログとログインサイト」セクションアプリ ログ タブを開きます ログの洞察 デフォルトでは使用します。洞察を使用して、1、3、7、または 30 日間の期間でカテゴリ、バージョン、およびデバイスを優先します。次に、 ログ ロール:短いUIラベルまたはナビゲーションアイテム。ページ/エリア:Capgoビルダー/ネイティブクラウドビルド製品ページ。見つける:ページnative-build.astro。メッセージキー`native_build_v2_trust_logs_lbl` (ネイティブビルドV2トラストログラベル)。
サブタブを選択する必要がある場合、以下のデバイスイベント、フィルタ、タイムスタンプを含む詳細なログの履歴が提供されます。
アプリケーションログの理解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__とデバイスがどのように相互作用するかを理解するのに役立ちます。アプリを開き、ログ ロール:短いUIラベルまたはナビゲーションアイテム。ページ/エリア:Capgoビルダー/ネイティブクラウドビルド製品ページ。見つける:ページnative-build.astro。メッセージキー`native_build_v2_trust_logs_lbl` (ネイティブビルドV2トラストログラベル)。 サブタブを選択します。
ログの表示画面には以下の機能があります。
- ログのサブタブ — ログの各行のナビゲーションコントロール
- リロードボタン — 最新のデータでログリストを更新
- 時間範囲とアクションのフィルタ — 時間とアクションでイベントストリームを絞り込む
各行には以下の情報が表示されます。
- タイムスタンプ (UTC)
- デバイスID
- codeのアクション (何が起こったか)
- バージョン名 (バンドルまたは
builtin)
行をクリックすると、デバイスの詳細ページにフルヒストリが表示されます。
日付範囲でフィルタリング
セクション「日付範囲でフィルタリング」日付ピッカーを使用して、特定の時間帯のログをフィルタリングできます。
- 日付範囲ピッカー - 1時間、3時間、6時間、または12時間の一般的な時間範囲を選択
- 開始時間 - 時間範囲の開始時間をカスタマイズする
- 終了時間 - 時間範囲の終了時間をカスタマイズする
- カレンダー - カレンダー画面を使用して特定の日付を選択
選択した日付範囲を適用するには「選択」をクリック、または「キャンセル」でピッカーを閉じる
アクションタイプによるフィルタリング
「アクションタイプによるフィルタリング」のセクションアクションのドロップダウンメニューは、以下のイベントタイプでログをフィルタリングすることを可能にします:
利用可能なアクション フィルタは次のとおりです。
- デバイス ハートビート - デバイスから定期的に健康状態のチェックが行われます。
- バージョン削除要求 - バンドルのバージョンが削除されたとき
- デフォルトバージョンに戻す - デバイスがバuiltin バンドルに戻ったとき
- バージョンインストールに成功 - バンドルのインストールに成功したとき
- 新バージョンをデバイスに送信 - 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
| Failed Update with Rollback | 更新に失敗し、ロールバックした場合 | アクション | バージョン | 意味は? |
|---|---|---|---|---|
| 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 バックエンドenum)
「ログコード (Capgo バックエンドenum)」のセクションこれらのコードは、ダッシュボードの__CAPGO_KEEP_0__ ( stats_action )によって使用されるenumから来ています。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 | 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 | Nativeアプリのバージョンはconfigに存在しない、または不正なsemverです (x.y.z). | を plugins.CapacitorUpdater.version に有効なsemverに設定し、 SemVerテスター で検証し、再度アプリをビルドしてください。 |
disablePlatformIos | iOSはチャンネルポリシーで無効化されています。 | このことが間違って行われた場合、iOSを有効化し、ルーティングを再公開してください。意図的にiOSをこのトラックでブロックした場合は、iOSを別のチャンネルに移動してください。 |
disablePlatformAndroid | Androidはチャンネルポリシーで無効化されています。 | このことが間違って行われた場合、Androidを有効化し、ルーティングを再公開してください。意図的にAndroidをこのトラックでブロックした場合は、Androidを別のチャンネルに移動してください。 |
disableAutoUpdate | チャンネル自動アップデートモードでこのアップデートスタイルをブロックしています。 | チャンネル自動アップデートポリシーを変更してください (メジャー/マイナー/パッチ/メタデータ/なし) で、意図したロールアウトを許可してください。 |
disableAutoUpdateUnderNative | チャンネルはデバイスベースラインより古いアップデートをブロックしています。 | Native バイナリ基準以上のバージョンをプッシュするか、またはその下位の保護を無効にします。 |
disableAutoUpdateMetadata | Channel は min_update_version メタデータとアプリが古い場合 | ターゲット バンドルまたはリリース用に min_update_version このチャンネルではメジャーバージョンジャンプがブロックされます。 |
disableAutoUpdateToMajor | メジャーバージョンを同じチャンネル戦略に維持するか、このトラックでメジャージャンプを許可します。 | このチャンネルではマイナーバージョンジャンプがブロックされます。 |
disableAutoUpdateToMinor | マイナーバージョンを同じチャンネル戦略に維持するか、このトラックでマイナージャンプを許可します。 | このフローではパッチレベルジャンプがブロックされます。 |
disableAutoUpdateToPatch | リリースのペースを合わせるか、このトラックのチャンネルポリシーでパッチジャンプを開放します。 | このチャンネルではエミュレータの更新が許可されていません。 |
disableEmulator | Emulator updates are not allowed for this channel. | このことは偶然だったら、エミュレータの更新をテストチャンネルで有効にして、エミュレータを検証してください。意図的だったら、このチャンネルにエミュレータをブロックし、エミュレータのビルド用に別のチャンネルを使用してください。 |
disableDevBuild | このチャンネルではDevビルドがブロックされています。 | このことは偶然だったら、Devの更新を許可するか、このデバイスをDev有効のチャンネルに移動してください。意図的だったら、このチャンネルをリリースビルドのみにロックしてください。 |
disableProdBuild | 生産モードで作成されたデバイスビルド /updates、あなたのチャンネルがブロックしている間に | このことは偶然だったら、そのチャンネルで生産の更新を許可し、再発行してください。意図的だったら、制限を維持し、正しいチャンネル/ビルドに生産ビルドを送信してください。 |
cannotGetBundle | Capgoは選択したバンドルに対して有効なダウンロードURLを構築できませんでした。 | バンドルを再アップロードするか、manifestを再生成し、R2/publicバンドル設定を確認してください。 |
cannotUpdateViaPrivateChannel | アプリは、自ら自身の割り当てを許可しないプライベートチャンネルに切り替えようとしていた。 | チャンネルに allow_device_self_set を有効にしてください、または、パブリック/許可されたチャンネルに切り替えてください。 |
channelMisconfigured | チャンネル自動更新ルールには、必要なデータが不足しています (version_number なし min_update_version). | __CAPGO_KEEP_0__ |
missingBundle | ルールまたは自動更新モードをシンプルなものに切り替えてください。 external_url/r2_path ダウンロード可能なペイロードが存在しません ( | と)。 |
NoChannelOrOverride | バンドル内の実際のファイル内容を確認するために、バージョンを再構築/再アップロードしてください。 | このデバイスに該当するチャンネルが見つかりませんでした (クラウドデフォルトなし + 設定フォールバックなし + オーバーライドなし)。 defaultChannel デフォルトのチャンネルをダッシュボードで設定するか、テスト用にそのビルドに残してください。 |
rateLimited | 短時間内に多数の更新/チャンネル呼び出しがあります (通常はレンダリングループ内)。 setChannel/getChannel). | レンダリングループ内では呼び出さないでください。ユーザーがアクションをとったときにのみ呼び出してください。 defaultChannel アプリとバンドル暗号化キーIDが異なります ( capacitor.config. |
keyMismatch | アプリとバンドル暗号化キーIDが異なりますdevice_key_id vs bundle_key_id). | コンソールで、デバイスとバンドルキーIDを比較します。キーが異なる場合、同じキーと一致するCLI/プラグインバージョンで公開します。キーはバージョンによってエンコードが異なる場合があります。 |
disableDevice | 実機がブロックされているのは、このチャンネルが実機をブロックしているためです。 | このブロックが間違って設定された場合は、実機の更新を有効にし、チャンネルを変更してください。ブロックが意図的だった場合は、ブロックを維持し、実機を別のチャンネルにルーティングしてください。 |
disablePlatformElectron | このチャンネルではElectronがブロックされています。 | このブロックが間違って設定された場合は、このチャンネルでElectronを有効にし、ルーティングを再公開してください。ブロックが意図的だった場合は、ブロックを維持し、Electronユーザーを専用チャンネルに送信してください。 |
customIdBlocked | カスタムデバイスIDが送信されましたが、このアプリはカスタムIDを受け付けていません。 | カスタムIDの送信をオフにし、またはカスタムIDを有効にする場合は、ワークフローがそれを必要とする場合にのみ行ってください。 |
blocked_by_server_url | アプリは__CAPGO_KEEP_0__がリモートURLを提供するように設定されています。 server.url configured, so Capacitor serves remote URL instead of local files. | プロダクションビルド用に削除/クリアし、更新パッケージをローカルに保持してください。 server.url アプリは__CAPGO_KEEP_0__がリモートURLを提供するように設定されています。 |
backend_refusal | アップデーターは v4、バックエンドがこれ以上受け付けないようになりました。 | プラグイン/CLIを v5+ (prefer 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 | 組織はプラン/デバイスの制限に達しました。 |
ダウンロード/整合性/インストールの失敗
| 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 のフルログ参照とデバッグガイド.
ログの詳細についてもっと知りたい
「ログの詳細についてもっと知りたい」のセクション特定のログエントリをクリックすると、通常、デバイスのページに移動します。 この機能は、特定のデバイスの全履歴を表示し、デバイス固有の問題を診断したり、その更新履歴を理解したりするのに役立ちます。ログから続けて進みます
Capgo Builderを使用している場合 ログ to plan dashboard and API operations, connect it with API Overview for the implementation detail in API Overview, Native Build V2 Trust Logs Lbl Capgo Builderを使用して API Keys for the implementation detail in API Keys, 導入 導入の実装詳細です。 パッケージ パッケージの実装詳細について