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