ログ
このプラグインのインストールステップとフルマークダウンガイドまでの全てのステップを含むセットアップ用の質問をコピーしてください。
ログとログインサイト
「ログとログインサイト」タイトルのセクションアプリ ログ タブが開きます ログインサイト デフォルトで使用します。 インサイトを使用して、1、3、7、または 30 日間の期間でカテゴリ、バージョン、デバイスを優先します。 「ログ」サブタブに切り替えると、下記に記載されているデバイスのイベント、フィルタ、タイムスタンプを必要とする場合に、基盤のデバイスイベントが表示されます。 アプリケーションログの理解 __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
Section titled “アプリケーションログの理解”Capgoの詳細な更新イベントと診断情報の履歴を提供するRaw Logsサブタブは、Insightのデバイスレベルの証拠を確認する、更新パスのトラブルシューティング、デバイスがCapgoとどのように相互作用するかを理解するのに役立ちます。アプリを開き、ログを選択し、ログサブタブを選択します。 Raw Logsタブの概要Raw Logsタブ Raw Logsインターフェイスには以下の要素があります。 ログサブタブ
ログサブタブ
- ログサブタブ ログサブタブ
- ログサブタブ — 最新データでログリストを更新します。
- 時期とアクションのフィルタ — 時間とアクションでイベントストリームを絞り込む。
各行は以下を示します。
- タイムスタンプ (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 | バンドルが設定されました |
| 11:15:10 | i9j0k1l2 | update_fail | 1.3.0 | Appがクラッシュしたり、呼び出されなかったり - ロールバックがトリガーされた notifyAppReady() __CAPGO_KEEP_0__ |
| 11:15:11 | i9j0k1l2 | reset | 内蔵 | デバイスが内蔵版に戻された |
アクションが必要: アプリが初期化後に呼び出されることを確認してください。詳しくはプラグインドキュメントを参照してください。 notifyAppReady() ダウンロード失敗 「ダウンロード失敗」のセクション ネットワークの問題がダウンロードを妨げる場合:
translations
ダウンロードが失敗した場合ダウンロードが失敗した場合
| 時点 | デバイス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 | ダウンロード失敗（ネットワークタイムアウト、接続切断など） |
アクションが必要__CAPGO_KEEP_0__ : __CAPGO_KEEP_0__
アカウントがデバイスの制限に達した場合:
| Time | デバイスID | Action | Version | 意味 |
|---|---|---|---|---|
| 16:00:00 | q7r8s9t0 | needPlanUpgrade | - | このデバイスは、プランをアップグレードするか、請求サイクルがリセットされるまでアップデートを受け取れません |
必要なアクション: プランをアップグレードしてください または、次の請求サイクルを待ってください。
チャネル設定の更新ブロック
セクション「チャネル設定の更新ブロック」When channel settings prevent an update:
| 時点 | デバイス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_KEEP_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 がボットのトラフィックと見なされる可能性のある、Google/クラウドインフラストラクチャのIPを検出しました。 | 実ユーザーには無視してください。実機から正常なネットワークで再試行するか、ある程度の時間後に確認してください。 |
needPlanUpgrade | 組織がプラン/デバイスの制限に達しました。 | ダッシュボードでプランをアップグレードするか、次の請求サイクルを待ってください。 |
semver_error | config に記載されているネイティブアプリのバージョンが存在しない、または有効な semver ではありません (x.y.z). | 有効な semver に設定し、 plugins.CapacitorUpdater.version SemVer テスター で検証し、アプリを再構築してください。 チャネルポリシーで iOS が無効化されています。 |
disablePlatformIos | Native app version in config is missing or not valid semver ( | この操作は間違った場合、iOSをそのチャンネルで有効にしてルーティングを再公開してください。 iOSを意図的にこのトラックでブロックした場合は、オフにし、iOSビルドを別のチャンネルに移動してください。 |
disablePlatformAndroid | このチャンネルではAndroidが無効になっています。 | この操作は間違った場合、Androidをそのチャンネルで有効にしてルーティングを再公開してください。 Androidを意図的にこのトラックでブロックした場合は、オフにし、Androidビルドを別のチャンネルに移動してください。 |
disableAutoUpdate | このチャンネルの自動更新モードは、このアップデートスタイルをブロックしています。 | このチャンネルの自動更新ポリシーを変更してください（メジャー/マイナー/パッチ/メタデータ/なし）で、意図したロールアウトを許可してください。 |
disableAutoUpdateUnderNative | このチャンネルでは、デバイスのベースラインより古いアップデートをブロックしています。 | このチャンネルでは、デバイスのベースライン以上のバージョンをプッシュするか、下位バージョン保護を無効にしてください。 |
disableAutoUpdateMetadata | このチャンネルでは、以下の要件があります。 min_update_version このチャンネルでは、メタデータとアプリが古い場合にブロックされます。 | このチャンネルでは、ターゲットバンドルまたはリリースのために、より新しいネイティブバージョンから設定されます。 min_update_version このチャンネルでは、メジャーバージョンジャンプをブロックしています。 |
disableAutoUpdateToMajor | __CAPGO_KEEP_0__ | メジャーバージョンを同じチャネル戦略に維持するか、またはこのトラックにメジャージャンプを許可する。 |
disableAutoUpdateToMinor | このチャネルはマイナーバージョンジャンプをブロックしています。 | メジャーバージョンを同じチャネル戦略に維持するか、またはこのトラックにマイナージャンプを許可する。 |
disableAutoUpdateToPatch | このフローでは、このチャネルはパッチレベルジャンプをブロックしています。 | リリースのペースを合わせるか、このトラックのチャネルポリシーでパッチジャンプを開放する。 |
disableEmulator | このチャネルではエミュレータの更新が許可されていません。 | この更新は間違いだった場合、エミュレータの更新を有効にするテストチャネルでエミュレータを検証する。意図的だった場合は、このチャネルでエミュレータをブロックし、エミュレータビルド用に別のチャネルを使用する。 |
disableDevBuild | このチャネルではデバッグビルドがブロックされています。 | この更新は間違いだった場合、デバッグ更新を許可するか、このデバイスをデバッグ有効のチャネルに移動する。意図的だった場合は、このチャネルをリリースビルドのみにロックする。 |
disableProdBuild | 生産モードで作成されたデバイスビルド /updates, ですが、チャネルがそれをブロックしています。 | この更新は間違いだった場合、チャネルで生産更新を許可し、再発行する。意図的だった場合は、制限を維持し、生産ビルドを適切なチャネル/ビルドに送信する。 |
cannotGetBundle | Capgo は選択したバンドルの有効なダウンロード URL を作成できませんでした。 | バンドルを再アップロードするか、R2/public バンドル設定を確認して、manifest を再生成してください。 |
cannotUpdateViaPrivateChannel | アプリは、自身の割り当てを許可しないプライベート チャネルに自身を切り替えようとしています。 | 許可 allow_device_self_set チャネルまたはプライベート/許可されたチャネルに切り替えてください。 |
channelMisconfigured | チャネル自動更新ルールには、必要なデータが不足しています (version_number に欠けている min_update_version). | そのルールの欠落した設定を埋めてください、またはシンプルな自動更新モードに切り替えてください。 |
missingBundle | バンドルにはダウンロード可能なペイロードが存在しません ( external_url/r2_path とmanifest が存在しません)。 | バージョンを再構築/再アップロードし、バンドルが実際のファイル内容を持っていることを確認してください。 |
NoChannelOrOverride | このデバイスに該当するチャネルが存在しません (クラウドのデフォルト + 設定のフォールバック + オーバーライドが存在しません)。 | ダッシュボードでチャンネルをデフォルトに設定するか、テスト用にそのままにしておく。 defaultChannel ビルドのときにそのままにしておく。 |
rateLimited | 短時間に多くの更新/チャンネル呼び出し (よくレンダリングループ内で) が発生します ( setChannel/getChannel). | レンダリング中は呼び出しを停止してください。ユーザーがアクションを起こすときにのみ呼び出してください。 defaultChannel アプリとバンドル暗号化キーIDが異なります ( capacitor.config. |
keyMismatch | vsdevice_key_id コンソールで、デバイスとバンドルキーIDを比較してください。異なるときは、同じキーと一致する __CAPGO_KEEP_0__/プラグインバージョンで公開してください。キーはバージョンによってエンコード方法が異なる場合があります。 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がブロックされています。 |
disablePlatformElectron | 偶然の場合、このチャンネルでElectronを有効にしてルーティングを再公開してください。意図的の場合、ブロックを維持してElectronユーザーを専用チャンネルに送信してください。 | __CAPGO_KEEP_0__ |
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 | 組織は計画/デバイスの制限に達しました |
ダウンロード / インタグリティ / インストールの失敗
| 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_KEEP_0__の実行を計画している場合、__CAPGO_KEEP_0__の概要と接続する必要があります。 「__CAPGO_KEEP_0__の概要」 「APIの概要」でAPIの実装詳細を確認する必要があります。 「APIの概要」 「APIの概要」 導入 __CAPGO_KEEP_0__ の実装詳細については導入を参照してください。 API キー API キーの実装詳細についてはAPI キーを参照してください。 デバイス デバイスの実装詳細についてはデバイスを参照してください。 バンドル バンドルの実装詳細についてはバンドルを参照してください。