Konfigurera kraschdumpar
Viktigt!
Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).
Azure Sphere-enheter kan konfigureras valfritt så att fullständiga kraschdumpar i användarläge rapporteras till Microsoft när ett operativsystem eller en programkrasch inträffar. Microsoft använder den här informationen för att förbättra kvaliteten på Azure Sphere OS för alla Azure Sphere-enheter.
Följande diagram illustrerar stegen i samlingen med kraschdumpar:
| Fas | beskrivning |
|---|---|
| 1. | Aktivera insamling av kraschdumpar för en eller flera av dina enhetsgrupper. Om du väljer att aktivera insamling av kraschdumpar för en enhetsgrupp anger det att du har gett sitt medgivande till att kraschdumpar i användarläge ska samlas in, laddas upp och analyseras. Obs! Om din app samlar in personuppgifter från slutanvändare bör du få medgivande från dem innan du aktiverar kraschdumpar för dessa enheter. |
| 2. | Azure Sphere Security-tjänsten synkroniserar anmälningsstatusen med dina enheter inom 48 timmar. Kraschdumpar genereras aldrig om inte en enhet har fått anmälningssignalen. Om en enhet inte kontaktar Azure Sphere Security Service under den här tidsperioden slutar enheten automatiskt att generera kraschdumpar tills statusen för anmälning har synkroniserats med Azure Sphere Security Service igen. |
| 3. | Om kraschdumpar är aktiverade, när en OS-komponent eller ett program kraschar, försöker enheten ladda upp en kraschdump till en säker plats. När data har laddats upp på ett säkert sätt lämnar de inte den säkra platsen. |
| 4. | Data är endast tillgängliga för felsökning av Azure Sphere-teamet via säkra, fjärranslutna, fullständigt granskade sessioner. |
Sekretessöverväganden
Kraschdumpar från alla Azure Sphere-enheter lagras säkert i datacenter i USA, östra, USA, västra och EU. Kunder i EU kan se till att deras programbilder och kraschdumpfiler bearbetas och lagras enbart inom EU genom att ange parametern Regional datagränsinställning till
EU.Kommentar
Om du anger inställningen Regional datagräns till
Nonelagras kraschdumpfilerna i USA, östra eller usa, västra som standard.Kraschdumpdata lagras i enlighet med alla tillämpliga lagar och förordningar, inklusive GDPR, och tas bort efter 29 dagar.
Prestandaöverväganden
- Uppladdningsstorleken för kraschdumpar varierar vanligtvis från några KiB till tiotals KiB.
- Intelligenta begränsningsprinciper säkerställer att en uppladdning av kraschdumpar endast initieras när det behövs för att minimera prestanda- och bandbreddseffekter på dina enheter. Den här intelligenta begränsningen sker automatiskt och kräver ingen åtgärd. Uppladdning av kraschdumpar hoppas över efter att ett tillräckligt antal dumpar från identiska krascher redan har samlats in.
- När ett program kraschar försöker enheten på ett säkert sätt ladda upp en kraschdump om den är aktiverad. Det kraschande programmet startas om när uppladdningen av kraschdumpar har slutförts. Om det inte går att upprätta en nätverksanslutning för uppladdningen och enheten inte svarar inom 5 sekunders tidsgräns startas det kraschade programmet omgående.
Aktivera insamling av kraschdumpar
Kraschdumpar är inte aktiverade som standard. Du kan ge medgivande till att aktivera insamling av kraschdumpar med hjälp av kommandot azsphere device-group update eller i AllowCrashDumpsCollection fältet begärandetext i API:et Device Group - Patch.
Följande CLI-kommando aktiverar till exempel insamling av kraschdumpar och anger att kraschdumpdata ska lagras i EU.
azsphere device-group update --device-group DW100/Marketing --allow-crash-dumps-collection "On" --regional-data-boundary "EU"
Om du vill inaktivera insamling av kraschdumpar från CLI anger du --allow-crash-dumps-collection till "Off".
azsphere device-group update --device-group DW100/Marketing --allow-crash-dumps-collection "Off"
Att inaktivera kraschdumpar för alla enhetsgrupper motsvarar återkallande av medgivande.
Kommentar
Om du ger medgivande för att aktivera insamling av kraschdumpar krävs rollen Administratör.
Ett svar på 500 (internt serverfel) vid uppdatering av
AllowCrashDumpsCollectionfältet indikerar vanligtvis ett tillfälligt fel. Vi rekommenderar att du försöker utföra åtgärden igen i det här fallet. Om du fortsätter att få felet kontaktar du din Microsoft-representant.
Skript för att konfigurera kraschdumpar
Vi tillhandahåller ett exempelskript som du kan använda för att göra GET eller PATCH anropa Azure Sphere-API:et AllowCrashDumpsCollection för att visa eller ändra värdet för en eller flera enhetsgrupper. Mer information finns i Crash Dumps Configure Script in the Azure Sphere Gallery, a collection of unmaintained scripts, utilities, and functions .