Diagnosefeatures
Wichtig
Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.
In diesem Abschnitt erfahren Sie mehr über die für den Diagnosedienst von App Center verfügbaren Features.
Absturz- und Fehleranalyse
In der App Center-Diagnose können Sie automatisch von App Center generierte Analysedaten anzeigen, um zu verstehen, wann ein Absturz oder Fehler in Ihrer App auftritt.
Standardmäßig werden in App Center Abstürze und Fehler pro Tag für eine App nebeneinander angezeigt.
Führen Sie über die Registerkarten oben links einen Drilldown zu Abstürzen und Fehlern aus. Wenn Sie dies tun, gibt das linke Diagramm die Anzahl der Abstürze/Fehler pro Tag an, und das rechte Diagramm zeigt die Anzahl der betroffenen Benutzer an. Filtern Sie die Diagramme nach App-Version, Zeitrahmen und status, um eine fokussiertere Ansicht zu erstellen.
Hinweis
App Center filtert potenziell vertrauliche Informationen. Beispiele für vertrauliche Informationen, die gefiltert werden, sind URLs, JSON-Zeichenfolgen und Anforderungs-IDs.
Gruppierung
App Center-Diagnosegruppen stürzen und Fehler nach Ähnlichkeiten, z. B. Ursache für das Problem und Ort des Auftretens des Problems in der App. Für jede Absturz- und Fehlergruppe zeigt App Center die Codezeile, die fehlgeschlagen ist, den Namen der Klasse oder Methode, den Dateinamen, die Zeilennummer, den Absturz oder den Fehlertyp und die Meldung an, damit Sie diese Gruppen auf einen Blick besser verstehen können. Wählen Sie eine Gruppe aus, um weitere Informationen anzuzeigen, und greifen Sie auf eine Liste detaillierter Problemberichte und Protokolle zu. Auf diese Weise können Sie noch tiefer in die Tiefe eintauchen und unseren Featuresatz verwenden, um das Verhalten Ihrer App während eines Absturzes oder eines Fehlers besser zu verstehen.
Wenn ein Absturz durch einen fehlgeschlagenen Aufruf einer URL verursacht wird (z. B. "Fehler beim Aufrufen von azure.com oder google.com"), kann App Center Abstürze nach dieser URL gruppieren (z. B. alle fehlgeschlagenen Aufrufe azure.com werden gruppiert und nicht aufgerufen, google.com gruppiert wird). Da wir jedoch URLs entfernen, die entweder mit HTTP oder HTTPS vorangestellt sind, aus dem Absturzprotokoll, funktioniert diese Gruppierung nur, wenn diese Syntax vermieden wird, z. B.: "Fehler beim Aufrufen http://azure.com"von ; wird nicht mit anderen Azure-Aufrufen gruppiert, aber "Fehleraufruf azure.com" wird mit ähnlichen Fehlerberichten gruppiert.
Benutzeridentifikation
Mit der App Center-Diagnose können Sie Eine Benutzer-ID an Ihre Abstürze und Fehler anfügen. Verwenden Sie dazu das App Center SDK in Ihrer Zielplattform Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms und MAUI/Xamarin. Sie finden die Benutzer-ID, die mit einem Absturz oder Fehler verknüpft ist, wenn Sie auf ein Problem innerhalb einer Gruppe klicken.
Nach dem Anfügen einer Benutzer-ID können Sie die Suchfunktion von App Center verwenden, um mit der angegebenen ID nach Abstürze zu suchen. Informationen dazu finden Sie in der App Center-Suchdokumentation.
Attachments
Auf der Benutzeroberfläche der App Center-Diagnose können Sie Binär- und Textanlagen Ihrer Absturz- und Fehlerberichte anzeigen und herunterladen.
Sie können erfahren, wie Sie Ihren Absturzberichten Anlagen hinzufügen, indem Sie die SDK-Dokumentation zu Abstürze für Ihre Android-, iOS-, macOS-, React Native-, UWP-, WPF-/WinForms- und MAUI/Xamarin-Apps lesen.
Anlagen für behandelte Fehler werden nur für Android-, Unity-, UWP-, WPF-, WinForms- und Xamarin-Plattformen unterstützt. In der SDK-Dokumentation für Ihre Android-, Unity-, UWP-, WPF-/WinForms- und MAUI/Xamarin-Apps erfahren Sie, wie Sie Ihren Fehlerberichten Anlagen hinzufügen.
Um die Anlagen anzuzeigen und herunterzuladen, wählen Sie eine Absturz- oder Fehlergruppe und einen bestimmten Gerätebericht aus, und klicken Sie dann auf die Registerkarte Anlagen.
Ereignisse vor einem Absturz
Verfolgen Sie Ereignisse, die zu einem Absturz führen, um nützliche Informationen zum Zustand Ihrer App zu erfassen.
Informationen zum Definieren eines benutzerdefinierten Ereignisses finden Sie in der SDK-Dokumentation für Android, iOS, macOS, React Native, Windows und MAUI/Xamarin.
Um Ereignisse vor einem Absturz anzuzeigen, wählen Sie eine Absturzgruppe und einen bestimmten Gerätebericht aus, und klicken Sie dann auf die Registerkarte Ereignisse.
Schlüssel-Wert-Paare
Sie können an App Center gesendete Fehlerberichte anpassen, um zusätzlichen Kontext für den Fehler einzuschließen, indem Sie ein Wörterbuch mit Zeichenfolgenwerten (als Schlüssel-Wert-Paare) an die TrackError
-Methode übergeben. Diese Eigenschaften sind optional. Informationen zum Festlegen von Schlüsselwertpaaren finden Sie in der Dokumentation zu Android, MAUI/Xamarin, Unity, UWP und WPF/WinForms .
Hinweis
Dieses Feature wird derzeit nur für Android-, iOS-, Xamarin-, React Native-, Unity-, UWP-, WinForms- und WPF-Fehler unterstützt.
Exportieren von Diagnosedaten
App Center kann Diagnose Rohdaten (Abstürze und Fehler) nach Azure exportieren. Exportieren Sie Diagnose Daten zur Anpassung der Daten in Blob Storage.
Um Abstürze, Anlagen und Fehler zu exportieren, müssen Sie die API für Exportkonfigurationen aufrufen:
POST /v0.1/apps/{owner_name}/{app_name}/export_configurations
exportEntities
Im Feld der API-Eigenschaft müssen Sie angeben, welche Art von Daten Sie exportieren möchten: Abstürze, Fehler, Anlagen. Dabei werden die vollständigen symbolischen Abstürze und die entsprechenden Stapelüberwachungen exportiert.
Weitere Informationen zu den Vorteilen und zum Exportieren Ihrer Daten finden Sie in der Exportdokumentation.
Threads
In einem Absturzbericht werden die aktuellen Threads angezeigt, die beim Absturz der App aktiv waren. Der abgestürzte Thread ist rot hervorgehoben, damit Sie den Status der App besser verstehen können.
Hinweis
Unter Windows zeigt der Bericht nur die Stapelüberwachung aus dem abgestürzten Thread an. Das Anzeigen des Status anderer Threads zum Zeitpunkt des Absturzes wird unter Windows nicht unterstützt.
Warnungen konfigurieren
Behalten Sie den Überblick über Ihre Abstürze, indem Sie ihre App Center-App-Definitionseinstellungen so konfigurieren, dass eine E-Mail-Benachrichtigung gesendet wird. Sie können diese Einstellung pro App konfigurieren, um entweder sofort eine E-Mail zu senden, wenn eine neue Absturzgruppe erstellt wird, oder eine tägliche Zusammenfassungs-E-Mail mit den wichtigsten Abstürze Ihrer App zu senden. So konfigurieren Sie diese Warnungen
- Melden Sie sich beim App Center an, und wählen Sie Ihre App aus.
- Navigieren Sie im linken Menü zu Einstellungen.
- Klicken Sie auf Email Benachrichtigungen.
- Wählen Sie Sofort, Täglich oder Nie aus. Die Standardkonfiguration ist auf Nie festgelegt.
Weitere Informationen zu Benachrichtigungen finden Sie in unserer App Center-Dashboard-Dokumentation.
Erstellen einer Fehlernachverfolgung
Sie können Bugtrackertools von Drittanbietern in App Center integrieren, um auf dem Laufenden zu bleiben und Abstürze besser zu verwalten. Lesen Sie die Dokumentation zum Bugtracker, um sich über die ersten Schritte zu informieren.
Hochladen von Berichten in App Center
Die Dokumentation zum Hochladen von Abstürze über die API wurde verschoben.