영어로 읽기

다음을 통해 공유


진단 기능

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아보세요.

이 섹션에서는 App Center의 진단 서비스에 사용할 수 있는 기능 집합에 대해 알아봅니다.

크래시 및 오류 분석

App Center 진단에서 App Center에서 자동으로 생성된 분석 데이터를 보고 앱에서 충돌 또는 오류가 발생하는 시기를 파악할 수 있습니다.

기본적으로 App Center는 매일 앱의 크래시 및 오류를 나란히 보기로 표시합니다.

왼쪽 위 탭을 사용하여 크래시 및 오류로 드릴다운합니다. 이렇게 하면 왼쪽 차트는 일별 크래시/오류 수를 나타내고 오른쪽 차트는 영향을 받는 사용자 수를 표시합니다. 앱 버전, 시간 프레임 및 상태 기준으로 차트를 필터링하여 보다 집중적인 보기를 만듭니다.

참고

App Center는 잠재적으로 중요한 정보를 필터링합니다. 필터링할 중요한 정보의 예로는 URL, JSON 문자열 및 요청 ID가 있습니다.

App Center에서 충돌 및 오류에 대한 분석을 보여 줍니다.

그룹화

App Center 진단 그룹은 문제의 이유 및 앱에서 문제가 발생한 위치와 같은 유사점별로 충돌 및 오류를 그룹화합니다. 각 크래시 및 오류 그룹에 대해 App Center는 실패한 코드 줄, 클래스 또는 메서드 이름, 파일 이름, 줄 번호, 크래시 또는 오류 유형 및 메시지를 표시하여 이러한 그룹을 한눈에 더 잘 이해할 수 있습니다. 그룹을 선택하여 자세한 정보를 보고 자세한 문제 보고서 및 로그 목록에 액세스합니다. 이를 통해 더 심층 분석하고 기능 집합을 사용하여 충돌 또는 오류 발생 시 앱의 동작을 더 잘 이해할 수 있습니다.

URL에 대한 호출 실패(예: "azure.com 또는 google.com 호출 오류")로 인해 충돌이 발생하는 경우 App Center는 해당 URL별로 크래시를 그룹화할 수 있습니다(예를 들어 모든 호출에 실패한 azure.com 그룹화되고 google.com 함께 그룹화되지 않음). 그러나 크래시 로그에서 HTTP 또는 HTTPS가 앞에 추가된 URL을 제거하기 때문에 이 그룹화는 이 구문을 피할 때만 작동합니다. 예를 들어 "를 호출 http://azure.com"하는 동안 오류가 발생했습니다. 는 다른 Azure 호출과 함께 그룹화되지 않지만 "azure.com 호출하는 오류"는 유사한 오류 보고서와 함께 그룹화됩니다.

App Center는 유사성에 따라 충돌 및 오류를 그룹화합니다.

사용자 식별

App Center 진단을 사용하면 사용자 ID를 크래시 및 오류에 연결할 수 있습니다. 이렇게 하려면 대상 플랫폼 Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinFormsMAUI/Xamarin에서 App Center SDK를 사용합니다. 그룹 내에서 문제를 클릭할 때 크래시 또는 오류와 관련된 사용자 ID를 찾을 수 있습니다.

사용자 ID를 연결한 후 App Center의 검색 기능을 사용하여 지정된 ID로 크래시를 검색할 수 있습니다. App Center의 검색 설명서에 따라 이 작업을 수행하는 방법을 알아봅니다.

Attachments

App Center 진단 UI에서 크래시 및 오류 보고서의 이진 및 텍스트 첨부 파일을 보고 다운로드할 수 있습니다.

Android, iOS, macOS, React Native, UWP, WPF/WinFormsMAUI/Xamarin 앱에 대한 SDK 크래시 설명서를 읽고 크래시 보고서에 첨부 파일을 추가하는 방법을 알아볼 수 있습니다.

처리된 오류에 대한 첨부 파일은 Android, Unity, UWP, WPF, WinForms 및 Xamarin 플랫폼에서만 지원됩니다. Android, Unity, UWP, WPF/WinFormsMAUI/Xamarin 앱에 대한 SDK 설명서에서 오류 보고서에 첨부 파일을 추가하는 방법을 알아봅니다.

