Analizowanie problemów

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
informacje.

Panel Zbadaj umożliwia wyświetlanie tabel przestawnych z danymi i atrybutami dla całego ruchu przez interfejsy API oraz porównywanie aktywności relacyjnej między wskaźnikami, co pozwala szybciej zbadać i zdiagnozować problemy. W panelu możesz przeglądać dane z ostatnich 30 dni.

W interfejsie użytkownika Edge wybierz Analyze > API Monitoring > Zbadaj, aby otworzyć panel Zbadaj. Panel składa się z 2 głównych obszarów:

  • Kod stanu umożliwia sprawdzanie wskaźników kodu stanu dla serwerów proxy interfejsu API i usług docelowych.
  • Czas oczekiwania umożliwia badanie problemów z opóźnieniami w przypadku serwerów proxy interfejsu API i usług docelowych.

Możesz też sprawdzić problemy spowodowane przez konkretny alert w panelu Zbadaj. Gdy pojawi się alert, kliknij jego nazwę na stronie Historia alertów, aby otworzyć go w panelu Invesitgate.

Zdiagnozowanie problemu za pomocą panelu Zbadaj

Możesz na przykład otrzymać alert informujący, że odsetek błędów 5xx przekracza określony próg. Aby zbadać ten problem, możesz wykonać te czynności w panelu Zbadaj:

  1. Wyświetl tabelę kodów błędów i czasu, aby zobaczyć aktywność kodów błędów w ciągu ostatniej godziny.
  2. Przełącz się na macierz kodów błędów a stan HTTP, aby zidentyfikować kody stanu HTTP powiązane z kodami błędów, których liczba wzrosła w ciągu ostatniej godziny (zgodnie z poprzednim krokiem).
  3. Przejdź do tabeli kodów błędów a serwer proxy, aby zidentyfikować serwery proxy interfejsu API, które uruchamiają kody błędów zidentyfikowane w poprzednim kroku.
  4. Kliknij pole w tabeli powiązane z serwerem proxy interfejsu API z dużą liczbą kodów błędów, aby wyświetlić więcej szczegółów i dzienników dostępu.
  5. Skonfiguruj alert i utwórz raport niestandardowy, aby uzyskać dalszą pomoc w diagnozowaniu problemu.
  6. Aby znaleźć rozwiązanie problemu, rozwiąż problemy z serwerem proxy interfejsu API, korzystając z śledzenia i innych narzędzi.

Korzystanie z panelu kodów stanu

Panel kodu stanu umożliwia analizowanie wskaźników kodu stanu dotyczących serwerów proxy interfejsu API i usług docelowych w organizacji. Możesz wyświetlić dane kodu stanu z godzinnego lub 4-godzinnego okna w dowolnym momencie z ostatnich 30 dni.

Przeglądanie panelu kodów stanu

Aby wyświetlić panel kodu stanu, w interfejsie użytkownika Edge wybierz Analyze > API Monitoring > Zbadaj. Panel kodów stanu wyświetla się domyślnie:

strona z kodem stanu

Jak pokazano na ilustracji, panel Zbadaj umożliwia:

  • Skonfiguruj każdą macierz, ustawiając jej oś X i Y, aby porównywać aktywność relacyjną między danymi i uzyskać więcej informacji.
  • Dzięki odcieniowi bryły możesz szybko zidentyfikować dane, których wielkość względna jest największa. Im ciemniejsza blok, tym większa głośność względna.
  • Kliknij blok w tabeli, aby wyświetlić szczegóły danych.
  • Filtruj dane na podstawie tych kryteriów:
    • Środowisko
    • Region
    • Proxy (Serwer proxy)
    • Kody stanu (w tym cały ruch, wszystkie błędy, 2xx, 4xx lub 5xx)
    • Data i godzina w ciągu ostatnich 30 dni
    • okno 1-godzinne lub 4-godzinne,

Za pomocą panelu możesz szybko wykonywać następujące czynności:

  • Dzienniki dostępu w panelu szczegółów wskaźnika.
  • Aby wyświetlić bieżący kontekst na karcie Ostatnie, Oś czasu lub w panelu, kliknij Menu Więcej > Wyświetl w ostatnich lub Wyświetl na osi czasu.
  • Utwórz raport niestandardowy i dodaj dodatkowe wymiary, klikając .
  • Utwórz alert i dodaj więcej warunków alertu, skonfiguruj powiadomienia oraz wygeneruj raport niestandardowy na podstawie alertu.

