데스크톱 애플리케이션에서 오류 세부 정보 가져오기

Microsoft Store 분석 API에서 이 메서드를 사용하여 앱의 특정 오류에 대한 자세한 데이터를 JSON 형식으로 가져올 수 있습니다. 이 메서드는 지난 30일 동안 발생한 오류의 세부 정보만 검색할 수 있습니다. 자세한 오류 데이터는 파트너 센터의 데스크톱 애플리케이션에 대한 Health 보고서에서도 확인할 수 있습니다.

이 메서드를 사용하려면 먼저 오류 보고 데이터 가져오기 메서드를 사용하여 자세한 정보를 가져오려는 오류의 ID를 검색해야 합니다.

필수 조건

이 메서드를 사용하려면 먼저 다음 방법대로 해야 합니다.

• 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
• 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
• 자세한 정보를 가져오려는 오류의 ID를 가져옵니다. 이 ID를 가져오려면 오류 보고 데이터 가져오기 메서드를 사용하고 해당 메서드의 응답 본문에서 failureHash 값을 사용합니다.

요청

요청 구문

메서드	요청 URI
GET	https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails

요청 헤더

헤더	형식	설명
권한 부여	string	필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰.

요청 매개 변수

매개 변수	형식	설명	필수
applicationId	문자열	오류 세부 정보를 검색할 데스크톱 애플리케이션의 제품 ID입니다. 데스크톱 애플리케이션의 제품 ID를 가져오려면 파트너 센터에서 데스크톱 응용 프로그램 분석 보고서(Health 보고서 등)를 열고 URL에서 제품 ID를 검색합니다.	예
failureHash	문자열	자세한 정보를 가져오려는 오류의 고유 ID를 가져옵니다. 관심 있는 오류에 대한 해당 값을 가져오려면 오류 보고 데이터 가져오기 메서드를 사용하고 해당 메서드의 응답 본문에서 failureHash 값을 사용합니다.	예
startDate	date	검색할 자세한 오류 데이터 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜에서 30일 전입니다. 참고: 이 메서드는 지난 30일 동안 발생한 오류에 대한 세부 정보만 검색할 수 있습니다.	아니요
endDate	date	검색할 자세한 오류 데이터 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다.	아니요
top	int	요청에서 반환할 데이터 행의 수. 지정되지 않은 경우 최댓값 및 기본값은 10000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.	아니요
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 top=10 및 skip=0은 데이터의 첫 10행을 검색하고 top=10 및 skip=10은 데이터의 그 다음 10행을 검색하는 식으로 이어집니다.	아니요
필터	문자열	응답의 행을 필터링하는 한 개 이상의 구문입니다. 각 명령문에는 응답 본문의 필드 이름 및 eq 또는 ne 연산자와 연결된 값이 포함되며, 명령문은 and 또는 or을 사용하여 결합될 수 있습니다. 문자열 값은 필터 매개 변수에서 단일 따옴표로 묶여야 합니다. 응답 본문에서 지정할 수 있는 필드는 다음과 같습니다. 시장 date cabIdHash cabExpirationTime deviceType deviceModel osVersion osRelease applicationVersion osBuild fileName	아니요
orderby	문자열	결과 데이터 값을 정렬하는 문. 구문은 orderby=field [order],field [order],...입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. 시장 date cabIdHash cabExpirationTime deviceType deviceModel osVersion osRelease applicationVersion osBuild fileName order 매개 변수는 옵션이며 각 필드를 asc 또는 desc로 오름차순 또는 내림차순으로 지정할 수 있습니다. 기본값은 asc입니다. 다음은 orderby 문자열의 예시입니다. orderby=date,market	아니요

요청 예시

다음 예제는 자세한 오류 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 데스크톱 애플리케이션의 제품 ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/failuredetails?applicationId=10238467886765136388&failureHash=012e33e3-dbc9-b12f-c124-9d9810f05d8b&startDate=2016-11-05&endDate=2016-11-06&top=10&skip=0&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

값	형식	설명
값	배열	자세한 오류 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 정보는 아래의 오류 세부 정보 값 섹션을 참조하세요.
@nextLink	문자열	추가적인 데이터 페이지가 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10으로 설정되어 있지만 쿼리에 대한 오류 행이 10개보다 많은 경우 이 값이 반환됩니다.
TotalCount	정수	쿼리에 대한 데이터 결과의 총 행 수.

