Udostępnij za pośrednictwem

Pobierz ślad stosu dla błędu w aplikacji na komputerze stacjonarnym

Użyj tej metody w interfejsie API analityki Microsoft Store, aby uzyskać ślad stosu dla błędu w aplikacji desktopowej, którą dodałeś do programu Aplikacja klasyczna systemu Windows. Ta metoda może pobrać jedynie ślad stosu błędu, który wystąpił w ciągu ostatnich 30 dni. Ślady stosu są również dostępne w raporcie Kondycja dla aplikacji desktopowych w Centrum Partnerskim.

Aby można było zastosować tę metodę, należy najpierw użyć metody uzyskać szczegółowe informacje o błędzie w aplikacji klasycznej w celu pobrania skrótu identyfikatora pliku CAB skojarzonego z błędem, aby pobrać ślad stosu dla tego błędu.

Wymagania wstępne

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

  • Jeśli jeszcze tego nie zrobiłeś, wykonaj wszystkie wymagania wstępne i dla API analizy 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 skrót identyfikatora pliku CAB skojarzonego z błędem, dla którego chcesz pobrać ślad stosu. Aby uzyskać tę wartość, użyj metody uzyskiwania szczegółów błędu w aplikacji desktopowej, aby pobrać szczegóły określonego błędu w swojej aplikacji, a następnie użyj wartości cabIdHash w treści odpowiedzi tej metody.

Żądanie

Składnia żądania

Metoda Żądanie URI
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/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 produktu aplikacji desktopowej, dla której chcesz uzyskać ślad stosu. Aby uzyskać identyfikator produktu aplikacji komputerowej, otwórz dowolny raport z analizy aplikacji komputerowej w Centrum partnerskim (na przykład raport kondycji ) i pobierz identyfikator produktu z adresu URL. Tak
cabIdHash (skrót cabIdHash) sznurek Skrót unikatowego identyfikatora pliku CAB skojarzony z błędem, dla którego chcesz pobrać ślad stosu. Aby uzyskać tę wartość, użyj metody uzyskiwania szczegółów błędu w aplikacji desktopowej do pobrania szczegółów określonego błędu w swojej aplikacji, a następnie użyj wartości cabIdHash 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. Zamień parametry applicationId i cabIdHash na odpowiednie wartości dla aplikacji desktopowej.

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>

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.

Przykład odpowiedzi

W poniższym przykładzie pokazano przykładową treść odpowiedzi JSON dla tego żądania.

{
  "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
}