Monitorowanie ostatniego ruchu z interfejsu API

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Panel Ostatnie umożliwia monitorowanie najnowszego ruchu API dla wszystkich serwerów proxy interfejsów API i usług docelowych w Twojej organizacji w ciągu ostatniej godziny. Dane monitorowania interfejsów API można wyświetlać w postaci szczegółowej listy lub mapy termicznej. Zapoznaj się ze wszystkimi widokami w tych sekcjach:

• Korzystanie z widoku listy
• Korzystanie z mapy termicznej

Korzystanie z widoku listy

Widok listy zawiera podsumowanie informacji o serwerach proxy interfejsu API i usługach docelowych w Twojej organizacji, w przypadku których zarejestrowano ruch w ostatnim czasie.

Przeglądanie widoku listy

Aby wyświetlić widok listy, w interfejsie użytkownika Edge wybierz Analiza > Monitorowanie interfejsów API > Ostatnie.

Domyślnie wyświetlany jest widok listy. W każdej chwili możesz wrócić do widoku listy, klikając w panelu Ostatnie.

Jak zaznaczyliśmy na ilustracji, widok listy umożliwia:

• Wyświetl podsumowanie informacji o wszystkich serwerach proxy API i usługach docelowych w organizacji, które zostały zrealizowane w ciągu ostatniej godziny. Serwery proxy interfejsów API i usługi docelowe są wymienione według regionu i środowiska. (Aby uzyskać szerszy widok historyczny, zobacz Identyfikowanie trendów w danych monitorowania interfejsu API).
• Szybko identyfikuj serwery proxy interfejsu API i docelowe usługi, które mają alerty. (Więcej informacji o konfigurowaniu alertów znajdziesz w artykule Konfigurowanie alertów i powiadomień).
• Kliknij nazwę serwera proxy interfejsu API lub usługi docelowej na liście, aby wyświetlić szczegółowe dane w panelu po prawej stronie.

• Korzystając z bieżącego kontekstu, możesz szybko wykonać następujące czynności (opcje są wyszarzone, jeśli nie mają zastosowania do aktualnie wybranego kontekstu):

  • Utwórz raport niestandardowy i dodaj dodatkowe wymiary. Kliknij .
  • Utwórz alert i dodaj kolejne warunki alertu, skonfiguruj powiadomienia oraz wygeneruj raport niestandardowy na podstawie alertu.
  • Wyświetl bieżący kontekst w panelu Oś czasu lub Zbadaj. Kliknij odpowiednio > Wyświetl na osi czasu lub Wyświetl w narzędziu do analizy zagrożeń.

