Microsoft Store 분석 API에서 이 메서드를 사용하여 앱 내 오류에 대한 스택 추적을 가져올 수 있습니다. 이 메서드는 지난 30일 동안 발생한 앱 오류에 대한 스택 추적만 다운로드할 수 있습니다. 스택 추적은 파트너 센터의 상태 보고서의 실패 섹션에서도 사용할 수 있습니다.
이 메서드를 사용하려면 먼저 앱 메서드에서 오류에 대한 세부 정보를 가져오기
필수 조건
이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.
- 아직 완료하지 않은 경우 Microsoft Store 분석 API에 필요한 모든 필수 구성 요소를 완료하십시오.
- 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.
- 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 ID를 가져옵니다. 이 ID를 가져오려면, 앱에서 특정 오류의 세부 정보를 가져오는 을(를) 사용하여 메서드를 통해 세부 정보를 검색하고, 해당 메서드의 응답 본문에서 cabId 값을 사용합니다.
요청
요청 구문
| 메서드 | URI 요청 |
|---|---|
| 가져오기 | https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace |
요청 헤더
| 헤더 | 유형 | 설명 |
|---|---|---|
| 승인 | 문자열 | 필수 사항입니다. Azure AD 액세스 토큰은 Bearer<token> 형식입니다. |
요청 매개 변수
| 매개 변수 | 유형 | 설명 | 필수 |
|---|---|---|---|
| 애플리케이션 아이디 | 문자열 | 스택 추적을 가져오려는 앱의 스토어 ID입니다. 스토어 ID는 파트너 센터의 앱 ID 페이지에서 사용할 수 있습니다. 예를 들어 스토어 ID는 9WZDNCRFJ3Q8입니다. | 예 |
| 택시 ID | 문자열 | 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 고유 ID입니다. 이 ID를 가져오려면, 앱에서 특정 오류의 세부 정보를 가져오는 을(를) 사용하여 메서드를 통해 세부 정보를 검색하고, 해당 메서드의 응답 본문에서 cabId 값을 사용합니다. | 예 |
예제 요청
다음 예제에서는이 메서드를 사용 하 여 스택 추적을 가져오는 방법을 보여 줍니다. applicationId 값을 앱의 스토어 ID로 바꿉니다.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 HTTP/1.1
Authorization: Bearer <your access token>
응답
응답 메시지 본문
| 가치 | 유형 | 설명 |
|---|---|---|
| 가치 | 배열 | 각각 스택 추적 데이터의 하나의 프레임을 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 아래 스택 추적 값 섹션을 참조하세요. |
| @nextLink | 문자열 | 추가 데이터 페이지가 있는 경우 이 문자열에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 URI가 포함됩니다. 예를 들어 요청의 최상위 매개 변수가 10으로 설정되어 있지만 쿼리에 대해 10개 이상의 오류 행이 있는 경우 이 값이 반환됩니다. |
| 총개수 | 정수 | 쿼리의 데이터 결과에 포함된 행의 총 개수입니다. |
스택 추적 값
값 배열의 요소에는 다음 값이 포함됩니다.
| 가치 | 유형 | 설명 |
|---|---|---|
| 수준 | 문자열 | 이 요소가 호출 스택에 나타내는 프레임 번호입니다. |
| 이미지 | 문자열 | 이 스택 프레임에서 호출되는 함수를 포함하는 실행 파일 또는 라이브러리 이미지의 이름입니다. |
| 기능 | 문자열 | 이 스택 프레임에서 호출되는 함수의 이름입니다. 앱에 실행 파일 또는 라이브러리에 대한 기호가 포함된 경우에만 사용할 수 있습니다. |
| 상쇄 | 문자열 | 함수 시작 지점에 대한 현재 명령의 바이트 오프셋입니다. |
비고
이 메서드는 지난 30일 동안 발생한 앱 오류에 대한 스택 추적만 다운로드할 수 있습니다.
요청 및 응답 예제
다음 코드 조각은 해당 요청에 대한 몇 가지 예제 요청 및 JSON 응답 본문을 보여 줍니다.
샘플 요청
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1234567890123456789
HTTP/1.1
Authorization: Bearer <your access token>
예시 응답
{
"Value": [
{
"level": "0",
"image": "Microsoft.Contoso",
"function": "HANG_QUIESCE",
"offset": "0x0000000000000000",
"isBlamedFrame": true
},
{
"level": "1",
"image": "unknown.dll",
"function": "[.ecxr]",
"offset": "0x0000000000000000",
"isBlamedFrame": false
},
{
"level": "2",
"image": "ntdll.dll",
"function": "RtlpHpSegFree",
"offset": "0x0000000000000000",
"isBlamedFrame": false
},
{
"level": "3",
"image": "ntdll.dll",
"function": "RtlpHpFreeHeap",
"offset": "0x0000000000000000",
"isBlamedFrame": false
},
{
"level": "4",
"image": "ntdll.dll",
"function": "RtlpFreeHeapInternal",
"offset": "0x0000000000000000",
"isBlamedFrame": false
}
],
"TotalCount": 5
}