Konfigurowanie macierzy kodów stanu

Po wybraniu panelu Kod stanu domyślnie wyświetlane są te tabele:

  • Kod błędu a czas
  • Kod błędu a stan HTTP
  • Źródło błędu a serwer proxy interfejsu API

Skonfiguruj każdą macierz, by porównać dwa dowolne z poniższych danych, wybierając wartość na listach x i oś y:

  • Kod błędu
  • Zasady dotyczące błędów
  • Źródło błędu
  • Stan HTTP
  • Proxy (Serwer proxy)
  • Godzina
  • Region
  • Cel (usługa docelowa lub zasada ServiceCallout). Jeśli celem docelowym są zasady dotyczące ServiceCallout, wyświetlana wartość jest poprzedzona ciągiem sc://. na przykład sc://my.endpoint.net).

Skonfiguruj zestaw

Wyświetl szczegóły wskaźnika kodu stanu

Aby wyświetlić szczegóły konkretnego wskaźnika, kliknij jego blok w tabeli.

Wybierz blok

W panelu po prawej stronie zostaną wyświetlone szczegółowe informacje dotyczące domniemanej przyczyny, w tym:

  • Środowisko
  • Organizacja
  • Region
  • Źródło błędu (infrastruktura proxy, docelowa lub Apigee)

Mogą one obejmować również:

  • Zasada dotycząca błędów – informacje o zasadzie, która spowodowała błąd w czasie działania, w tym typ zasady (nazwa wewnętrzna) i nazwa zasady zdefiniowanej przez użytkownika. Nazwę tę musisz podać podczas dołączania zasady do procesu serwera proxy interfejsu API.
  • Nazwa serwera proxy
  • Kod stanu HTTP
  • Kod błędu

Jeśli w przypadku konkretnego wskaźnika moc zbioru jest większa niż jedna, panel szczegółów może zawierać szczegółowe informacje o rozkładzie błędów, takie jak Rozpowszechnianie według aplikacji dewelopera, Dystrybucja według zasad dotyczących błędów, Dystrybucja według kodów błędów, Dystrybucja według stanu HTTP itd. Na przykład:

Rozkład według

Jeśli źródło błędu jest celem, w panelu szczegółów pojawi się liczba błędów według celu. Na przykład:

Odsetek błędów według wartości docelowej

Korzystanie z panelu Opóźnienie

W panelu Opóźnienie wyświetlane są informacje o czasie oczekiwania serwerów proxy API i usług docelowych w organizacji. Możesz sprawdzić wskaźniki czasu oczekiwania dla jednogodzinnej reklamy w dowolnym momencie z ostatnich 30 dni.

Przeglądaj panel Czas oczekiwania

Aby wyświetlić panel czasu oczekiwania, w interfejsie użytkownika Edge wybierz Analyze > API Monitoring > Zbadaj. Domyślnie wyświetlany jest panel kodów stanu. Wybierz Czas oczekiwania w obszarze filtra, aby wyświetlić panel Czas oczekiwania:

strona opóźnienia

Po wybraniu panelu Opóźnienie domyślnie wyświetlają się te macierze:

  • Serwer proxy a czas (maksymalne opóźnienie w milisekundach)
  • Serwer proxy a łączny czas oczekiwania (maksymalne opóźnienie w milisekundach)
  • Czas oczekiwania na serwer proxy a wszystkie docelowe wartości (maksymalny czas oczekiwania w milisekundach)

Aby wyświetlić docelowe czasy oczekiwania, w menu Serwer proxy wybierz Cel.

Domyślnie panel Czas oczekiwania zawiera informacje o 10 serwerach proxy o największym łącznym czasie oczekiwania (99 centyl) w poprzedniej godzinie. Możesz też użyć menu 10 najlepszych, by wybrać określony serwer proxy lub kolekcję.

Panel Czas oczekiwania zawiera wszystkie funkcje panelu kodów stanu, z następującymi różnicami:

  • Konfigurujesz tylko centyl łącznego czasu oczekiwania na odpowiedź (p50, p90, p95, p99).
  • Możesz wybrać tylko jednogodzinne okno dla wskaźników czasu oczekiwania.
  • Nie możesz wybrać opcji Dowolny dla regionu w filtrach. Aby wyświetlić informacje, musisz wybrać konkretny region.

Wyświetl szczegóły wskaźnika Czas oczekiwania

Aby wyświetlić szczegóły konkretnego wskaźnika, kliknij jego blok w tabeli.

Wybierz blok

