Analizowanie problemów

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

Panel Zbadaj umożliwia wyświetlanie tabel przestawnych danych i atrybutów dotyczących całego ruchu API oraz porównywanie aktywności relacyjnej między danymi w celu szybszego badania i diagnozowania problemów. W panelu możesz uzyskać dostęp do danych z ostatnich 30 dni.

Aby otworzyć panel Zbadaj, w interfejsie Edge wybierz Analizuj > Monitorowanie interfejsu API > Zbadaj. Panel ma 2 główne obszary:

• Kod stanu umożliwia analizowanie danych dotyczących kodów stanu w przypadku proxy interfejsów API i usług docelowych.
• Czas oczekiwania umożliwia analizowanie problemów z czasem oczekiwania w przypadku proxy interfejsów API i usług docelowych.

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

Używanie panelu Zbadaj do diagnozowania problemu

Na przykład otrzymujesz 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 macierz kod błędu a czas , aby zobaczyć aktywność kodu błędu w ciągu ostatniej godziny.
2. Przełącz się na macierz kod błędu a stan HTTP , aby zidentyfikować konkretne kody stanu HTTP powiązane z kodami błędów, których liczba wzrosła w ciągu ostatniej godziny, jak ustalono w poprzednim kroku.
3. Przełącz się na macierz kod błędu a proxy , aby zidentyfikować proxy interfejsów API, które wywołują kody błędów zidentyfikowane w poprzednim kroku.
4. Kliknij pole w macierzy powiązane z proxy interfejsu API o dużej liczbie kodów błędów, aby wyświetlić więcej szczegółów i uzyskać dostęp do logów.
5. Skonfiguruj alert i utwórz raport niestandardowy, aby ułatwić diagnozowanie problemu.

6. Dalsze rozwiązywanie problemów z proxy interfejsu API za pomocą śledzenia i innych narzędzi w celu znalezienia rozwiązania.

Korzystanie z panelu Kod stanu

Panel Kod stanu umożliwia analizowanie danych dotyczących kodów stanu w przypadku proxy interfejsów API i usług docelowych w Twojej organizacji. Dane dotyczące kodów stanu możesz wyświetlać w oknie 1-godzinnym lub 4-godzinnym w dowolnym momencie w ciągu ostatnich 30 dni.

Przeglądanie panelu Kod stanu

Aby wyświetlić panel Kod stanu, w interfejsie Edge wybierz Analizuj > Monitorowanie interfejsu API > Zbadaj. Domyślnie wyświetla się panel Kod stanu:

Jak widać na ilustracji, panel Zbadaj umożliwia:

• Konfigurowanie każdej macierzy przez ustawienie osi x i y w celu porównania aktywności relacyjnej między danymi i uzyskania większej ilości informacji.
• Szybkie identyfikowanie danych, które mają największe względne wartości, na podstawie cieniowania bloku. Im ciemniejszy blok, tym większa względna wartość.
• Klikanie bloku w macierzy, aby wyświetlić szczegóły danych.
• Filtrowanie danych na podstawie tych kryteriów:
  • Środowisko
  • Region
  • Proxy
  • Kody stanu (w tym cały ruch, wszystkie błędy, 2xx, 4xx lub 5xx)
  • Data i godzina w ciągu ostatnich 30 dni
  • Okres 1-godzinny lub 4-godzinny

Za pomocą panelu możesz szybko wykonywać te czynności:

• Dostęp do logów w panelu szczegółów danych.
• Wyświetlanie bieżącego kontekstu w panelu Ostatnie, Oś czasu lub panelu, klikając odpowiednio > Wyświetl w sekcji Ostatnie lub Wyświetl na osi czasu.
• Tworzenie raportu niestandardowego i dodawanie dodatkowych wymiarów przez kliknięcie .
• Tworzenie alertu i dodawanie dodatkowych warunków alertu, konfigurowanie powiadomień i generowanie raportu niestandardowego na podstawie alertu.

Konfigurowanie macierzy Kod stanu

Gdy wybierzesz panel Kod stanu, domyślnie pojawią się te macierze:

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

Skonfiguruj każdą macierz, aby porównać dowolne 2 z tych danych, wybierając wartość z list oś x i oś y:

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

Wyświetlanie szczegółów danych Kod stanu

Aby wyświetlić szczegóły konkretnych danych, kliknij ich blok w macierzy.

W panelu po prawej stronie wyświetlają się szczegóły dotyczące podejrzewanej przyczyny, w tym:

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

Szczegóły mogą też obejmować:

• Zasada dotycząca błędów – informacje o zasadzie, która spowodowała błąd środowiska wykonawczego, w tym typ zasady (nazwa wewnętrzna) i nazwa zasady zdefiniowana przez użytkownika. Nazwę określasz podczas dołączania zasady do przepływu proxy interfejsu API.
• Nazwa proxy
• Kod stanu HTTP
• Kod błędu

Jeśli liczność konkretnych danych jest większa niż 1, panel szczegółów może zawierać szczegóły rozkładu błędów, np. Rozkład według aplikacji dewelopera, Rozkład według zasady dotyczącej błędów, Rozkład według kodu błędu, Rozkład według stanu HTTP itp. Na przykład:

