Udostępnij przez

Uzyskaj ślad stosu dla błędu w aplikacji

Użyj tej metody w interfejsie API analityki Microsoft Store, aby uzyskać ślad stosu błędu w aplikacji. Ta metoda może pobrać tylko ślad stosu dla błędu aplikacji, który wystąpił w ciągu ostatnich 30 dni. Śledzenia stosu są również dostępne w sekcji Błędyraportu kondycji w Centrum Partnerskim.

Aby można było użyć tej metody, należy najpierw użyć metody uzyskania szczegółów błędu w aplikacji, aby pobrać identyfikator pliku CAB, który jest skojarzony z błędem, dla którego chcesz pobrać ślad stosu.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiłeś/zrobiłaś, wykonaj wszystkie wymagania wstępne dotyczące interfejsu API analizy sklepu Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.
  • Pobierz identyfikator pliku CAB skojarzonego z błędem, dla którego chcesz pobrać ślad stosu. Aby uzyskać ten identyfikator, użyj metody pobierz szczegóły błędu w aplikacji do uzyskania szczegółowych danych dotyczących konkretnego błędu w Twojej aplikacji, a następnie użyj wartości cabId zawartej w treści odpowiedzi tej metody.

Żądanie

Składnia żądania

Metoda Żądanie URI
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Parametr Typ Opis Wymagane
applicationId (identyfikator aplikacji) sznurek Identyfikator aplikacji w sklepie, dla której chcesz uzyskać ślad stosu. Identyfikator sklepu jest dostępny na stronie identyfikacji aplikacji w Centrum Partnerskim. Przykładowy identyfikator sklepu to 9WZDNCRFJ3Q8. Tak
Identyfikator taksówki sznurek Unikatowy identyfikator pliku CAB, skojarzony z błędem, dla którego chcesz uzyskać ślad stosu. Aby uzyskać ten identyfikator, użyj metody pobierz szczegóły błędu w aplikacji do uzyskania szczegółowych danych dotyczących konkretnego błędu w Twojej aplikacji, a następnie użyj wartości cabId zawartej w treści odpowiedzi tej metody. Tak

 

Przykład zapytania

W poniższym przykładzie pokazano, jak uzyskać ślad stosu przy użyciu tej metody. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1336373323853 HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

Ciało odpowiedzi

Wartość Typ Opis
Wartość układ Tablica obiektów, z których każda zawiera jedną ramkę danych śledzenia stosu. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz poniżej sekcję wartości śledzenia stosu .
@nextLink sznurek Jeśli istnieją dodatkowe strony danych, ten ciąg zawiera identyfikator URI, którego można użyć do żądania następnej strony danych. Na przykład ta wartość jest zwracana, jeśli górny parametr żądania jest ustawiony na 10, ale istnieje więcej niż 10 wierszy błędów dla zapytania.
Łączna liczba liczba całkowita Całkowita liczba wierszy w wyniku danych dla zapytania.

Wartości śledzenia stosu

Elementy w tablicy Value zawierają następujące wartości.

Wartość Typ Opis
poziom sznurek Numer ramki, który ten element reprezentuje w stosie wywołań.
obraz sznurek Nazwa obrazu wykonywalnego lub biblioteki zawierającego funkcję wywoływaną w tej ramce stosu.
funkcja sznurek Nazwa funkcji, która jest wywoływana w tej ramce stosu. Jest to dostępne tylko wtedy, gdy aplikacja zawiera symbole pliku wykonywalnego lub biblioteki.
Przesunięcie sznurek Przesunięcie bajtowe bieżącej instrukcji względem początku funkcji.

Uwaga / Notatka

Ta metoda może pobrać tylko ślad stosu dla błędu aplikacji, który wystąpił w ciągu ostatnich 30 dni.

Przykład żądania i odpowiedzi

Poniższe fragmenty kodu przedstawiają przykładowe żądanie i treść odpowiedzi JSON dla tego żądania.

Przykładowe żądanie

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/stacktrace?applicationId=9NBLGGGZ5QDR&cabId=1234567890123456789
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "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
}
  • Last updated on