다음을 통해 공유


앱에 대한 오류 보고 데이터 가져오기

Microsoft Store 분석 API에서 이 메서드를 사용하여 지정된 날짜 범위 및 기타 선택적 필터에 대한 JSON 형식으로 앱에 대한 집계 오류 보고 데이터를 가져옵니다. 이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다. 이 정보는 파트너 센터의 상태 보고서Failures 섹션에서도 확인할 수 있습니다.

오류 세부 정보가져오기, 스택 추적가져오기 및 CAB 파일 메서드를 다운로드하는 사용하여 추가 오류 정보를 검색할 수 있습니다.

필수 구성 요소

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

요청

요청 구문

메서드 요청 URI
가져오기 https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits

요청 헤더

머리글 유형 묘사
권한 부여 문자열 필수. Azure AD 액세스 토큰은 형식의 Bearer<토큰>입니다.

요청 매개 변수

매개 변수 유형 묘사 필수
applicationId 문자열 오류 보고 데이터를 검색하려는 앱의 스토어 ID. 파트너 센터의 앱 식별 페이지에서 스토어 ID를 확인할 수 있습니다. 예를 들어 스토어 ID는 9WZDNCRFJ3Q8입니다.
시작 날짜 날짜 검색할 오류 보고 데이터의 날짜 범위의 시작 날짜입니다. 기본값은 현재 날짜입니다. aggregationLevel, , 또는 인 경우, 이 매개변수는 mm/dd/yyyy형식으로 날짜를 지정해야 합니다. aggregationLevel시간경우, 이 매개변수는 날짜를 mm/dd/yyyy 형식으로 지정하거나, 날짜와 시간을 yyyy-mm-dd hh:mm:ss형식으로 지정할 수 있습니다.

참고: 이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다.
아니요
종료일 날짜 검색할 오류 보고 데이터의 날짜 범위의 종료 날짜입니다. 기본값은 현재 날짜입니다. aggregationLevel, 또는 인 경우, 이 매개 변수는 mm/dd/yyyy형식으로 날짜를 지정해야 합니다. aggregationLevel 시간경우 이 매개 변수는 형식으로 날짜를 지정하거나 날짜와 시간을 형식으로 지정할 수 있습니다. 아니요
맨 위로 정수형 (int) 요청에 반환할 데이터 행 수입니다. 지정하지 않으면 최대값과 기본값은 10000입니다. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. 아니요
거르다 정수형 (int) 쿼리에서 건너뛸 행 수입니다. 이 매개변수를 사용하여 큰 데이터 집합을 탐색합니다. 예를 들어 top=10000 및 skip=0은 처음 10000개의 데이터 행을 검색하고 top=10000 및 skip=10000은 다음 10000개 행의 데이터 등을 검색합니다. 아니요
필터 문자열 응답의 행을 필터링하는 하나 이상의 명령문입니다. 각 문에는 응답 본문의 필드 이름과 eq 또는 ne 연산자와 연결된 값이 포함되며, 사용하거나 또는사용하여 문을 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 응답 본문에서 다음 필드를 지정할 수 있습니다.

  • applicationName
  • failureName
  • 실패 해시
  • 기호
  • osVersion
  • osRelease
  • eventType
  • 시장
  • deviceType
  • packageName
  • packageVersion
  • 날짜
아니요
집계 수준 문자열 집계 데이터를 검색할 시간 범위를 지정합니다. 시간, , 또는 중 하나일 수 있습니다. 지정하지 않으면 기본값은 . 또는 지정하는 경우 failureNamefailureHash 값은 1000개의 버킷으로 제한됩니다.

참고:시간지정하는 경우 이전 72시간에서만 오류 데이터를 검색할 수 있습니다. 72시간보다 오래된 오류 데이터를 검색하려면 또는 다른 집계 수준 중 하나를 지정합니다.
아니요
정렬 기준 문자열 결과 데이터 값을 정렬하는 문입니다. 구문은 *orderby=field [order]입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다.
  • applicationName
  • failureName
  • 실패해시
  • 기호
  • osVersion
  • osRelease
  • eventType
  • 시장
  • deviceType
  • packageName
  • packageVersion
  • 날짜

순서 매개 변수는 선택 사항이며, 각 필드에 대한 오름차순 또는 내림차순 순서를 지정할 수 있도록 asc 또는 desc로 설정할 수 있습니다. 기본값은 asc.

여기 예시 orderby 문자열: orderby=date

참고: 모든 매개 변수는 groupby지원되는 목록에 있어야 합니다.

아니요
그룹바이 문자열 지정된 필드에만 데이터 집계를 적용하는 문입니다. 다음 필드를 지정할 수 있습니다.
  • failureName
  • 실패 해시
  • 기호
  • osVersion
  • eventType
  • 시장
  • deviceType
  • packageName
  • packageVersion

반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다.

  • 날짜
  • applicationId
  • applicationName
  • 장치 수
  • 이벤트 수

groupby 매개 변수는 aggregationLevel 매개 변수와 함께 사용할 수 있습니다. 예: &그룹별=failureName,market&집계수준=week

참고: 매개 변수에는 중복 항목이 포함될 수 없습니다.
아니요

요청 예제

다음 예제에서는 오류 보고 데이터를 가져오기 위한 몇 가지 요청을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and deviceType eq 'phone' HTTP/1.1
Authorization: Bearer <your access token>

