Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje
Panel Zbadaj umożliwia wyświetlanie tabel przestawnych z danymi i atrybutami całego ruchu API oraz porównywanie aktywności między danymi w celu szybszego badania i diagnozowania problemów. W panelu możesz wyświetlać dane z ostatnich 30 dni.
W interfejsie użytkownika Edge wybierz Analiza > Monitorowanie interfejsów API > Zbadaj, aby otworzyć panel Investivate. Panel zawiera 2 główne obszary:
- Kod stanu pozwala analizować wskaźniki kodu stanu dotyczące serwerów proxy interfejsu API i usług docelowych.
- Czas oczekiwania pozwala analizować problemy z opóźnieniami serwerów proxy interfejsu API i usług docelowych.
W panelu Zbadaj też możesz sprawdzić problemy spowodowane przez określony alert. Po wystąpieniu alertu kliknij jego nazwę na stronie Historia alertów, aby otworzyć go w panelu Invesitgate.
Zdiagnozuj problem za pomocą panelu Zbadaj problem
Otrzymasz na przykład 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:
- Wyświetl tabelę kodów błędów i czasu, aby zobaczyć aktywność związaną z kodami błędów w ciągu ostatniej godziny.
- Przełącz się na macierz kodów błędów a stan HTTP, by zidentyfikować określone kody stanu HTTP powiązane z kodami błędów, których liczba wzrosła w ciągu ostatniej godziny (zgodnie z opisem w poprzednim kroku).
- Przejdź na macierz kodów błędów a serwer proxy, aby zidentyfikować serwery proxy interfejsu API, które wywołują kody błędów zidentyfikowane w poprzednim kroku.
- 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 dzienniki dostępu.
- Skonfiguruj alert i utwórz raport niestandardowy, aby ułatwić diagnozowanie problemu.
Aby znaleźć rozwiązanie problemu, nadal troubleshoot 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 usług proxy interfejsu API i usług docelowych w organizacji. W każdej chwili z ostatnich 30 dni możesz wyświetlić dane kodu stanu z godzinne lub czterech godzin.
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 domyślnie wyświetla się:
Jak zaznaczyliśmy na ilustracji, panel Zbadaj umożliwia:
- Skonfiguruj każdą macierz, ustawiając jej oś X i Y, aby porównać aktywność relacyjną między danymi i uzyskać więcej informacji.
- Dzięki odcienieniu kolorów bryły można szybko zidentyfikować dane o największej względnej objętości. Im ciemniejszy blok, tym większa głośność.
- Kliknij blok w tablicy, aby wyświetlić szczegóły danych.
- Dane możesz filtrować 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- lub 4-godzinne
Korzystając z 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, na Osi czasu lub w panelu, kliknij kolejno
> > lub >. - Utwórz raport niestandardowy i dodaj dodatkowe wymiary, klikając
. - Utwórz alert i dodaj kolejne warunki alertu, skonfiguruj powiadomienia oraz wygeneruj raport niestandardowy na podstawie alertu.
Konfigurowanie macierzy kodów stanu
W panelu Kod stanu domyślnie wyświetlane są te macierze:
- Kod błędu a czas
- Kod błędu a stan HTTP
- Źródło błędu a serwer proxy interfejsu API
Skonfiguruj każdą z tabel, aby porównać dowolne dwa z tych rodzajów danych, wybierając wartość na listach x- i x-:
- 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 zasady dotyczące ServiceCallout). Jeśli celem jest zasada ServiceCallout, wyświetlana wartość jest poprzedzona ciągiem
sc://. na przykładsc://my.endpoint.net).
Wyświetl szczegóły danych kodu stanu
Aby wyświetlić szczegóły konkretnego wskaźnika, kliknij jego blok w macierzy.
Szczegóły dotyczące domniemanej przyczyny są wyświetlane w panelu po prawej stronie, w tym:
- Środowisko
- Organizacja
- Region
- Źródło błędu (infrastruktura proxy, docelowa lub Apigee)
Mogą one obejmować również:
- Zasady dotyczące błędów – informacje o zasadzie, która spowodowała błąd środowiska wykonawczego, w tym typ zasady (nazwa wewnętrzna) i nazwa zdefiniowana przez użytkownika. Nazwę określasz podczas dołączania zasady do procesu serwera proxy interfejsu API.
- Nazwa serwera proxy
- Kod stanu HTTP
- Kod błędu
Jeśli moc zbioru jest większa niż 1 w przypadku danego rodzaju danych, panel szczegółów może zawierać szczegółowe informacje o rozkładzie błędów, np. Rozpowszechnianie według aplikacji dewelopera, Dystrybucja według błędów, Dystrybucja według kodu błędu, Dystrybucja według stanu HTTP itd. Na przykład:
Jeśli źródło błędu jest celem, w panelu szczegółów pojawi się odsetek błędów według celu. Na przykład:
Użyj panelu Czas oczekiwania
W panelu Czas oczekiwania wyświetlane są informacje o czasie oczekiwania serwerów proxy interfejsów API i usług docelowych w organizacji. W dowolnym momencie z ostatnich 30 dni możesz przeanalizować wskaźniki czasu oczekiwania z godzinnego okna.
Poznaj panel Opóźnienie
Aby wyświetlić panel czasu oczekiwania, w interfejsie użytkownika Edge wybierz Analiza > Monitorowanie interfejsów API > Zbadaj. Domyślnie wyświetlany jest panel kodów stanu. Wybierz Czas oczekiwania w obszarze filtra, aby wyświetlić panel Opóźnienie:
Po wybraniu panelu Czas oczekiwania domyślnie wyświetlają się te macierze:
- Serwer proxy a czas (maksymalne opóźnienie w milisekundach)
- Serwer proxy a całkowity czas oczekiwania (maksymalne opóźnienie w milisekundach)
- Czas oczekiwania na serwer proxy a wszystkie docelowe wartości (maksymalne opóźnienie w milisekundach)
Aby wyświetlić docelowe czasy oczekiwania, w menu Serwer proxy wybierz opcję Kieruj.
Domyślnie panel czasu oczekiwania wyświetla informacje o 10 serwerach proxy o największym łącznym czasie oczekiwania (99 centyl) w ciągu ostatniej godziny. Możesz też w menu Najlepsze 10 wybrać inny serwer proxy lub kolekcję.
Panel Czas oczekiwania zawiera wszystkie funkcje panelu Kod stanu, z następującymi różnicami:
- Konfigurujesz tylko centyl łącznego czasu oczekiwania na odpowiedź (p50, p90, p95, p99).
- Dla wskaźników czasu oczekiwania możesz wybrać tylko jednogodzinne okno.
- W filtrach nie możesz wybrać opcji Dowolny dla regionu. Musisz wybrać konkretny region do wyświetlenia.
Wyświetl szczegóły wskaźnika czasu oczekiwania
Aby wyświetlić szczegóły konkretnego wskaźnika, kliknij jego blok w macierzy.
Szczegóły dotyczące czasu oczekiwania serwera proxy (niebieska linia) i celu (fioletowa linia) są wyświetlane w prawym panelu, w tym:
- Całkowity czas oczekiwania (czas oczekiwania na serwer proxy plus docelowy czas oczekiwania)
- Czas oczekiwania na cel (docelowy czas reakcji)
- Rozkład według stanu HTTP
Aby wyświetlić szczegółowe informacje, najedź kursorem na wykres:
Wykres Czas oczekiwania na cel pokazuje 16 najczęstszych celów na podstawie maksymalnego czasu oczekiwania, na jednym wykresie dla każdego celu. Najedź kursorem na wykres lub wybierz listę rozwijaną, aby wyświetlić 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:
Otworzy się okno Logi ruchu z maksymalnie 1000 wpisów logu. Kliknij wpis logu, aby rozwinąć jego szczegóły na liście:
Logi możesz filtrować według tych kryteriów:
- Źródło wizyt
- Typ błędu
- Minimalny czas odpowiedzi
Nie można pobrać danych logów w oknie Logi 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ę 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ć, dodając lub usuwając dane i wymiary zgodnie z potrzebami. 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:
Kliknij bryłę w macierzy, aby wyświetlić więcej szczegółów.
W panelu po prawej stronie kliknij
.
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.
Zmodyfikuj raport niestandardowy zgodnie z potrzebami. Patrz Zarządzanie raportami niestandardowymi.
Kliknij Zapisz, aby zapisać raport niestandardowy.
Raport jest domyślnie generowany na podstawie danych zgromadzonych w ciągu ostatniej godziny, a te dane są wyświetlane w panelu raportu niestandardowego. Więcej informacji znajdziesz w artykule Korzystanie z panelu raportów niestandardowych.
Na stronie Raporty raporty niestandardowe generowane za pomocą interfejsu API Monitoring mają nazwy w tym formacie: API Monitoring Investigate Generated.
Badanie konkretnego alertu
Aby zbadać 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:
- Wyświetlanie szczegółów ruchu z interfejsu API w momencie wywołania alertu.
- Wyświetlaj informacje kontekstowe dotyczące alertu, w tym czas 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ć poradnik dotyczący alertu:
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.