다음을 통해 공유

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

  • 아티클

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

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

필수 조건

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

  • 아직 완료하지 않은 경우 Microsoft Store 분석 API에 대한 모든 필수 조건을 완료합니다.
  • 이 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져오세요. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.
  • 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 ID 해시를 가져옵니다. 이 값을 가져오려면 데스크톱 애플리케이션에서 오류에 대한 세부 정보 가져오기 메서드를 사용하여 앱에서 특정 오류에 대한 세부 정보를 검색하고 해당 메서드의 응답 본문에 cabIdHash 값을 사용합니다.

요청

요청 구문

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

요청 헤더

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

요청 매개 변수

매개 변수 형식 설명 필수
applicationId 문자열 스택 추적을 가져올 데스크톱 애플리케이션의 제품 ID입니다. 데스크톱 애플리케이션의 제품 ID를 가져오려면 파트너 센터에서 데스크톱 애플리케이션 분석 보고서(Health 보고서 등)를 열고 URL에서 제품 ID를 검색합니다. 예
cabIdHash 문자열 스택 추적을 검색하려는 오류와 연결된 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가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10으로 설정되어 있지만 쿼리에 대한 오류 행이 10개보다 많은 경우 이 값이 반환됩니다.
TotalCount 정수 쿼리에 대한 데이터 결과의 총 행 수.

스택 추적 값

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

값 형식 설명
level 문자열 이 요소가 호출 스택에 나타내는 프레임 번호입니다.
image 문자열 이 스택 프레임에서 호출되는 함수를 포함하는 실행 파일 또는 라이브러리 이미지의 이름입니다.
function 문자열 이 스택 프레임에서 호출되는 함수의 이름입니다. 앱에 실행 파일 또는 라이브러리에 대한 기호가 포함된 경우에만 사용할 수 있습니다.
offset 문자열 함수의 시작을 기준으로 하는 현재 명령의 바이트 오프셋입니다.

응답 예시

다음의 예시는 이 요청의 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
}