오류 세부 정보 값

값 배열의 요소에는 다음의 값이 포함됩니다.

값	형식	설명
applicationId	문자열	오류 세부 정보를 검색한 데스크톱 애플리케이션의 제품 ID입니다.
failureHash	문자열	오류에 대한 고유 식별자입니다.
failureName	문자열	오류 이름은 하나 이상의 문제 클래스, 예외/버그 확인 코드, 오류가 발생한 이미지의 이름 및 관련된 기능 이름이라는 네 부분으로 구성됩니다.
date	문자열	오류 데이터에 대한 날짜 범위의 시작 날짜입니다. 요청에서 하루를 지정한 경우 이 값은 해당 날짜입니다. 요청에서 주, 월 또는 다른 날짜 범위를 지정한 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다.
cabIdHash	문자열	이 오류와 연결된 CAB 파일의 고유 ID 해시입니다.
cabExpirationTime	문자열	CAB 파일이 만료되어 더 이상 다운로드할 수 없는 날짜 및 시간(ISO 8601 형식)입니다.
시장	문자열	디바이스 시장의 ISO 3166 국가 코드입니다.
osBuild	문자열	오류가 발생한 OS의 빌드 번호입니다.
applicationVersion	문자열	오류가 발생한 애플리케이션 실행 파일의 버전.
deviceModel	문자열	오류가 발생했을 때 앱이 실행되고 있는 디바이스의 모델을 지정하는 문자열입니다.
osVersion	문자열	데스크톱 애플리케이션이 설치된 OS 버전을 나타내는 다음의 문자열 중 하나입니다. Windows 7 Windows 8.1 Windows 10 Windows 11 Windows Server 2016 Windows Server 1709 알 수 없음
osRelease	문자열	오류가 발생한 OS 릴리스 또는 플라이팅 링(OS 버전 내 하위 집단)을 나타내는 다음의 문자열 중 하나입니다. Windows 11의 경우: 버전 2110 Windows 10의 경우: 1507 버전 1511 버전 1607 버전 1703 버전 1709 버전 1803 버전 릴리스 미리 보기 초기 참가자 이후 참가자 Windows Server 1709의 경우: RTM Windows Server 2016의 경우: 1607 버전 Windows 8.1의 경우: 업데이트 1 Windows 7의 경우: 서비스 팩 1 OS 릴리스 또는 플라이팅 링을 알 수 없는 경우 이 필드의 값은 알 수 없음입니다.
deviceType	문자열	오류가 발생한 디바이스 유형을 나타내는 다음의 문자열 중 하나입니다. PC 서버 알 수 없음
cabDownloadable	Boolean	이 사용자에 대해 CAB 파일을 다운로드할 수 있는지 여부를 나타냅니다.
fileName	문자열	오류 세부 정보를 검색한 데스크톱 애플리케이션의 실행 파일 이름입니다.

응답 예시

다음의 예시는 이 요청의 JSON 응답 본문 예시를 보여 줍니다.

{
  "Value": [
    {
      "applicationId": "10238467886765136388",
      "failureHash": "012345-5dbc9-b12f-c124-9d9810f05d8b",
      "failureName": "NULL_CLASS_PTR_WRITE_c0000005_contoso.exe!unknown_error_in_process",
      "date": "2018-01-28 23:55:29",
      "cabIdHash": "54ffb83a-e159-41d2-8158-f36f306cc01e",
      "cabExpirationTime": "2018-02-27 23:55:29",
      "market": "US",
      "osBuild": "10.0.10240",
      "applicationVersion": "2.2.2.0",
      "deviceModel": "Contoso All-in-one",
      "osVersion": "Windows 10",
      "osRelease": "Version 1703",
      "deviceType": "PC",
      "cabDownloadable": false,
      "fileName": "contosodemo.exe"
    }
  ],
  "@nextLink": null,
  "TotalCount": 1
}

관련 항목

• Health 보고서
• Microsoft Store 서비스를 사용하여 분석 데이터에 액세스하기
• 데스크톱 애플리케이션에 대한 오류 보고 데이터 가져오기
• 데스크톱 애플리케이션에서 오류에 대한 스택 추적 가져오기
• 데스크톱 애플리케이션의 오류에 대한 CAB 파일 다운로드하기