ログ

ログとログインサイト

アプリ ログ タブを開きます。 ログの洞察 デフォルトでは使用します。洞察を使用して、1、3、7、または 30 日間の期間でカテゴリ、バージョン、デバイスを優先します。ページの ログ コンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: 短い UI ラベルまたはナビゲーションアイテム。見つける場所: native-build.astro 画面。

サブタブに切り替えると、以下の説明されたデバイスイベント、フィルタ、タイムスタンプを取得できます。

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 画面。 、を選択し、サブタブを選択します。

ログの表示タブ

ログの表示インターフェイスには以下の機能があります。

1. ログサブタブ — ログの各行のナビゲーションコントロール。
2. リロードボタン — 最新のデータでログリストを更新します。
3. 時刻範囲とアクションフィルタ — 時間とアクションでイベントストリームを絞り込む。

各行には以下の情報が表示されます。

• タイムスタンプ (UTC)
• デバイスID
• アクション code (何が起こったか)
• バージョン名 (バンドルまたは) builtin)

デバイスの詳細ページにフルヒストリーを表示するには、その行をクリックしてください。

日付範囲でフィルタリング

日付ピッカーを使用して、特定の時間帯のログをフィルタリングできます。

日付範囲フィルタ

1. クイックプリセット - 1時間、3時間、6時間、または12時間の一般的な時間範囲を選択します。
2. 開始時間 - 時間範囲の開始時間をカスタマイズします。
3. 終了時間 - 時間範囲の終了時間をカスタマイズします。
4. カレンダー - カレンダー画面を使用して特定の日付を選択します。

選択した日付範囲を適用するには「選択」ボタンをクリック、または「キャンセル」ボタンをクリックしてピッカーを閉じます。

アクションタイプによるフィルタリング

アクションのドロップダウンメニューは、ログを特定のイベントタイプでフィルタリングするのに役立ちます。

アクション フィルタ

利用可能なアクション フィルタは次のとおりです。

• デバイス ハートビート - デバイスから定期的に健康状態のチェックが行われます。
• バージョン削除要求 - バンドルのバージョンが削除されたとき
• デフォルトバージョンに戻す - デバイスが組み込みのバンドルに戻ったとき
• バージョンインストールに成功 - バンドルのインストールに成功したとき
• 新バージョンをデバイスに送信 - 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は再起動まで待機します

例としてのログシナリオ

ログが何を示しているか理解するために、実際のデバイスのアップデートの旅を示すシーケンスを以下に示します。

正常なアップデートフロー

ログに正常なアップデートが見られるようにする方法を以下に示します。

時刻	デバイス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	-	このデバイスは、プランをアップグレードするか、請求サイクルがリセットされるまでアップデートを受け取ることができません。

アクションが必要です。: プランをアップグレードしてください。 または、次の請求サイクルを待ってください。

チャネル設定がアップデートをブロックしている場合

チャネル設定がアップデートをブロックしている場合:

時刻	デバイス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_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.

ログコード（__CAPGO_KEEP_0__ バックエンドenum）

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	設定ファイル内のネイティブアプリバージョンが存在しない、または不正な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	Channel auto-update rule is missing required data (version_number without min_update_version).	そのルールまたはシンプルな自動更新モードに切り替えて、欠落している設定を埋めます。
missingBundle	Bundleにはダウンロード可能なペイロードが存在しません (欠落している external_url/r2_path とmanifest)。	バージョンを再構築/再アップロードし、Bundleが実際のファイルコンテンツを持つことを確認してください。
NoChannelOrOverride	このデバイスに該当するチャンネルが存在しません (クラウドデフォルトなし + 設定フォールバックなし + オーバーライドなし)。	デフォルトのチャンネルをダッシュボードに設定するか、テスト defaultChannel をそのビルドに残してください。
rateLimited	短時間に多くの更新/チャンネルコールが発生しています (通常はレンダリングループ) setChannel/getChannel).	ユーザーがアクションを実行するまでに呼び出さないでください。ユーザーがアクションを実行するときにのみ呼び出してください。 defaultChannel The app and bundle encryption key IDs differ ( capacitor.config.
keyMismatch	The app and bundle encryption key IDs differ (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__
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 の完全なログ参照とデバッグガイド.

ログの詳細についてもっと知りたい

特定のログエントリをクリックすると、通常、デバイスのページに移動します。 デバイスの全履歴を確認できます。これは、デバイス固有の問題を診断したり、その更新履歴を理解したりするのに非常に役立ちます。ログから続けてください

ログの詳細についてもっと知りたい

あなたが「ログ」を使用している場合 ログ to plan dashboard and API operations, connect it with API Overview for the implementation detail in API Overview, 「ログ」概要の実装詳細については 「ログ」概要 API Keys for the implementation detail in API Keys, 「ログ」概要の実装詳細については 「ログ」概要の実装詳細については パッケージ パッケージの実装詳細について