응답

응답 본문

묘사
배열 집계 오류 보고 데이터를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 오류 값 섹션을 참조하십시오.
@nextLink 문자열 추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 상위 매개 변수가 10000으로 설정되어 있지만 쿼리에 대해 10000개 이상의 오류 행이 있는 경우 이 값이 반환됩니다.
총계 정수 쿼리에 대한 데이터 결과의 총 행 수입니다.

오류 값

Value 배열의 요소는 다음 값을 포함합니다.

가치 유형 묘사
날짜 문자열 오류 데이터의 날짜 범위에서 yyyy-mm-dd형식의 첫 번째 날짜입니다. 요청이 1일을 지정하는 경우 이 값은 해당 날짜입니다. 요청이 더 긴 날짜 범위를 지정하는 경우 이 값은 해당 날짜 범위의 첫 번째 날짜입니다. aggregationLevel 값을 시간으로 지정한 요청의 경우, 이 값에는 시간 값이 hh:mm:ss형식으로 포함됩니다.
applicationId 문자열 오류 데이터를 검색하려는 앱의 스토어 ID입니다.
애플리케이션 이름 문자열 앱의 표시 이름입니다.
실패명 문자열 하나 이상의 문제 클래스, 예외/버그 검사 코드, 오류가 발생한 이미지의 이름 및 연결된 함수 이름 등 네 부분으로 구성된 오류의 이름입니다.
failureHash (실패 해시) 문자열 오류의 고유 식별자입니다.
상징 문자열 이 오류에 할당된 기호입니다.
운영체제 버전 문자열 오류가 발생한 OS 버전을 지정하는 다음 문자열 중 하나입니다.
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • windows Phone 10
  • Windows 8
  • Windows 8.1
  • windows 10
  • Windows 11
  • 알 수 없는
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 릴리스 또는 플라이팅 링을 알 수 없는 경우, 이 필드의 값은 알 수 없음입니다.

이벤트 유형 문자열 다음 문자열 중 하나입니다.
  • 충돌
  • 중단
  • 메모리
  • jse
시장 문자열 디바이스 시장의 ISO 3166 국가 코드입니다.
디바이스 유형 문자열 오류가 발생한 디바이스의 유형을 나타내는 다음 문자열 중 하나입니다.
  • PC
  • 전화
  • Console-Xbox One
  • Console-Xbox 시리즈 X
  • IoT
  • 홀로그래픽
  • 알 수 없는
패키지이름 문자열 이 오류와 연결된 앱 패키지의 고유 이름입니다.
패키지버전 문자열 이 오류와 연결된 앱 패키지의 버전입니다.
디바이스 개수 지정된 집계 수준에 대해 이 오류에 해당하는 고유 디바이스의 수입니다.
이벤트 수 지정된 집계 수준에 대해 이 오류에 기인하는 이벤트 수입니다.

메모

이 메서드는 지난 30일 동안 발생한 오류만 검색할 수 있습니다.

요청 및 응답 예제

다음 코드 조각은 해당 요청에 대한 예제 요청 및 JSON 응답 본문을 보여 줍니다.

샘플 요청

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/failurehits?applicationId=9NBLGGGZ5QDR&startDate=07/02/2022&endDate=07/20/2022&top=10&skip=0&filter=market eq 'US'&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&orderby=date
HTTP/1.1
Authorization: Bearer <your access token>

예시 응답

{
    "Value": [
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
            "failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
            "symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "PC",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 6.0,
            "eventCount": 1.05263157894737
        },
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_BlockedOn_FileIO_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_Microsoft.Contoso Demo!unknown_error_in_application",
            "failureHash": "c21da75f-ea4d-538b-cfec-73654ef810b9",
            "symbol": "Microsoft.Contoso Demo!unknown_error_in_application",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "Unknown",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 7.14285714285714,
            "eventCount": 1.05263157894737
        },
        {
            "date": "2022-07-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "failureName": "APPLICATION_HANG_Microsoft.Contoso Demo!CEServices.InternalLiveTileUpdaterRuntime_dfffffff_twinapi.appcore.dll!WaitCoalesced",
            "failureHash": "233e04bb-7a3d-eb28-c316-1120aa9defc0",
            "symbol": "twinapi.appcore.dll!WaitCoalesced",
            "osVersion": "6.3.9600",
            "osRelease": "RTM",
            "osArchitecture": null,
            "eventType": "hang",
            "market": "US",
            "deviceType": "PC",
            "praid": null,
            "packageName": "microsoft.Contoso Demo_2.5.2.34894_x86__8wekyb3d8bbwe",
            "packageVersion": "2.5.2.34894",
            "ram": null,
            "massStorage": null,
            "cpu": null,
            "cpuManufacturer": null,
            "cpuFamilyName": null,
            "sandboxId": null,
            "deviceCount": 6.0,
            "eventCount": 8.94736842105263
        }
    ],
    "@nextLink": "failurehits?applicationId=9NBLGGGZ5QDR&aggregationLevel=day&startDate=2022/07/02&endDate=2022/07/21&top=10&skip=10&groupby=failureName,failureHash,symbol,osVersion,eventType,market,deviceType,packageName,packageVersion,osRelease&filter=market eq 'US'&orderby=date",
    "TotalCount": 443
}