Crashdumps configureren
Belangrijk
Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.
Azure Sphere-apparaten kunnen optioneel worden geconfigureerd, zodat volledige crashdumps voor de gebruikersmodus worden gerapporteerd aan Microsoft wanneer een besturingssysteem of toepassing vastloopt. Microsoft gebruikt deze informatie om de kwaliteit van het Azure Sphere-besturingssysteem voor alle Azure Sphere-apparaten te verbeteren.
In het volgende diagram ziet u de fasen van crashdumpverzameling:
| Fase | Beschrijving |
|---|---|
| 1. | Schakel crashdumpverzameling in voor een of meer van uw apparaatgroepen. Als u ervoor kiest om crashdumpverzameling in te schakelen voor een apparaatgroep, geeft dit aan dat u toestemming hebt gegeven voor crashdumps in de gebruikersmodus die moeten worden verzameld, geüpload en geanalyseerd. Opmerking: Als uw app persoonlijke gegevens verzamelt van eindgebruikers, moet u toestemming van hen verkrijgen voordat u crashdumps voor deze apparaten inschakelt. |
| 2. | De Azure Sphere-beveiligingsservice synchroniseert de aanmeldingsstatus met uw apparaten binnen 48 uur. Crashdumps worden nooit gegenereerd, tenzij een apparaat het aanmeldingssignaal heeft ontvangen. Als een apparaat in deze periode geen contact opneemt met de Azure Sphere-beveiligingsservice, stopt het apparaat automatisch met het genereren van crashdumps totdat de aanmeldingsstatus opnieuw is gesynchroniseerd met de Azure Sphere-beveiligingsservice. |
| 3. | Als crashdumps zijn ingeschakeld wanneer een besturingssysteemonderdeel of toepassing vastloopt, probeert het apparaat een crashdump te uploaden naar een veilige locatie. Zodra de gegevens veilig zijn geüpload, blijven de beveiligde locatie niet achter. |
| 4. | De gegevens zijn alleen toegankelijk voor probleemoplossing door het Azure Sphere-team, via beveiligde, externe, volledig gecontroleerde sessies. |
Privacyoverwegingen
Crashdumps van alle Azure Sphere-apparaten worden veilig opgeslagen in datacenters vs - oost, VS - west en EU. Klanten in de EU kunnen ervoor zorgen dat hun toepassingsinstallatiekopieën en crashdumpbestanden uitsluitend binnen de EU worden verwerkt en opgeslagen door de parameter voor regionale gegevensgrensinstelling in te stellen op
EU.Notitie
Als u de instelling
NoneRegionale gegevensgrens instelt op, worden uw crashdumpbestanden standaard opgeslagen in VS - oost of VS - west.Crashdumpgegevens worden opgeslagen in overeenstemming met alle toepasselijke wetten en regelgeving, inclusief AVG, en worden na 29 dagen verwijderd.
Prestatieoverwegingen
- De grootte van het uploaden van crashdumps varieert doorgaans van een paar KiB tot tientallen KiB.
- Intelligente beperkingsbeleidsregels zorgen ervoor dat een upload van crashdumps alleen wordt gestart wanneer dit nodig is om de prestaties en bandbreedte-effecten op uw apparaten te minimaliseren. Deze intelligente beperking vindt automatisch plaats en vereist geen actie. Uploaden van crashdumps wordt overgeslagen nadat er al voldoende dumps van identieke crashes zijn verzameld.
- Wanneer een toepassing vastloopt, probeert het apparaat een crashdump veilig te uploaden, indien ingeschakeld. De crashtoepassing wordt opnieuw gestart nadat het uploaden van de crashdump is voltooid. In het geval dat er geen netwerkverbinding tot stand kan worden gebracht voor het uploaden en het apparaat niet reageert binnen de periode van vijf seconden, wordt de vastgelopen toepassing onmiddellijk opnieuw opgestart.
Crashdumpverzameling inschakelen
Crashdumps zijn niet standaard ingeschakeld. U kunt toestemming geven om crashdumpverzameling in te schakelen met behulp van de opdracht azsphere device-group update of in het AllowCrashDumpsCollection veld aanvraagbody in de Patch-API van de apparaatgroep.
Met de volgende CLI-opdracht kunt u bijvoorbeeld crashdumpverzameling inschakelen en geeft u op dat crashdumpgegevens worden opgeslagen in de EU.
azsphere device-group update --device-group DW100/Marketing --allow-crash-dumps-collection "On" --regional-data-boundary "EU"
Als u het verzamelen van crashdumps vanuit de CLI wilt uitschakelen, stelt u deze in --allow-crash-dumps-collection op "Off".
azsphere device-group update --device-group DW100/Marketing --allow-crash-dumps-collection "Off"
Het uitschakelen van crashdumps voor alle apparaatgroepen is gelijk aan het intrekken van toestemming.
Notitie
Als u toestemming geeft om crashdumpverzameling in te schakelen, is de beheerdersrol vereist.
Een antwoord van 500 (interne serverfout) bij het bijwerken van het
AllowCrashDumpsCollectionveld duidt meestal op een tijdelijke fout. U wordt aangeraden de bewerking in dit geval opnieuw uit te voeren. Als u de fout blijft ontvangen, neemt u contact op met uw Microsoft-vertegenwoordiger.
Script voor het configureren van crashdumps
We bieden een voorbeeldscript dat u kunt gebruiken om de Azure Sphere-API te maken GET of PATCH aan te roepen om de AllowCrashDumpsCollection waarde voor een of veel apparaatgroepen weer te geven of te wijzigen. Zie CrashDumps Configure Script in de Azure Sphere Gallery, een verzameling niet-gecodeerde scripts, hulpprogramma's en functies voor meer informatie.