다음을 통해 공유


데스크톱 애플리케이션에서 오류에 대한 스택 추적 가져오기

Microsoft Store 분석 API에서 이 메서드를 사용하여 Windows 데스크톱 애플리케이션 프로그램에 추가한 데스크톱 애플리케이션의 오류에 대한 스택 추적을 가져옵니다. 이 메서드는 지난 30일 동안 발생한 오류에 대해서만 스택 추적을 다운로드할 수 있습니다. 스택 추적은 파트너 센터의 데스크톱 애플리케이션에 대한 상태 보고서에서 도 사용할 수 있습니다.

이 메서드를 사용하려면 먼저 데스크톱 애플리케이션 메서드에서 오류에 대한 세부 정보를 가져오기 사용하여 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 ID 해시를 검색해야 합니다.

필수 조건

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

요청

요청 구문

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

요청 헤더

헤더 유형 설명
승인 문자열 필수 사항입니다. Azure AD 액세스 토큰은 Bearer<토큰> 형식입니다.

요청 매개 변수

매개 변수 유형 설명 필수
애플리케이션 아이디 문자열 스택 추적을 가져오려는 데스크톱 애플리케이션의 제품 ID입니다. 데스크톱 애플리케이션의 제품 ID를 가져오려면 파트너 센터(예: 상태 보고서)에서 데스크톱 애플리케이션에 대한 분석 보고서를 열고 URL에서 제품 ID를 검색합니다.
cabId해시 문자열 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 고유 ID 해시입니다. 이 값을 가져오려면 데스크톱 애플리케이션 메서드의 오류에 대한 세부 정보 가져오기 를 사용하여 애플리케이션의 특정 오류에 대한 세부 정보를 검색하고 해당 메서드의 응답 본문에 cabIdHash 값을 사용합니다.

예제 요청

다음 예제에서는이 메서드를 사용 하 여 스택 추적을 가져오는 방법을 보여 줍니다. applicationIdcabIdHash 매개 변수를 데스크톱 애플리케이션에 적합한 값으로 바꿉다.

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
}