ログ
このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーします。
ログとログインサイト
「ログとログインサイト」セクションアプリ ログ タブを開きます ログの洞察 デフォルトでは使用します。洞察を使用して、1、3、7、または 30 日間の期間でカテゴリ、バージョン、デバイスを優先します。次に、 ログ 必要な場合のデバイスイベント、フィルタ、タイムスタンプを下位のサブタブに切り替えます。
アプリケーションログの理解
「アプリケーションログの理解」ログのサブタブは、更新イベントと診断情報の詳細な履歴を提供します。これは、デバイスのレベルでの洞察の裏付けを確認する、更新パスのトラブルシューティング、デバイスがCapgoとどのように相互作用するかを理解するのに役立ちます。アプリを開き、 ログ, そして ログ サブタブを選択します。
ログの表示画面には以下の機能があります。
- ログのサブタブ — ログの各行のナビゲーションコントロールです。
- リロードボタン — 最新のデータでログリストを更新します。
- 時間範囲とアクションフィルタ — 時間とアクションでイベントストリームを絞り込むことができます。
各行には以下の情報が表示されます。
- タイムスタンプ (UTC)
- デバイスID
- アクション code (発生したこと)
- バージョン名 (バンドルまたは)
builtin)
行をクリックすると、デバイスの詳細ページにフルヒストリが表示されます。
日付範囲でフィルタリング
セクション：日付範囲でフィルタリング日付範囲でログをフィルタリングするには、日付選択器を使用できます。
- クイックプリセット - 1時間、3時間、6時間、または12時間の一般的な時間範囲を選択します。
- 開始時間 - 指定された範囲の開始時間をカスタマイズします。
- 終了時間 - 指定された範囲の終了時間をカスタマイズします。
- カレンダー - カレンダー ビューを使用して特定の日付を選択します。
選択した日付範囲を適用するには「選択」ボタンをクリックします。キャンセルする場合は「キャンセル」ボタンをクリックします。
アクションタイプによるフィルタリング
「アクションタイプによるフィルタリング」セクションアクション ドロップダウンは、ログを特定のイベントタイプでフィルタリングするために使用されます。
利用可能なアクション フィルタは次のとおりです。
- デバイス ハートビート - デバイスから定期的に健康状態のチェックが行われます。
- バージョン削除要求 - バンドルのバージョンが削除されたとき
- デフォルトバージョンに戻す - デバイスが組み込みのバンドルに戻ったとき
- バージョンインストールに成功 - バンドルのインストールに成功したとき
- 新バージョンがデバイスに送信 - 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は再起動まで待機します |
例としてのログシナリオ
「例としてのログシナリオ」のセクションログが何を示しているか理解するために、実際のデバイスのアップデートのシーケンスを示します。
正常なアップデートフロー
「正常なアップデートフロー」のセクション正常なアップデートがログに表示されるようにする方法を示します
| 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
| セクションのタイトル “更新に失敗し、デバイスがロールバックした場合” | デバイスが更新に失敗し、ロールバックした場合: | アクション | バージョン | 意味は? |
|---|---|---|---|---|
| 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 | - | __CAPGO_KEEP_0__ |
__CAPGO_KEEP_0__: __CAPGO_KEEP_0__ __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0____CAPGO_KEEP_0__
| 時刻 | デバイスID | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
|---|---|---|---|---|
| 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 | ダウンロードの進行状況のマイルストーン |
download_10 … download_90 | 最初の進行イベントの0%進行度マーカー |
download_0 | 全バンドルがダウンロードされました |
download_complete | 次の起動時にはバンドルが準備されました |
set | デバイスはビルトインバンドルに戻りました |
reset | ローカルストレージからバンドルが削除されました |
delete | アプリのアンインストールが検出されました |
uninstall | Device asked __CAPGO_KEEP_0__ for the current channel manifest |
app_moved_to_foreground, app_moved_to_background | アプリライフサイクルイベントがSDKによって記録されます。 |
ping | デバイスからハートビートチェック |
setChannel, getChannel | SDKを使用してチャネルをオーバーライドまたは取得 |
新しいポリシーブロック/スロットルクイックフィックス
「新しいポリシーブロック/スロットルクイックフィックス」| Code | なぜこれが起こるのか | 次のステップは何ですか |
|---|---|---|
invalidIp | Capgoは、Google/クラウドインフラストラクチャIPのようないくつかのBotトラフィックを検知しました。 | 実際のユーザーには無視してください。実際のデバイスから正常なネットワークでリトライするか、あるいは時間を置いて確認してください。 |
needPlanUpgrade | 組織がプラン/デバイスの制限に達しました。 | ダッシュボードでプランをアップグレードするか、次の請求サイクルを待ってください。 |
semver_error | Native app version in config が存在しない、または不正な semver (x.y.z). | を有効な semver に設定し、次に SemVer テスター で検証し、再構築すること。 plugins.CapacitorUpdater.version を有効にする 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 | このチャネルでエミュレータの更新を許可しない。 | この操作は誤りだった場合、エミュレータの更新を有効にして、エミュレータを検証するテストチャンネルで実行してください。意図的だった場合は、このチャンネルのエミュレータをブロックし、エミュレータのビルド用に別のチャンネルを使用してください。 |
disableDevBuild | このチャンネルのDevビルドはブロックされています。 | この操作は誤りだった場合、Dev更新を許可するか、このデバイスをDev有効のチャンネルに移動してください。意図的だった場合は、このチャンネルをリリースビルドのみにロックしてください。 |
disableProdBuild | 生産モードで作成されたデバイスビルドは /updates、チャンネルがブロックしている間もあります。 | この操作は誤りだった場合、チャンネルで生産更新を許可し、再公開してください。意図的だった場合は、制限を維持し、正しいチャンネル/ビルドに生産ビルドを送信してください。 |
cannotGetBundle | Capgoは選択したバンドルに対して有効なダウンロードURLを構築できませんでした。 | バンドルを再アップロードするか、manifestを再生成し、R2/publicバンドル設定を確認してください。 |
cannotUpdateViaPrivateChannel | アプリは、自ら自身の割り当てを許可しないプライベートチャンネルに自ら切り替えようとしています。 | チャンネルに allow_device_self_set チャンネル上で有効にし |
channelMisconfigured | チャンネル自動更新ルールは、必要なデータが不足しています (version_number without min_update_version). | そのルールまたはシンプルな自動更新モードに切り替えて、欠落している設定を埋めます。 |
missingBundle | Bundleにはダウンロード可能なペイロードが存在しません (欠落している external_url/r2_path とmanifest)。 | バージョンを再構築/アップロードし、Bundleが実際のファイルコンテンツを持つことを確認してください。 |
NoChannelOrOverride | このデバイスに一致するチャネルが存在しません (クラウドデフォルトなし + 設定フォールバックなし + オーバーライドなし)。 | デフォルトのチャネルをダッシュボードに設定するか、テスト defaultChannel をそのビルドに残してください。 |
rateLimited | 短時間に多くの更新/チャネルコールが発生しています (通常はレンダリングループ setChannel/getChannel). | を停止してください。ユーザーがアクションを実行するときにのみ呼び出してください。 defaultChannel を使用してください。 capacitor.config. |
keyMismatch | アプリとBundleの暗号化キー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__はローカルファイルをサーバーから取得するように設定されています。 server.url configured, so Capacitor serves remote URL instead of local files. | __CAPGO_KEEP_0__はローカルファイルをサーバーから取得するように設定されています。 server.url __CAPGO_KEEP_0__はローカルファイルをサーバーから取得するように設定されています。 |
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 | 組織はプラン/デバイスの制限に達しました。 |
ダウンロード/整合性/インストールの失敗
| 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の概要 APIの概要 __CAPGO_KEEP_0__の概要 導入 APIのキー APIのキー デバイス デバイス バンドル バンドルの実装詳細について