Configurare i dump di arresto anomaloConfigure crash dumps

È possibile configurare facoltativamente i dispositivi Azure Sphere in modo che vengano segnalati i dump di arresto anomalo della modalità utente completi quando si verifica un arresto anomalo del sistema operativo o dell'applicazioneAzure Sphere devices can be optionally configured so that full user-mode crash dumps are reported when an OS or application crash occurs. Queste informazioni vengono usate per migliorare la qualità del sistema operativo Azure Sphere per tutti i dispositivi Azure Sphere.This information is used to improve the quality of Azure Sphere OS for all Azure Sphere devices.

Il diagramma seguente illustra le fasi della raccolta dei dump di arresto anomalo del sistema:The following diagram illustrates the stages of crash dump collection:

Flusso di lavoro dump di arresto anomalo

FaseStage DescrizioneDescription
1.1. Abilitare la raccolta dei dump di arresto anomalo per uno o più gruppi di dispositivi.Enable crash dump collection for one or more of your device groups. Se si sceglie di abilitare la raccolta dei dump di arresto anomalo del sistema per un gruppo di dispositivi, significa che è stato fornito il consenso per la raccolta, il caricamento e l'analisi dei dump di arresto anomalo in modalità utente.If you choose to enable crash dump collection for a device group, it indicates that you have provided consent for user-mode crash dumps to be gathered, uploaded, and analyzed.
Nota: Se l'app raccoglie dati personali dagli utenti finali, è necessario ottenere il consenso prima di abilitare i dump di arresto anomalo del sistema per tali dispositivi.Note: If your app collects personal data from end users, you should obtain consent from them before enabling crash dumps for those devices.
2.2. Il servizio di sicurezza Azure Sphere sincronizza lo stato di consenso esplicito con i dispositivi entro 48 ore.The Azure Sphere Security service will synchronize the opt-in status with your devices within 48 hours. I dump di arresto anomalo del sistema non vengono mai generati a meno che un dispositivo non abbia ricevuto il segnale di consenso esplicito.Crash dumps are never generated unless a device has received the opt-in signal. Se un dispositivo non contatta il Azure Sphere servizio di sicurezza in questo periodo di tempo, il dispositivo smette automaticamente di generare i dump di arresto anomalo del sistema fino a quando lo stato di consenso esplicito non viene sincronizzato con il servizio di sicurezza Azure Sphere.If a device does not contact the Azure Sphere Security Service in this time period, the device will automatically stop generating crash dumps until the opt-in status is successfully synchronized with the Azure Sphere Security Service again.
3.3. Se sono abilitati i dump di arresto anomalo del sistema, quando si verifica un arresto anomalo di un componente o di un'applicazione del sistema operativo, il dispositivo tenta di caricare un dump di arrestoIf crash dumps are enabled, when an OS component or application crashes, the device attempts to upload a crash dump to a secure location. Una volta caricato in modo sicuro, i dati non lasciano il percorso protetto.Once securely uploaded, the data does not leave the secure location.
4.4. I dati sono accessibili solo per la risoluzione dei problemi del team di Azure Sphere, tramite sessioni sicure, remote e completamente controllate.The data is accessible only for troubleshooting by the Azure Sphere team, through secure, remote, fully audited sessions.

Considerazioni sulla privacyPrivacy considerations

  • I dump di arresto anomalo del sistema da tutti i dispositivi Azure Sphere vengono archiviati in modo sicuro nei data center Stati Uniti orientali o Stati Uniti occidentali.Crash dumps from all Azure Sphere devices are securely stored in East US or West US data centers only. L'archiviazione dei dati dei clienti in un'area o in una data center diversa non è supportata.Storing customer data in a different region or data center is not supported.
  • I dati del dump di arresto anomalo del sistema vengono archiviati in conformità con tutte le leggi e le normative applicabili, incluso GDPR, e vengono eliminati dopo 29 giorni.Crash dump data is stored in compliance with all applicable laws and regulations, including GDPR, and is deleted after 29 days.

Considerazioni sulle prestazioniPerformance considerations

  • Le dimensioni di caricamento del dump di arresto anomalo del sistema variano in genere da pochi KiB a decine di KiB.Crash dump upload size typically ranges from a few KiB to tens of KiB.
  • I criteri di limitazione intelligente garantiscono il caricamento di un dump di arresto anomalo del sistema solo quando necessario per ridurre al minimo gli effetti sulle prestazioni e sulla larghezza di banda nei dispositivi.Intelligent throttling policies ensure a crash dump upload is initiated only when necessary to minimize performance and bandwidth effects on your devices. Questa limitazione intelligente viene eseguita automaticamente e non richiede alcuna azione.This intelligent throttling happens automatically and requires no action. Il caricamento del dump di arresto anomalo del sistema verrà ignorato dopo che è già stato raccolto un numero sufficiente di dump da arresti anomali identici.Crash dump upload will be skipped after a sufficient number of dumps from identical crashes have already been collected.
  • Quando un'applicazione si arresta in modo anomalo, il dispositivo tenterà di caricare in modo sicuro un dump di arresto anomalo, se abilitato.When an application crashes, the device will attempt to securely upload a crash dump, if enabled. L'applicazione in arresto anomalo verrà riavviata dopo il completamento del caricamento del dump di arresto anomalo del sistema.The crashing application will be restarted after the crash dump upload is complete. Nel caso in cui non sia possibile stabilire una connessione di rete per il caricamento e il dispositivo non risponda entro il periodo di timeout di 5 secondi, l'applicazione arrestata in modo anomalo viene riavviata tempestivamente.In the event that a network connection cannot be established for the upload, and the device does not respond within the 5 second time out period, the crashed application is restarted promptly.

Abilita la raccolta di dump di arresto anomaloEnable crash dump collection

I dump di arresto anomalo del sistema non sono abilitati per impostazione predefinita.Crash dumps are not enabled by default. È possibile abilitarli manualmente nel AllowCrashDumpsCollection campo corpo della richiesta nell'API gruppo di dispositivi-patch .You can manually enable them in the AllowCrashDumpsCollection request body field in the Device Group - Patch API. La disabilitazione dei dump di arresto anomalo per tutti i gruppi di dispositivi equivale alla revoca del consenso.Disabling crash dumps for all device groups is equivalent to revoking consent.

Nota

  • Per modificare il AllowCrashDumpsCollection campo, è necessario il ruolo amministratore.Changing the AllowCrashDumpsCollection field requires the Administrator role.

  • Una risposta 500 (errore interno del server) quando si aggiorna il AllowCrashDumpsCollection campo indica in genere un errore temporaneo.A 500 (Internal Server Error) response when updating the AllowCrashDumpsCollection field usually indicates a transient error. In questo caso, si consiglia di ripetere l'operazione.We recommend that you retry the operation in this case. Se si continua a ricevere l'errore, contattare il rappresentante Microsoft.If you continue to receive the error, please contact your Microsoft representative.

Script per configurare i dump di arresto anomalo del sistemaScript to configure crash dumps

Viene fornito uno script di esempio che è possibile usare per GET effettuare PATCH chiamate o all'API Azure Sphere per visualizzare o modificare il AllowCrashDumpsCollection valore per uno o più gruppi di dispositivi.We provide a sample script that you can use to make GET or PATCH calls to the Azure Sphere API to view or modify the AllowCrashDumpsCollection value for one or many device groups. Per altre informazioni, vedere configurazione dello script di dump di arresto anomalodel sistema.For more information, see Crash Dumps Configure Script.

Vedere ancheSee Also

Maggiore trasparenza e controllo dei dati sui datiIncreasing transparency and customer control over data