Jeśli źródłem błędu jest cel, panel szczegółów będzie zawierać informacje o odsetku błędów według celu. Na przykład:

Korzystanie z panelu Czas oczekiwania

Panel Czas oczekiwania wyświetla informacje o czasie oczekiwania w przypadku proxy interfejsów API i usług docelowych w Twojej organizacji. Dane dotyczące czasu oczekiwania możesz analizować w oknie 1-godzinnym w dowolnym momencie w ciągu ostatnich 30 dni.

Przeglądanie panelu Czas oczekiwania

Aby wyświetlić panel Czas oczekiwania, w interfejsie Edge wybierz Analizuj > Monitorowanie interfejsu API > Zbadaj. Domyślnie wyświetla się panel Kod stanu. Aby wyświetlić panel Czas oczekiwania, w obszarze filtra wybierz Czas oczekiwania:

Gdy wybierzesz panel Czas oczekiwania, domyślnie pojawią się te macierze:

• Proxy a czas (maksymalny czas oczekiwania w milisekundach)
• Proxy a łączny czas oczekiwania (maksymalny czas oczekiwania w milisekundach)
• Proxy a czas oczekiwania wszystkich celów (maksymalny czas oczekiwania w milisekundach)

Aby wyświetlić czasy oczekiwania celu, w menu Proxy wybierz Cel.

Domyślnie panel Czas oczekiwania wyświetla informacje o 10 proxy z największym łącznym czasem oczekiwania P99 w poprzedniej godzinie. Możesz też użyć menu 10 najpopularniejszych, aby wybrać konkretne proxy lub kolekcję.

Panel Czas oczekiwania ma wszystkie funkcje panelu Kod stanu, ale z tymi różnicami:

• Możesz skonfigurować tylko centyl łącznego czasu oczekiwania na odpowiedź (p50, p90, p95, p99).
• W przypadku danych dotyczących czasu oczekiwania możesz wybrać tylko okno 1-godzinne.
• W filtrach nie możesz wybrać opcji Dowolny w przypadku Regionu. Aby wyświetlić dane, musisz wybrać konkretny region.

Wyświetlanie szczegółów danych Czas oczekiwania

Aby wyświetlić szczegóły konkretnych danych, kliknij ich blok w macierzy.

W panelu po prawej stronie wyświetlają się szczegóły dotyczące czasu oczekiwania proxy (niebieska linia) i celu (fioletowa linia), w tym:

• Łączny czas oczekiwania (czas oczekiwania proxy plus czas oczekiwania celu)
• Czas oczekiwania na cel (czas odpowiedzi celu)
• Rozkład według stanu HTTP

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

Wykres Czas oczekiwania na cel przedstawia 16 najpopularniejszych celów na podstawie maksymalnego czasu oczekiwania. Każdy cel ma swój wykres. Najedź kursorem na wykres lub wybierz listę, aby określić, który wykres odpowiada danemu celowi.

Wyświetlanie logów ze szczegółów danych

Gdy wyświetlasz szczegóły danych dotyczące kodów stanu lub czasu oczekiwania, kliknij Wyświetl logi , aby wyświetlić wszystkie logi dotyczące wybranych danych:

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

Logi możesz dodatkowo filtrować według tych kryteriów:

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

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

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 dodawać lub usuwać dane i wymiary. Możesz na przykład zawęzić analizę do konkretnego tokena dostępu, aplikacji dewelopera lub proxy interfejsu API. Więcej informacji znajdziesz w artykule Dane, wymiary i filtry Analytics.

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

Aby utworzyć raport niestandardowy:

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

   

2. W panelu po prawej stronie kliknij .

   

   Strona raportu niestandardowego otworzy się w nowej karcie z wstępnie wypełnionymi odpowiednimi polami.

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

   

3. W razie potrzeby edytuj raport niestandardowy. Więcej informacji znajdziesz w artykule Zarządzanie raportami niestandardowymi.

4. Aby zapisać raport niestandardowy, kliknij Zapisz.

Domyślnie raport jest uruchamiany na podstawie danych zebranych w ciągu ostatniej godziny, a dane są wyświetlane w panelu raportu niestandardowego. Więcej informacji znajdziesz w artykule Przeglądanie panelu raportów niestandardowych.

Na stronie Raporty raporty niestandardowe generowane za pomocą monitorowania interfejsu API mają format nazwy API Monitoring Investigate Generated.

Analizowanie konkretnego alertu

Aby zbadać konkretny alert, na stronie Historia alertów kliknij jego nazwę. Pojawi się panel Zbadaj. U góry panelu znajduje się wykres, który zawiera tylko informacje dotyczące alertu:

• Wyświetl szczegóły ruchu API w momencie wywołania alertu.
• Wyświetl informacje kontekstowe o alercie, w tym godzinę wywołania alertu w środku wykresu.
• Kliknij Szczegóły warunku , aby wyświetlić szczegóły warunku alertu w wyskakującym okienku.

• Kliknij Scenariusz (jeśli jest dostępny), aby wyświetlić scenariusz alertu:

  

• Aby edytować alert, kliknij Zarządzaj alertem.

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

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