첨부 파일을 보고 다운로드하려면 크래시 또는 오류 그룹, 특정 디바이스 보고서를 선택한 다음 첨부 파일 탭을 클릭합니다.

App Center를 사용하면 크래시 및 오류 보고서에 첨부 파일을 추가할 수 있습니다.

충돌 전 이벤트

크래시로 이어지는 이벤트를 추적하여 앱 상태에 대한 유용한 정보를 캡처합니다.

사용자 지정 이벤트를 정의하려면 Android, iOS, macOS, React Native, WindowsMAUI/XamarinSDK 설명서를검사.

크래시 전에 이벤트를 보려면 크래시 그룹, 특정 디바이스 보고서를 선택한 다음 이벤트 탭을 클릭합니다.

App Center를 사용하면 크래시로 이어지는 이벤트를 추적할 수 있습니다.

키 값 쌍

문자열 값 사전(키/값 쌍) TrackError 을 메서드에 전달하여 오류에 대한 추가 컨텍스트를 포함하도록 App Center로 전송된 오류 보고서를 조정할 수 있습니다. 이러한 속성은 선택적입니다. 키 값 쌍을 설정하려면 Android, MAUI/Xamarin, Unity, UWPWPF/WinForms 설명서를 살펴보세요.

참고

이 기능은 현재 Android, iOS, Xamarin, React Native, Unity, UWP, WinForms 및 WPF 오류에 대해서만 지원됩니다.

진단 데이터 내보내기

App Center는 진단(충돌 및 오류) 원시 데이터를 Azure로 내보낼 수 있습니다. 데이터를 사용자 지정하기 위해 진단 데이터를 Blob Storage로 내보냅니다.

크래시, 첨부 파일 및 오류를 내보내려면 구성 내보내기 API를 호출해야 합니다.

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

exportEntities API 속성의 필드에서 내보내려는 데이터 형식(크래시, 오류, 첨부 파일)을 나타내야 합니다. 이렇게 하면 심볼화된 전체 크래시 및 해당 스택 추적이 내보내됩니다.

의 이점 및 내보내기 설명서에서 데이터를 내보내는 방법에 대해 자세히 알아봅니다.

스레드

크래시 보고서에서 앱이 충돌했을 때 활성 상태였던 현재 스레드를 볼 수 있습니다. 충돌한 스레드는 앱의 상태를 더 잘 이해할 수 있도록 빨간색으로 강조 표시됩니다.

App Center는 충돌 시 현재 스레드를 표시합니다.

참고

Windows에서 보고서에는 크래시가 발생한 스레드의 스택 추적만 표시됩니다. 충돌 시 다른 스레드의 상태를 표시하는 것은 Windows에서 지원되지 않습니다.

경고 구성

메일 알림을 보내도록 App Center 앱 정의 설정을 구성하여 크래시를 파악하세요. 앱당 이 설정을 구성하여 새 크래시 그룹을 만들 때 즉시 전자 메일을 보내거나 앱의 최고 크래시가 있는 일별 요약 이메일을 보낼 수 있습니다. 이러한 경고를 구성하려면 다음을 수행합니다.

  1. App Center에 로그인하고 앱을 선택합니다.
  2. 왼쪽 메뉴에서 설정으로 이동합니다.
  3. Email 알림 클릭
  4. 즉시, 매일 또는 안 을 선택합니다. 기본 구성은 Never로 설정 됩니다.

스크린샷 설정 크래시 이메일 알림 빈도

App Center dashboard 설명서에서 알림에 대해 자세히 알아볼 수 있습니다.

버그 추적기 만들기

타사 버그 추적기 도구를 App Center 통합하여 정보를 유지하고 크래시를 더 잘 관리할 수 있습니다. 시작하는 방법을 알아보려면 버그 추적기 설명서를 참조하세요.

App Center에 보고서 업로드

API를 통해 크래시를 업로드하는 설명서가 이동되었습니다.