W prawym panelu wyświetlane są szczegóły dotyczące czasu oczekiwania dla serwera proxy (niebieska linia) i celu (linia fioletowa), w tym:

  • Całkowity czas oczekiwania (czas oczekiwania serwera proxy plus docelowy czas oczekiwania)
  • Czas oczekiwania na cel (docelowy czas reakcji)
  • Rozpowszechnianie według stanu HTTP

Najedź kursorem na wykres, aby wyświetlić szczegółowe informacje:

Widok wskaźnika czasu oczekiwania

Wykres Czas oczekiwania na cel pokazuje 16 pierwszych wartości docelowych na podstawie maksymalnego czasu oczekiwania, z po 1 wykresem na cel. Najedź kursorem na wykres lub wybierz listę rozwijaną, aby zobaczyć wykres odpowiadający każdemu celowi.

Wyświetl logi ze szczegółami wskaźników

Podczas wyświetlania szczegółów wskaźników dotyczących kodów stanu lub czasu oczekiwania kliknij Wyświetl logi, aby wyświetlić wszystkie logi dotyczące wybranego wskaźnika:

Wybór dziennika

Otworzy się okno dialogowe Logi ruchu z maksymalnie 1000 wpisów logu. Kliknij wpis logu, aby rozwinąć jego szczegóły na liście:

Logi

Logi możesz dodatkowo filtrować według:

  • Źródło wizyt
  • Typ błędu
  • Minimalny czas odpowiedzi

Nie możesz pobrać danych logów w oknie Dzienniki ruchu. Możesz jednak utworzyć raport niestandardowy lub pobrać dane analityczne do własnego repozytorium danych, np. Google Cloud Storage lub BigQuery, aby przeprowadzić własną analizę.

Tworzenie raportu niestandardowego w panelu Zbadaj

Utwórz raport niestandardowy na podstawie wybranego zestawu warunków. Po utworzeniu raportu niestandardowego możesz go edytować, aby w razie potrzeby dodawać lub usuwać dane i wymiary. Możesz na przykład zawęzić analizę do konkretnego tokena dostępu, aplikacji dewelopera lub serwera proxy interfejsu API. Więcej informacji znajdziesz w artykule Informacje o danych, wymiarach i filtrach Analytics.

Więcej informacji znajdziesz w artykule Tworzenie raportów niestandardowych.

Aby utworzyć raport niestandardowy:

  1. Kliknij blok na tablicy, aby wyświetlić więcej szczegółów.

    Wybierz blok

  2. W panelu po prawej stronie kliknij Utwórz raport niestandardowy.

    utwórz raport

    W nowej karcie pojawi się strona raportu niestandardowego z wstępnie wypełnionymi odpowiednimi polami.

    Uwaga: więcej informacji o domyślnych ustawieniach raportów niestandardowych znajdziesz w artykule Tworzenie raportów niestandardowych.

    Edytuj raport

  3. Zmodyfikuj raport niestandardowy według potrzeb. Zobacz Zarządzanie raportami niestandardowymi.

  4. Kliknij Zapisz, aby zapisać raport niestandardowy.

Raport jest domyślnie generowany na podstawie danych zebranych w ciągu ostatniej godziny, a są one wyświetlane w panelu raportu niestandardowego. Przeczytaj sekcję Poznawanie panelu raportów niestandardowych.

Na stronie Raporty raporty niestandardowe generowane za pomocą interfejsu API Monitoring są nazywane w tym formacie: API Monitoring Investigate Generated.

Badanie konkretnego alertu

Aby sprawdzić konkretny alert, wybierz jego nazwę na stronie Historia alertów. Pojawi się panel Zbadaj. Zwróć uwagę, że u góry panelu znajduje się wykres, który zawiera tylko informacje związane z alertem:

strona alertu

  • Wyświetlanie szczegółów ruchu z interfejsu API w momencie wywołania alertu.
  • Wyświetlanie informacji kontekstowych o alercie, w tym czasu jego wywołania na środku wykresu.
  • Aby wyświetlić szczegóły warunku w wyskakującym okienku, kliknij Szczegóły warunku.
  • Kliknij Poradnik (jeśli jest dostępny), aby wyświetlić scenariusz dotyczący alertu:

    link do poradnika

  • Kliknij Zarządzaj alertem, aby edytować alert.

  • Kliknij Wyświetl raport (jeśli jest dostępny), aby wyświetlić raport niestandardowy.

  • W razie potrzeby włącz lub wyłącz automatyczne odświeżanie strony.