ログ
このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーします。
ログとログインサイト
「ログとログインサイト」セクションアプリ ログ タブを開きます。 ログの洞察 デフォルトでは使用します。洞察を使用して、1、3、7、または 30 日間の期間でカテゴリ、バージョン、デバイスを優先します。ページの ログ コンテキスト: Capgo Builder / ネイティブ クラウド ビルド製品ページ。役割: 短い UI ラベルまたはナビゲーション アイテム。見られる場所: 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__とデバイスがどのように相互作用するかを理解するために役立ちます。アプリを開き、ログ コンテキスト: Capgo Builder / ネイティブ クラウド ビルド製品ページ。役割: 短い UI ラベルまたはナビゲーション アイテム。見られる場所: native-build.astro 画面。メッセージキー `native_build_v2_trust_logs_lbl` (ネイティブ ビルド V2 信頼ログラベル)。 , すると、サブタブを選択します。
ログの表示画面には以下の機能があります。
- ログのサブタブ — ログの各行のナビゲーションコントロール。
- リロードボタン — 最新のデータでログリストを更新します。
- 時間範囲とアクションのフィルタ — 時間とアクションでイベントストリームを絞り込む。
各行には以下の情報が表示されます。
- タイムスタンプ (UTC)
- デバイスID
- アクション code (発生したこと)
- バージョン名 (バンドルまたは)
builtin)
行をクリックすると、デバイスの詳細ページにフルヒストリが表示されます。
日付範囲でフィルタリング
セクション：日付範囲でフィルタリング日付範囲でログをフィルタリングするには、日付選択器を使用できます。
- クイックプリセット - 1時間、3時間、6時間、または12時間の一般的な時間範囲を選択します。
- 開始時間 - 指定された範囲の開始時間をカスタマイズします。
- 終了時間 - 指定された範囲の終了時間をカスタマイズします。
- カレンダー - カレンダー画面を使用して、特定の日付を選択します。
選択した日付範囲を適用するには「選択」ボタンをクリック、または「キャンセル」ボタンをクリックしてピッカーを閉じます。
アクションタイプによるフィルタリング
「アクションタイプによるフィルタリング」のセクションアクションのドロップダウンメニューを使用すると、ログを特定のイベントタイプでフィルタリングできます。
利用可能なアクション フィルタは次のとおりです。
- デバイス ハートビート デバイスから周期的に行われる健康チェック
- バージョン削除要求 バンドル バージョンが削除されたとき
- デフォルトバージョンに戻す デバイスが組み込みバンドルに戻ったとき
- バージョンが正常にインストールされました バンドルが正常にインストールされたとき
- 新バージョンがデバイスに送信されました 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 | builtin | デバイスがリクエスト制限に当たった; SDKは再起動まで待機 |
例としてのログシナリオ
「例としてのログシナリオ」のセクションログを理解するために、ここでは実際のデバイスのアップデートの旅を示すシーケンスを示します。
正常なアップデートフロー
「正常なアップデートフロー」のセクション正常なアップデートのログの例です
| Time | デバイス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 | config内のネイティブアプリバージョンが存在しない、または不正なsemverです (x.y.z). | を plugins.CapacitorUpdater.version 有効なsemverに設定し、 SemVerテスター で検証し、再度アプリをビルドしてください。 |
disablePlatformIos | iOSはチャンネルポリシーで無効になっています。 | このことが間違って行われた場合、チャンネルでiOSを有効にしてルーティングを再公開してください。意図的にiOSをこのトラックでブロックした場合は、iOSビルドを別のチャンネルに移動してください。 |
disablePlatformAndroid | Androidはチャンネルポリシーで無効になっています。 | このことが間違って行われた場合、チャンネルでAndroidを有効にしてルーティングを再公開してください。意図的にAndroidをこのトラックでブロックした場合は、Androidビルドを別のチャンネルに移動してください。 |
disableAutoUpdate | チャンネル自動更新モードはこの更新スタイルをブロックしています。 | チャンネル自動更新ポリシー(メジャー/マイナー/パッチ/メタデータ/なし)を変更して、意図したロールアウトを許可してください。 |
disableAutoUpdateUnderNative | チャンネルは、デバイスのベースラインより古い更新をブロックしています。 | Nativeバージョン基準以上のバージョンをプッシュするか、またはその下位バージョン保護を無効にする。 |
disableAutoUpdateMetadata | チャンネルには min_update_version メタデータとアプリが古い場合 | ターゲットのバンドルまたはリリース用に min_update_version このチャンネルではメジャーバージョンジャンプをブロックします。 |
disableAutoUpdateToMajor | このトラックでメジャージャンプを許可するか、メジャーバージョンを同じチャンネー戦略で維持する。 | このチャンネルではマイナーバージョンジャンプをブロックします。 |
disableAutoUpdateToMinor | このトラックでマイナージャンプを許可するか、マイナーバージョンを同じチャンネー戦略で維持する。 | このフローでパッチレベルジャンプをブロックします。 |
disableAutoUpdateToPatch | リリースのペースを合わせるか、このチャンネルポリシーでパッチレベルジャンプを開放する。 | このチャンネルではエミュレータの更新を許可しません。 |
disableEmulator | __CAPGO_KEEP_0__ | この操作は誤りだった場合、エミュレータの更新を有効にして、エミュレータを検証するテストチャンネルで実行してください。意図的だった場合、このチャンネルのエミュレータをブロックし、エミュレータのビルド用に別のチャンネルを使用してください。 |
disableDevBuild | このチャンネルではDevビルドがブロックされています。 | この操作は誤りだった場合、Dev更新を許可するか、このデバイスを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). | を停止してください。ユーザーがアクションを実行するときにのみ呼び出しを行い、 defaultChannel を使用してください。 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 | アプリは__CAPGO_KEEP_0__がリモートURLを提供するように設定されています。 server.url configured, so Capacitor serves remote URL instead of local files. | プロダクションビルド用に削除/クリアし、更新パッケージをローカルに保持します。 server.url __CAPGO_KEEP_0__ |
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 | 組織はプラン/デバイスの制限に達しました。 |
ダウンロード/整合性/インストールの失敗
| 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またはネイティブアプリのバージョンが変更されました。この機能は、Webバンドルの動作とプラットフォームレベルのロールアウト効果を区別するのに役立ちます。 |
➡️ code に関するより詳細なガイダンスが必要ですか? 以下のリンクを参照してください。 Code のフルログ参照とデバッグガイド.
ログの詳細を取得する方法
「ログの詳細を取得する方法」のセクション特定のログエントリをクリックすると、通常、デバイスのページに移動します。 この機能により、特定のデバイスの全履歴を確認できます。これは、デバイス固有の問題を診断したり、その更新履歴を理解したりするのに非常に役立ちます。ログから続けて進みます
ログ
ログから続けてCapgo Builderを使用している場合 ログ to plan dashboard and API operations, connect it with API Overview APIの概要 __CAPGO_KEEP_0__の概要 実装の詳細については API Keys APIのキー 実装の詳細については デバイスについては パッケージ パッケージの実装詳細について