Metryki
Strona Metrics (pasek boczny > Metrics) daje Ci głębszy wgląd analityczny w użycie Twojego API. Pokazuje ogólny rozkład wyników (outcome) i dzieli ruch według klucza API, IP klienta lub domeny docelowej.
Jeśli szukasz podsumowań w czasie rzeczywistym i wykresów osi czasu (Concurrency, Requests, Bytes, Response Time), przejdź na stronę Dashboard Overview.
Filtry
Nad stroną znajdują się dwa elementy sterujące: selektor klucza API i selektor przedziału czasowego.
Filtr klucza
Użyj rozwijanej listy API Key, aby ograniczyć widok do konkretnego klucza. Zobaczysz tylko klucze w zakresie swojego dostępu: klucze osobiste, klucze organizacji, którymi zarządzasz, lub klucze udostępnione w zespołach.
Selektor przedziału
Użyj przycisków przedziału, aby kontrolować okno czasowe:
| Przycisk | Okno |
|---|---|
| 1M | Ostatnia 1 minuta |
| 5M | Ostatnie 5 minut |
| 30M | Ostatnie 30 minut |
| 1H | Ostatnia 1 godzina |
| 6H | Ostatnie 6 godzin |
| 1D | Ostatnie 24 godziny |
Zarówno wykres kołowy, jak i tabela dostosowują się do Twojego wyboru.
Rozkład wyników (Outcome)
Wykres kołowy na górze pokazuje podział na sukcesy i błędy dla wybranego przedziału. Najedź na dowolny fragment, aby zobaczyć dokładną liczbę requestów i ich procentowy udział. Użyj go, aby szybko sprawdzić, czy nagły spadek wskaźnika sukcesu pokryca się z konkretną kategorią wyniku.
Typy wyników (Outcome)
Każdy request API jest klasyfikowany do dokładnie jednego wyniku (outcome). Tylko success wlicza się do Twojego płatnego limitu.
| Outcome | Warstwa | Znaczenie |
|---|---|---|
success |
n/a | Request dostarczył prawidłową odpowiedź. Bez reguł validate oznacza to HTTP 200. Jeśli wysłałeś reguły validate, każda odpowiedź zaakceptowana przez Twoje reguły liczy się jako sukces, niezależnie od statusu HTTP. |
application_error |
target | Cel zwrócił HTTP 200, ale body odpowiedzi zawierało pole błędu. |
application_fail |
target | Cel zwrócił status inny niż 2xx, którego nie zaakceptowały Twoje reguły validate, lub nie zwrócił żadnej odpowiedzi. |
client_error |
caller | Twój request został odrzucony zanim opuścił FourA: błędne parametry, nieprawidłowa wartość proxy lub URL wskazujący na prywatny/zarezerwowany adres IP (ochrona SSRF). |
rate_limit |
FourA | Request został odrzucony przez Twój limit RPM lub współbieżności. Zobacz Rate Limits. |
service_error |
FourA | Backend zwrócił status 5xx lub odpowiedział z body, którego nie mogliśmy sparsować. |
service_fail |
FourA | Błąd sieciowy: timeout, odrzucenie połączenia, błąd DNS, rozłączenie klienta. |
Kolumna warstwy wskazuje, kto odpowiada za dany wynik: target oznacza wywoływaną stronę, caller oznacza, że Twój request był nieprawidłowy, a FourA oznacza, że nie mogliśmy go przetworzyć.
Jeśli używasz validate.status.accept to allow specific non-200 codes (na przykład [200, 403]), te odpowiedzi wrócą jako success zamiast application_fail. Klasyfikacja zależy od decyzji silnika dotyczącej Twoich reguł, a nie od surowego kodu HTTP.
Pełną taksonomię i informacje o tym, jak przekłada się ona na rozliczenia, znajdziesz w sekcji Request Outcomes.
Tabela użycia z wieloma widokami
Poniżej wykresu kołowego znajduje się tabela użycia, która dzieli ruch na trzy karty widoku:
| Karta | Grupuje dane według |
|---|---|
| API Key | Każdego z Twoich kluczy API |
| Client IP | Źródłowych adresów IP wykonujących requesty |
| Domain | Domen docelowych w Twoich requestach |
Każda karta obsługuje cztery przełączniki zakresu po prawej stronie, które zmieniają wyświetlane kolumny:
| Zakres | Co pokazuje |
|---|---|
| Bandwidth | Liczbę requestów, bajty wejściowe, bajty wyjściowe |
| Response Time | Liczbę requestów, minimalne, średnie i maksymalne opóźnienie |
| Concurrency | Liczbę requestów oraz liczbę współbieżnych requestów (tylko w widoku API Key) |
| Outcomes | Liczbę requestów oraz podział według wyników (outcome) |
Powiązane
- Dashboard Overview: Statystyki w czasie rzeczywistym i wykresy osi czasu
- Request Outcomes: Szczegółowe wyjaśnienie siedmiu wartości outcome
- API Errors: Jak błędy są zwracane przez sieć