다음을 통해 공유


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

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

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

필수 조건

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

  • 아직 완료하지 않은 경우 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
}