Metryki
Strona Metrics (pasek boczny > Metrics) zapewnia bardziej szczegółowy wgląd analityczny w Twoje użycie. Zawiera jeden panel, Usage, który dzieli Twój ruch na grupy i wyświetla łączne wartości dla całego okresu nad stroną z wierszami.
Karty podsumowujące i wykresy na osi czasu znajdziesz na stronie Dashboard Overview.
Produkt
Strona otwiera się z przełącznikiem Product: API dla żądań wysyłanych do endpointów API, Proxy dla tuneli otwieranych przez Twoje własne narzędzia przez proxy.foura.ai. Każdy produkt ma swój własny panel Usage z osobnymi widokami, zakresami i kolumnami, ponieważ tunel nie posiada licznika żądań ani kredytów. Stan przełącznika jest zapamiętywany i dostępny jako deep link w formacie #metrics/proxy.
Filtry
Nad panelem znajdują się: Product, Endpoints (tylko API), Owner, następnie Key (API) lub Proxy user (Proxy), a potem Period. Filtry Owner i Period to te same kontrolki co na stronie Overview i współdzielą one swój stan, więc przełączanie się między tymi dwiema stronami nigdy nie zmienia aktualnie przeglądanych danych.
Filtr Owner
Everything, Personal lub jedna z Twoich organizacji. Pojawia się dopiero wtedy, gdy należysz do co najmniej jednej. Wybór właściciela przebudowuje również listy rozwijane Key i Proxy user, dzięki czemu dane uwierzytelniające poprzedniego właściciela nie pozostaną aktywne po zmianie i nie zwrócą po cichu pustych wyników.
Gdy wybrany właściciel nie ma żadnych kluczy API, wliczając klucze zatrzymane, wiersz pod okresem wyświetla komunikat You have no API keys here yet. Create one to see its usage. Panele pokazują wtedy zera, ponieważ nie ma niczego do zliczenia. Zobacz Managing API Keys.
Filtry Key i Proxy User
Ograniczają zakres strony do pojedynczych danych uwierzytelniających. Widoczne są tylko te dane, do których masz dostęp: Twoje własne oraz należące do organizacji, do których należysz.
Okres
Osiem przycisków: 30M, 3H, 12H, 24H, 7D, 30D, 90D i 1Y, a także Custom dla miesiąca kalendarzowego, ostatnich 6 miesięcy, całego okresu lub dokładnego zakresu dat.
Endpoints
W produkcie API wybierz Single, Proxy Finder, Browser lub Auto, aby ograniczyć karty i tabelę do jednego endpointu. Wywołanie Auto liczy się raz, w sekcji Auto. Zakres Concurrency jest niedostępny, gdy wybrany jest endpoint.
Panel Usage
Panel odpowiada na dwa pytania jednocześnie. Karty nad tabelą opisują cały okres: liczbę zawartych w nim grup oraz sumy dla nich wszystkich. Tabela poniżej to jedna strona tych grup, posortowana według wybranej kolumny.
Oba elementy zawsze dotyczą tego samego ruchu: karty obejmują ten sam przedział czasu i te same filtry, co wiersze. Liczba grup jest podawana w pełnej formie zamiast zaokrąglonej, ponieważ dokładna liczba stanowi precyzyjną odpowiedź na pytanie „do ilu domen dotarliśmy w tym miesiącu”, podczas gdy zaokrąglenie nią nie jest.
Zmiana widoku, zakresu lub okresu powoduje ponowne załadowanie zestawu danych od pierwszej strony. Strona 4 domen nie odpowiada stronie 4 adresów IP klientów.
Kliknij nagłówek kolumny, aby posortować. W widokach Domain i Client IP dla produktu API sortowanie obejmuje całą listę przed podzieleniem jej na strony, więc górny wiersz jest rzeczywiście największy, a tabela zaczyna się ponownie od pierwszej strony. Widok API Key zawiera wszystkie klucze na jednej liście i sortuje je w miejscu. Sortowanie wraca do domyślnej kolejności zakresu po przełączeniu widoku lub zakresu albo po odświeżeniu strony: najpierw najwięcej żądań lub w sekcji Routes najwięcej prób przeglądarki przez Auto. Kliknij nagłówek z klawiszem Ctrl lub Cmd, aby zresetować. Nagłówek pierwszej kolumny zawiera także pole filtra (Filter API Keys..., Filter IPs... lub Filter Domains...), które zawęża wiersze według nazwy. W widokach Client IP i Domain wyszukuje ono tylko na bieżącej stronie, więc grupa z innej strony się nie pojawi. Klawisz Esc czyści pole.
Użycie, produkt API
Trzy widoki:
| Widok | Grupuje dane według |
|---|---|
| API Key | Każdy klucz, do którego masz dostęp |
| Client IP | Adresy źródłowe wysyłające żądania |
| Domain | Domeny docelowe w Twoich żądaniach |
Elementy wyboru zakresu zmieniają kolumny i karty:
| Zakres | Co pokazuje |
|---|---|
| Bandwidth | Liczba żądań, bajty przychodzące, bajty wychodzące oraz udział premium w tych bajtach (ruch obsłużony przez węzeł wyjściowy premium, wliczony w sumy, a nie dodany do nich) |
| Response Time | Liczba żądań, minimalne, średnie i maksymalne opóźnienie |
| Concurrency | Liczba żądań oraz liczba współbieżnych żądań (tylko widok API Key) |
| Outcomes | Liczba żądań oraz podział według wyników, z wykresem pierścieniowym wyników |
| Budget | Liczba żądań, rozliczone kredyty i zużyte kredyty. Aby wyświetlić pojedynczy endpoint, wybierz go w wierszu Endpoints |
| Routes | Liczba żądań, Twoje żądania na trasę, operacje wykonane przez Auto w tle wywołań oraz krok, który odpowiedział na każde wywołanie Auto (patrz poniżej) |
Zakres Budget rozdziela kredyty rozliczone i zużyte. Rozliczone kredyty uwzględniają tylko żądania z wynikiem success: za to płacisz w ramach swojego planu. Zużyte kredyty to kredyty raportowane przez API przy każdym żądaniu (zobacz Response Headers), w tym przy żądaniach nieudanych, i nigdy nie są one fakturowane.
Karty Budget pokazują Rozliczone kredyty z wartością z N zużytych poniżej oraz Na żądanie, czyli średnią liczbę rozliczonych kredytów na żądanie. Tabela zawiera kolumny Rozliczone kredyty i Zużyte kredyty, a sortować można według dowolnej z nich.
Zakres Routes
Routes dzieli żądania każdego klucza, adresu Client IP lub domeny według trasy i pokazuje, co Auto wykonało dla swoich wywołań. Kolumny dzielą się na trzy grupy, każda z podpisem powyżej:
| Grupa | Kolumny | Co zliczają |
|---|---|---|
| Requests by route | Single, Proxy Finder, Browser, Auto | Twoje requesty według trasy, na którą zostały wysłane. Razem tworzą Requests. Wywołanie Auto liczy się raz, w sekcji Auto. Pod każdą liczbą: jej udział w Requests. |
| Auto attempts | Single, Proxy Finder, Browser | Requesty wykonane przez Auto w każdym silniku w ramach jego wywołań, łącznie z nieudanymi. Pod każdą liczbą: próby na wywołanie Auto. |
| Auto answered by | Saved session, Plain request, Proxy Finder, Browser, Failed | Krok, który zrealizował każde wywołanie Auto. Razem tworzą Auto. Pod każdą liczbą: jej udział w Auto. |
Saved session to sesja, którą Auto miało już dla danego hosta. Browser obejmuje wywołania, w których przeglądarka najpierw otworzyła stronę, a odtworzenie jej sesji zrealizowało request. Failed obejmuje wywołania odrzucone przed uruchomieniem Auto.
Aby sprawdzić, gdzie Auto używa prawdziwej przeglądarki, sprawdź kolumnę Browser w sekcji Auto attempts. Przeglądarka zazwyczaj otwiera stronę raz, a następnie Auto ponownie wykorzystuje tę sesję za pomocą lżejszych requestów, dlatego ta kolumna ma zwykle znacznie wyższe wartości niż Browser w sekcji Auto answered by. Widok Routes otwiera się posortowany według tej wartości, więc domeny najbardziej wymagające przeglądarki pojawiają się jako pierwsze; grupy bez prób Browser są sortowane według liczby requestów.
Karty nad tabelą pokazują próby Auto w danym okresie wraz z liczbą prób na wywołanie Auto oraz każdą otwartą przeglądarkę, bezpośrednio lub przez Auto.
Próby Auto nigdy nie wliczają się do liczby Requests ani do wskaźnika powodzenia. Wliczają się natomiast do limitów rate limit i współbieżności dla Single, Proxy Finder oraz Browser w Twoim planie, tak jak na karcie Auto attempts w sekcji Overview. Po wybraniu endpointa w wierszu Endpoints, Routes pokazuje tylko tę trasę: Browser wyświetla wtedy requesty przeglądarki wysłane bezpośrednio przez Ciebie, a te uruchomione przez Auto pozostają w sekcji Auto.
Wykres pierścieniowy wyników
W zakresie Outcomes wewnątrz panelu znajduje się wykres pierścieniowy, który pokazuje podział na sukcesy i błędy w wybranym okresie. Najedź kursor na dowolny wycinek, aby zobaczyć dokładną liczbę requestów i wartość procentową. Jest on rysowany tylko w tym zakresie, ponieważ obraz całego okna umieszczony nad tabelą odpowiadającą na inne pytanie wyglądałby jak dwa niepowiązane elementy.
Użycie, produkt Proxy
Pięć widoków:
| Widok | Grupuje dane według |
|---|---|
| Proxy user | Każdego użytkownika proxy, do którego masz dostęp |
| Target | Hosta, z którym połączył się dany tunel |
| Exit country | Kraju wyjściowego tunelu |
| Client IP | Adresu, z którego nadeszło połączenie |
| Outcome | Wyniku i jego przyczyny |
Cztery zakresy:
| Zakres | Kolumny |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels oraz po jednej kolumnie na wynik, z wykresem pierścieniowym wyników |
| Budget | Tunnels, Standard, Premium, Total |
Setup to czas oczekiwania przed przekazaniem tunelu. Duration to czas, przez jaki tunel pozostał otwarty. Premium to część ruchu, która przeszła przez sieć premium, wliczona w łączną sumę i nigdy do niej niedodawana.
Żaden zakres nie ma kolumny kredytów ani liczby requestów. To, co przesyła CONNECT, to Twój własny zaszyfrowany ruch, więc port zlicza tunele oraz bajty i nic więcej.
Typy wyników
Każdy request API jest klasyfikowany do dokładnie jednego wyniku. Rozliczany jest tylko success.
| Outcome | Layer | Znaczenie |
|---|---|---|
success |
nd. | Request zwrócił prawidłową odpowiedź. Bez reguł validate oznacza to HTTP 200. Z regułami validate jest to dowolna odpowiedź zaakceptowana przez Twoje reguły, niezależnie od statusu. Strona weryfikacyjna lub strona odmowy rozpoznana przez FourA nigdy nie jest sukcesem. |
application_error |
target | Cel zwrócił HTTP 200, ale treść zawierała pole błędu albo treść była stroną weryfikacyjną bądź stroną odmowy rozpoznaną przez FourA. |
application_fail |
target | Cel zwrócił kod spoza zakresu 2xx, którego Twoje reguły validate nie zaakceptowały, lub nie zwrócił żadnej odpowiedzi. |
client_error |
caller | Twój request został odrzucony, zanim opuścił FourA: nieprawidłowe parametry, zniekształcona wartość proxy lub URL rozwiązujący się do adresu prywatnego bądź zastrzeżonego. |
rate_limit |
FourA | Request został odrzucony przez Twój limit RPM lub limit współbieżności. Zobacz Rate Limits. |
service_error |
FourA | Silnik zwrócił błąd serwera lub treść, której nie udało się sparsować. |
service_fail |
FourA | Błąd sieci: timeout, odrzucenie połączenia, błąd DNS, rozłączenie klienta. |
Kolumna layer informuje, kto odpowiada za wynik. target oznacza wywołaną witrynę, caller oznacza błędny request, a FourA oznacza, że nie mogliśmy go przetworzyć.
Jeśli używasz validate.status.accept, aby zezwolić na określone kody inne niż 200 (na przykład [200, 403]), wracają one jako success zamiast application_fail. Klasyfikacja opiera się na ocenie Twoich reguł przez silnik, a nie na surowym kodzie HTTP.
Tunel przez port proxy jest klasyfikowany przy użyciu tego samego zestawu pojęć, z wyłączeniem dwóch wyników target: odpowiedź tunelu to Twój własny zaszyfrowany ruch, więc FourA nie widzi, czy witryna docelowa zwróciła poprawny wynik. Pełną taksonomię oraz sposób jej mapowania na rozliczenia znajdziesz w sekcji Request Outcomes.
Powiązane
- Dashboard Overview: Karty podsumowania, wykresy osi czasu, Period i Detail (Detail dostępny tylko w Overview)
- Request Outcomes: Szczegółowe wyjaśnienie wartości outcome dla requestów i tuneli
- Response Headers: Skąd pochodzą kredyty
- Proxy Port: Produkt, o którym raportują widoki Proxy
- Organizations: Co obejmuje filtr Owner
- API Errors: Jak błędy są zwracane przez sieć