앱에서 오류에 대한 스택 추적 가져오기

  • 아티클

Microsoft Store 분석 API에서 이 메서드를 사용하여 앱의 오류에 대한 스택 추적을 가져올 수 있습니다. 이 메서드는 지난 30일 동안 발생한 앱 오류에 대한 스택 추적만 다운로드할 수 있습니다. 스택 추적은 파트너 센터에서 Health 보고서의 오류 섹션을 통해서도 확인할 수 있습니다.

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

필수 조건

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

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

요청

요청 구문

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

요청 헤더

헤더 형식 설명
권한 부여 문자열 필수. Bearer<토큰> 형식의 Azure AD 액세스 토큰입니다.

요청 매개 변수

매개 변수 형식 설명 필수
applicationId 문자열 스택 추적을 가져오려는 앱의 스토어 ID입니다. 파트너 센터의 앱 ID 페이지에서 Store ID를 사용할 수 있습니다. 예를 들어 Store ID는 9WZDNCRFJ3Q8입니다. 예
cabId 문자열 스택 추적을 검색하려는 오류와 연결된 CAB 파일의 고유 ID를 가져옵니다. 이 ID를 가져오려면 앱의 오류에 대한 세부 정보 가져오기 메서드를 사용하여 앱의 특정 오류에 대한 세부 정보를 검색하고 해당 메서드의 응답 본문에 cabId 값을 사용합니다 . 예

 

요청 예시

다음 예시는 이 메서드를 사용하여 스택 추적을 가져오는 방법을 보여 줍니다. applicationId 값을 앱의 Store 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가 이 문자열에 포함됩니다. 예를 들어 요청의 top 매개 변수가 10으로 설정되어 있지만 쿼리에 대한 오류 행이 10개보다 많은 경우 이 값이 반환됩니다.
TotalCount 정수 쿼리에 대한 데이터 결과의 총 행 수.

스택 추적 값

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

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

참고

이 메서드는 지난 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
}