クラッシュダンプを構成する

[アーティクル]
03/25/2024

必要に応じて、OS またはアプリケーションのクラッシュが発生したときに完全なユーザーモードのクラッシュダンプが Microsoft に報告されるように、Azure Sphere デバイスを構成できます。 Microsoft では、この情報を使用して、すべての Azure Sphere デバイスの Azure Sphere OS の品質を向上させます。

次の図は、クラッシュダンプ収集のステージを示しています。

クラッシュダンプワークフロー

段階	説明
1.	1 つ以上のデバイスグループに対してクラッシュダンプ収集を有効にします。デバイスグループに対してクラッシュダンプ収集を有効にした場合は、ユーザーモードのクラッシュダンプを収集、アップロード、および分析するための同意が提供されていることを示します。メモ：アプリがエンドユーザーから個人データを収集する場合は、それらのデバイスのクラッシュダンプを有効にする前に、ユーザーから同意を得る必要があります。
2.	Azure Sphere Security サービスは、48 時間以内にオプトイン状態をデバイスと同期します。デバイスがオプトイン信号を受信しない限り、クラッシュダンプは生成されません。この期間中にデバイスが Azure Sphere Security Service に接続しない場合、オプトイン状態が Azure Sphere Security Service と正常に同期されるまで、デバイスはクラッシュダンプの生成を自動的に停止します。
3.	クラッシュダンプが有効になっている場合、OS コンポーネントまたはアプリケーションがクラッシュすると、デバイスはセキュリティで保護された場所にクラッシュダンプをアップロードしようとします。安全にアップロードされると、データは安全な場所から離れることはありません。
4.	データには、セキュリティで保護されたリモートで完全に監査されたセッションを通じて、Azure Sphere チームによるトラブルシューティングにのみアクセスできます。

プライバシーに関する考慮事項

すべての Azure Sphere デバイスからのクラッシュダンプは、米国東部、米国西部、および EU のデータセンターに安全に格納されます。 EU のお客様は、地域データ境界設定パラメーター EUをに設定することで、アプリケーションイメージとクラッシュダンプファイルが EU 内でのみ処理および格納されるようにすることができます。

メモ

[リージョンデータ境界] 設定をに None設定した場合、クラッシュダンプファイルは既定で米国東部または米国西部に格納されます。
クラッシュダンプデータは、GDPR を含むすべての適用される法律と規制に準拠して格納され、29 日後に削除されます。

パフォーマンスに関する考慮事項

クラッシュダンプのアップロードサイズは、通常、数 KiB から数十 KiB の範囲です。
インテリジェントな調整ポリシーにより、デバイスのパフォーマンスと帯域幅の影響を最小限に抑えるために必要な場合にのみ、クラッシュダンプのアップロードが開始されます。このインテリジェントな調整は自動的に行われ、アクションは必要ありません。クラッシュダンプのアップロードは、同一のクラッシュから十分な数のダンプが既に収集された後にスキップされます。
アプリケーションがクラッシュすると、デバイスはクラッシュダンプを安全にアップロードしようとします (有効な場合)。クラッシュダンプのアップロードが完了すると、クラッシュするアプリケーションが再起動されます。アップロードのためにネットワーク接続を確立できず、デバイスが 5 秒のタイムアウト期間内に応答しない場合、クラッシュしたアプリケーションは速やかに再起動されます。

クラッシュダンプ収集を有効にする

クラッシュダンプは既定では有効になっていません。 az sphere device-group update コマンドAllowCrashDumpsCollectionまたは Device Group - Patch API の要求本文フィールドを使用して、クラッシュダンプ収集を有効にすることに同意できます。

たとえば、次の CLI コマンドはクラッシュダンプ収集を有効にし、クラッシュダンプデータを EU に格納することを指定します。

az sphere device-group update --product DW100 --device-group Marketing --allow-crash-dumps-collection Enabled  --regional-data-boundary EU

CLI からのクラッシュダンプ収集を無効にするには、をに設定 --allow-crash-dumps-collection します "Disabled"。

az sphere device-group update --product DW100 --device-group Marketing --allow-crash-dumps-collection "Disabled"

すべてのデバイスグループのクラッシュダンプを無効にすることは、同意の取り消しと同じです。