ログ

アプリケーションログの理解

Capgoとデバイスの間の動作を理解するために、更新イベントの詳細な履歴と診断情報が必要です。この情報は、更新プロセスの監視、問題のトラブルシューティング、Capgoとデバイスの間の動作を理解するために不可欠です。 アプリケーションをクリックし、次に 「ログ」タブ（以前は「更新」に表示されていました）をクリックします。 ログを表示するページにアクセスするには.

ログページの概要

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

ログタブ

1. - ログビューにアクセスするためのナビゲーションタブ - ログビューにアクセスするためのナビゲーションタブ
2. リロード ボタン - 最新データでログリストを更新します
3. 時間範囲 & アクション フィルタ - 日付範囲とアクションタイプでログをフィルタリングします (以下のセクションを参照)

各行は次の情報を表示します:

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

行をクリックすると、デバイス詳細ページにフル履歴が表示されます。

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

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

日付範囲フィルタ

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

選択した日付範囲を適用するには「選択」をクリックしてください。キャンセルするとログ ピッカーが閉じます。

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

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

アクション フィルタ

利用可能なアクション フィルタには以下のものがあります:

• デバイス ハートビート - デバイスから定期的に健康状態をチェックする
• バージョン削除の要求 - バンドルバージョンが削除されたとき
• デフォルトバージョンに戻す - デバイスが組み込みバンドルに戻ったとき
• バージョンが正常にインストールされました - バンドルインストールに成功しました
• 新しいバージョンがデバイスに送信されました - Capgo がデバイスにアップデートを送信したとき
• バージョンインストールに失敗しました - バンドルインストールに失敗しました

検索BOXを使用して、特定のアクションタイプを迅速に検索できます。複数のアクションを選択して、選択したタイプのいずれかに該当するログを表示できます。

サンプルログスニペット (偽のデータ)

時刻 (UTC)	__CAPGO_KEEP_0__	アクション	バージョン	何が伝えているのか
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	アクション	バージョン	__CAPGO_KEEP_0__
14:30:00	e5f6g7h8	noNew	1.2.0	最新バージョンにすでにアップデート済みです

ロールバック後のアップデート失敗

アップデートが失敗し、デバイスがロールバックした場合

時間	デバイスID	アクション	バージョン	__CAPGO_KEEP_0__
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	Bundle が設定されました
11:15:10	i9j0k1l2	update_fail	1.3.0	アプリがクラッシュしたり、 notifyAppReady() 初期化後に呼び出されなかった場合 - ロールバックがトリガーされました
11:15:11	i9j0k1l2	reset	組み込み	デバイスは組み込みバージョンに戻されました

アクションが必要です: アプリが初期化後に呼び出されていることを確認してください。 notifyAppReady() 詳細はプラグインドキュメントを参照してください。 ダウンロード失敗 「ダウンロード失敗」のセクション

Check that your app calls the plugin after successful initialization. See the plugin documentation for details.

ネットワークの問題でダウンロードができません:

時間	デバイス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 バックエンドのエNUMのログコード

これらのコードは、 stats_action API (capgo/src/types/supabase.types.ts)によって使用されるダッシュボードのエNUMから来ています。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_complete	全バンドルがダウンロードされました
set	バンドルが次の起動時まで準備されています
reset	デバイスが組み込みバンドルに戻されました
delete	バンドルがローカルストレージから削除されました
uninstall	アプリのアンインストールが検出されました
app_moved_to_foreground, app_moved_to_background	SDKによってアプリライフサイクルイベントが記録されました
ping	デバイスからヘルス/ハートビートチェックが行われました
setChannel, getChannel	チャネルがSDKコールによってオーバーライドまたは取得されました

構成またはポリシーがブロックされました

Code(s)	アップデートがブロックされた理由
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	バージョンジャンプはチャネル戦略によって禁止されています
disablePlatformIos, disablePlatformAndroid	このチャネルではプラットフォームが無効になっています
disableDevBuild, disableEmulator	開発用ビルドまたはエミュレータは許可されていません
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	チャネル選択またはオーバーライドが失敗しました
missingBundle, cannotGetBundle	Capgoが提供できないバンドルにマニフェストが参照しています
needPlanUpgrade	組織は計画/デバイスの制限に達しました
rateLimited	SDKがリクエストの制限を超えました; SDKは再起動までスローダウンします
blocked_by_server_url, backend_refusal, InvalidIp	サーバー側のルールがリクエストをブロックしました

ダウンロード/整合性/インストールの失敗

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 に関するより深いガイダンスが必要ですか? 以下の フルログ Code リファレンスとデバッグガイド.

ログの詳細を取得する方法について

特定のログエントリをクリックすると、通常、デバイスのページに移動します。 この機能により、特定のデバイスのフル履歴を確認し、デバイス固有の問題の診断やアップデートの経路を理解するのに役立ちます。編集ページ