• Wyszukaj widok listy według nazwy lub adresu URL (np. https://acme.com/api). Wpisz w polu wyszukiwania cały ciąg lub jego część. Treści możesz wyszukiwać w polach Serwer proxy, Cel i Region.

  Uwaga: jeśli wybierzesz filtr Tylko alerty, w wynikach wyszukiwania pojawią się tylko serwery proxy interfejsu API lub usługi docelowe z alertami.

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

• Pokaż i ukryj szczegóły usługi docelowej na liście.

Zidentyfikuj serwery proxy interfejsu API i usługi docelowe z alertami

Czerwona ikona ostrzeżenia i lewa linia brzegowa wskazują, które serwery proxy interfejsu API i usługi docelowe mają alerty w widoku listy.

Kliknij Tylko alerty, aby wyświetlić tylko serwery proxy interfejsu API lub cele usług, z którymi są powiązane alerty.

Aby wyświetlić krótkie podsumowanie liczby błędów 4xx i 5xx oraz ogólny odsetek błędów, najedź kursorem myszy na dowolną wartość liczbową w tabeli.

Wyświetlanie szczegółowych danych dotyczących serwera proxy interfejsu API lub usługi docelowej

Aby wyświetlić szczegółowe dane serwera proxy interfejsu API lub usługi docelowej, kliknij jego nazwę w widoku listy. Szczegółowe dane zostaną wyświetlone w panelu po prawej stronie.

Aby wyświetlić więcej informacji, kliknij te karty:

• Szczegóły
• Trendy
• Dzienniki

Dodatkowo, korzystając z bieżącego kontekstu, możesz szybko wykonać te czynności:

Uwaga: opcje są wyszarzone, jeśli nie mają zastosowania do wybranego kontekstu.

• Utwórz raport niestandardowy i dodaj dodatkowe wymiary. Kliknij .
• Utwórz alert i dodaj kolejne warunki alertu, skonfiguruj powiadomienia oraz wygeneruj raport niestandardowy na podstawie alertu. Kliknij > Utwórz alert.
• Wyświetl bieżący kontekst w panelu Oś czasu lub Zbadaj. Kliknij odpowiednio > Wyświetl na osi czasu lub Wyświetl w narzędziu do analizy zagrożeń.

Szczegóły

Karta Szczegóły zawiera szybki podgląd danych o ruchu w określonej osi czasu (przedstawiony na poprzedniej ilustracji), w tym:

Szczegóły	Opis
Łączny ruch	Łączna liczba transakcji.
Łączna liczba błędów	Łączna liczba błędów.
Całkowity odsetek błędów	Odsetek ruchu, który spowodował błędy (łączna liczba błędów/łączny ruch). Uwaga: interfejs API Monitoring porównuje tę wartość procentową z ustawionymi przez Ciebie warunkami alertu. Jeśli łączny odsetek błędów przekroczy wartości progowe, w interfejsie pojawią się wskaźniki alertów.
Średnia wartość TPS	Średnia liczba transakcji na sekundę.
Całkowity czas oczekiwania (P99)	Całkowity czas oczekiwania na odpowiedź w 99. centylu obliczony w ciągu 5-minutowego okresu. Uwaga: opcja widoczna tylko w przypadku serwerów proxy interfejsu API.
Czas oczekiwania (P99)	Wartość docelowego czasu oczekiwania na odpowiedź w 99 centylu obliczona w ciągu 5 minut. Uwaga: opcja widoczna tylko w przypadku serwerów proxy interfejsu API.
Źródło błędu	Zestawienie i łączny odsetek błędów pakietu proxy API (4xx i 5xx), które wystąpiły.

Trendy

Na karcie Trendy znajdziesz te wykresy dla wybranego komponentu:

• Odsetek błędów 4xx i 5xx
• Ruch (TPS)
• Całkowity czas oczekiwania (ms)

• Czas oczekiwania dla wszystkich celów

Najeżdżaj kursorem na różne punkty na wykresie, aby zobaczyć krótkie wartości procentowe błędów, łączną liczbę wizyt i czas oczekiwania w przypadku każdego z nich.

Logi

Na karcie Logi ustaw filtrowanie według błędów 4xx, 5xx lub Wszystkie i zawęź źródło błędów według serwera proxy interfejsu API, usługi docelowej (Twoja usługa) lub Apigee (infrastruktura Apigee).

Kliknij błąd, aby otworzyć okno logów i rozwinąć jego szczegóły na liście.

Korzystanie z mapy termicznej

Mapa termiczna zawiera widok kolorowych bloków, który umożliwia określenie środowisk, w których występują alerty.

• Zielony oznacza, że progi warunku alertu nie zostały przekroczone.
• Czerwony oznacza, że progi warunków alertu zostały przekroczone i wywołano alerty.

Badanie mapy termicznej

Kliknij na stronie Ostatnie, aby wyświetlić mapę termiczną, którą widać na ilustracji poniżej.

Jak pokazano na poprzedniej ilustracji, mapa termiczna umożliwia:

• Szybko zidentyfikuj serwery proxy interfejsu API i usługi docelowe z alertami. (Więcej informacji o konfigurowaniu alertów znajdziesz w artykule Konfigurowanie alertów i powiadomień).
• Filtrowanie widoku możesz filtrować, wybierając komponenty z list lub klikając dwukrotnie pole, aby przejść do bardziej szczegółowego widoku. Na listach serwerów proxy i celów możesz filtrować dane, korzystając z kolekcji. Przykład:
• Kliknij bryłę na mapie termicznej, aby wyświetlić szczegółowe dane w panelu po prawej stronie.

• Korzystając z bieżącego kontekstu, możesz szybko wykonać następujące czynności (opcje są wyszarzone, jeśli nie mają zastosowania do aktualnie wybranego kontekstu):

  • Utwórz raport niestandardowy i dodaj dodatkowe wymiary. Kliknij .
  • Utwórz alert i dodaj kolejne warunki alertu, skonfiguruj powiadomienia oraz wygeneruj raport niestandardowy na podstawie alertu. Kliknij > Utwórz alert.
  • Wyświetl bieżący kontekst w panelu Oś czasu lub Zbadaj. Kliknij odpowiednio > Wyświetl na osi czasu lub Wyświetl w narzędziu do analizy zagrożeń.

• Ustaw skalę wyświetlania mapy termicznej, ustawiając argument skalowany według na logarytmiczne lub liniowe. Funkcja liniowa zmienia rozmiary pól zgodnie z ogólnymi współczynnikami ruchu. Na przykład serwer proxy z 200 wywołaniami jest dwukrotnie większy niż serwer proxy ze 100 wywołaniami.

  

• Aby przeszukać mapę termiczną, wpisz w polu wyszukiwania cały ciąg lub jego część. Możesz wyszukiwać treści w regionie, środowisku, serwerze proxy lub na mapach docelowych w zależności od tego, co jest aktualnie wyświetlane.

  Uwaga: jeśli wybierzesz filtr Tylko alerty, w wynikach wyszukiwania pojawią się tylko serwery proxy interfejsu API lub usługi docelowe z alertami.

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

Zidentyfikuj serwery proxy interfejsu API i usługi docelowe z alertami

Podczas wyświetlania mapy termicznej red blok wskazuje, które środowiska, serwery proxy API i usługi docelowe mają alerty. Więcej informacji o konfigurowaniu alertów znajdziesz w artykule Konfigurowanie alertów i powiadomień.

Na przykład ten rysunek przedstawia 2 środowiska:

• środowisko testowe ma kolor red, ponieważ odsetki błędów ruchu w nim przekroczyły próg warunku alertu ustawiony w określonym przedziale czasu.
• środowisko prod jest zielone, ponieważ odsetki błędów ruchu nie przekroczyły progu warunku alertu we wskazanym okresie.

Aby odfiltrować dane, wybierz komponenty z list. Możesz też dwukrotnie kliknąć pole, aby przejść od mapy środowiska do mapy serwera proxy interfejsu API oraz z mapy serwera proxy interfejsu API na docelowe usługi tego serwera, aby zidentyfikować serwery proxy API i usługi docelowe, z którymi są wysyłane alerty.

Środowisko >>	Serwer proxy >>	Target

Kliknij Tylko alerty, aby wyświetlić tylko środowiska, serwery proxy interfejsów API lub cele usług, które mają alerty (w zależności od tego, co jest aktualnie wyświetlane).

Aby wrócić na wyższy poziom, kliknij .

Wyświetlanie szczegółowych danych dotyczących środowiska, serwera proxy interfejsu API lub usługi docelowej

Aby wyświetlić szczegółowe dane dotyczące środowiska, serwera proxy interfejsu API lub usługi docelowej, kliknij odpowiednie pole na mapie termicznej. Szczegółowe dane zostaną wyświetlone w panelu po prawej stronie.

Karty zawierają te same informacje, które są dostępne w widoku listy. Aby dowiedzieć się więcej, zobacz:

• Szczegóły
• Trendy
• Dzienniki

Klikając pole na mapie, możesz też szybko sprawdzić liczbę połączeń i odsetek błędów w ciągu ostatniej godziny.

Tworzenie raportu niestandardowego na podstawie panelu Ostatnie

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 na podstawie panelu Ostatnie:

1. W interfejsie użytkownika Edge kliknij Analiza > Monitorowanie interfejsów API > Najnowsze.

2. Aby wyświetlić więcej informacji, wybierz serwer proxy interfejsu API lub usługę docelową w menu filtra Widok listy lub filtr Mapa termiczna. Uwaga: raporty niestandardowe nie są dostępne, jeśli filtry serwerów proxy i celów mają wartość All.

3. W prawym górnym rogu kliknij .

   

   W nowej karcie pojawi się strona raportu niestandardowego, a odpowiednie pola będą już wstępnie wypełnione oraz domyślne wymiary i dane. Domyślna nazwa raportu niestandardowego to: API Monitoring Recent Generated Uwaga: jeśli raport niestandardowy istnieje już dla bieżącego kontekstu, zostanie otwarty.

4. Wprowadź zmiany w raporcie niestandardowym i kliknij Zapisz.

5. Kliknij nazwę raportu na liście i wygeneruj raport niestandardowy.