ログ

アプリケーションログを理解する

Capgoのアプリケーションに関する詳細な更新イベントの履歴と診断情報を提供するログページは、更新プロセスの監視、問題のトラブルシューティング、Capgoとデバイスの相互作用の理解に不可欠です。 これをアクセスするには アプリケーションをクリック そして.

「ログ」タブ (以前は「更新」に表示されていました) をクリック

ログページの概要

ログページの概要

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	組み込み	デバイスがリクエスト制限に当たった; 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() ダウンロード失敗 ネットワークの問題でダウンロードができなかった場合 ダウンロード失敗

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

タイム	__CAPGO_KEEP_0__	アクション	バージョン	これは何を意味するか
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__:

制限を超えた場合	デバイス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_KEEP_0__を変更してください。.

ログコード (Capgo バックエンド enum)

これらのコードは、 stats_action ダッシュボードで使用されるAPI (capgo/src/types/supabase.types.ts)のenumから来ています。UIで新しいcodeが見られた場合、それはSDKまたはバックエンドによって発行され、このリストと検証されました。

ハッピーパスとライフサイクル

Code(s)	意味
get	デバイスはCapgoから現在のチャネルマニフェストを要求しました
download_manifest_start, download_manifest_complete	マニフェストのダウンロードが始まり/終わりました (deltaまたはマルチファイルバンドル)
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 はリクエストが多すぎるため、再起動までスロットルします
blocked_by_server_url, backend_refusal, InvalidIp	サーバーサイドのルールがリクエストをブロック

ダウンロード / 一貫性 / インストールの失敗

Code(s)	意味
download_fail	__CAPGO_KEEP_0__ のダウンロードが失敗しました (ネットワークまたはレスポンスエラー)
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リファレンスとデバッグガイド.

ログの詳細を取得する

特定のログエントリをクリックすると、通常、ログエントリの詳細に移動します デバイスのページこれにより、特定のデバイスの全履歴を確認できます。これは、デバイス固有の問題の診断やそのアップデートの流れを理解するのに非常に役立ちます。

Keep going from Logs

あなたが「を使用している場合 ログ ダッシュボードとAPIの実行を計画するには、を接続してください。 APIの概要 APIの概要の実装詳細については、 導入 導入の実装詳細については、 APIのキー 実装詳細については API キーを参照してください。 デバイス 実装詳細についてはデバイスを参照してください。 バンドル 実装詳細についてはバンドルを参照してください。