Hoe gebeurtenissen te gebruiken voor foutverwerking

Belangrijk

Visual Studio App Center is op 31 maart 2025 buiten gebruik gesteld, met uitzondering van de functies analyse en diagnose, die tot 30 juni 2026 nog steeds worden ondersteund. Meer informatie.

Belangrijk

Afgehandelde fouten zijn nog niet beschikbaar als onderdeel van de service Crashes in App Center. Een tijdelijke oplossing is gebruikmaken van aangepaste gebeurtenissen. Dit is niet de manier waarop 'Afgehandelde fouten' zijn bedoeld om te worden ondersteund en het is ook niet het belangrijkste doel van gebeurtenissen. Deze pagina bevat echter advies over het beste gebruik van gebeurtenissen om te rapporteren over afgehandelde fouten.

In deze sectie leert u hoe u gebeurtenissen gebruikt om informatie over uw afgehandelde fouten op te halen. Dergelijke gebeurtenissen voor afgehandelde fouten zijn handig als u geïnteresseerd bent in het tellen van het aantal keren dat er een fout is opgetreden. U krijgt zes verschillende metingen per gebeurtenis: aantal, aantal wijzigingen, gebruikers, gebruikerswijziging, aantal per gebruiker en aantal per sessie.

Gebeurtenisnaam

U wordt aangeraden de gebeurtenis een naam te geven die contextuele informatie bevat. Afgehandelde fouten kunnen algemeen zijn, dus het is nodig om wat extra informatie op te geven waarmee een fout op een duidelijkere manier wordt geïdentificeerd. Een voorbeeld van contextuele informatie is de naam van het bestand/de methode waarin de fout wordt verwerkt.

Voorbeeld:

Stel dat u wilt weten hoe vaak uw gebruikers geen verbinding kunnen maken met wi-fi. "UnknownHostException:ConnectWiFi", waarbij "UnknownHostException" de algemene naam van de uitzondering is en "ConnectWiFi" de naam van de methode is.

Gebeurteniseigenschappen

Als u meer wilt weten over de distributie van deze afgehandelde fouten voor verschillende kenmerken (bijvoorbeeld apparaattype, besturingssysteemversie, buildnummer of fabrikant), kunt u de eigenschappen en eigenschapswaarden gebruiken.

Voorbeeld:

Eigenschapssleutel: besturingssysteemversie

Eigenschapswaarde 1: 10.2.1

Eigenschapswaarde 2: 10.3

Eigenschapswaarde 3: 9.3.5

Afhankelijk van uw specifieke use-case kunt u deze in plaats daarvan opnemen als onderdeel van de gebeurtenisnaam. Het aantal gebeurtenisnamen is echter beperkt tot 200. Het is belangrijk om te weten wat u wilt beantwoorden om de meeste waarde te krijgen van het gebruik van gebeurtenissen voor afgehandelde fouten. Als u wilt filteren op versie, hoeft u deze niet op te nemen als onderdeel van de eigenschap, omdat u de vervolgkeuzelijst in de rechterbovenhoek van de gebeurtenispagina kunt gebruiken.

Gebruik de lijst APP-VERSIES om te selecteren welke versie of welke versies u wilt rapporteren

Als u het uitzonderingsbericht wilt opnemen, kunt u het opnemen als een andere eigenschap.

Voorbeeld:

Eigenschapssleutel: Uitzonderingsbericht

Eigenschapswaarde: Uitzondering in thread 'main' java.lang.RuntimeException

Het aantal tekens in de eigenschapswaarden is beperkt tot 64 tekens, dus waarschijnlijk moet u de tekenreeks afkappen of filteren. Ten slotte zou u de stack trace niet opnemen als onderdeel van de gebeurtenisnaam of eigenschapswaarden om dezelfde reden.