Przegląd panelu
Panel FourA Dashboard służy do zarządzania kluczami API i użytkownikami proxy, wykonywania testowych requestów, monitorowania wydajności, obsługi rozliczeń oraz konfiguracji konta. Ta strona omawia główny ekran Overview i sekcje paska bocznego.
Dostęp do Dashboardu
Zaloguj się na foura.ai/dashboard. Wymagane jest konto FourA: zarejestruj się tutaj, jeśli jeszcze go nie masz.
Dwa produkty, jeden zestaw stron
Zakładki Overview, Metrics i Activity otwierają się z przełącznikiem Product, który oferuje dwie opcje:
| Product | Co zlicza | Jednostka |
|---|---|---|
| API | Requesty wysyłane do /api/single, /api/proxy, /api/browser i /api/auto |
Requesty i kredyty |
| Proxy | Tunele otwierane przez Twoje narzędzia przez proxy.foura.ai |
Tunele i bajty |
Tunel przesyła wszystko, co wyśle przez niego Twój klient, a to, co dzieje się wewnątrz CONNECT, to Twój własny zaszyfrowany ruch. Dlatego widoki Proxy zliczają tunele oraz bajty, a nigdy requesty czy kredyty. Więcej informacji o samym produkcie znajdziesz w dokumentacji Proxy Port.
Przełącznik jest zawsze ustawiony na jeden z dwóch produktów, jego stan jest zapamiętywany między wizytami i znajduje się w adresie URL jako #overview/proxy, #metrics/proxy lub #activity/proxy. Wklejenie takiego linku otwiera stronę na wybranym produkcie.
Nie należy mylić produktu Proxy ze znacznikiem endpointu Proxy Finder. Proxy Finder to POST /api/proxy/, jeden z czterech endpointów API. Produkt Proxy to port proxy.
Strona Overview, produkt API
Strona docelowa po zalogowaniu wyświetla najważniejsze statystyki dla wybranego okresu.
Przed pierwszym requestem
Dopóki nie nadejdzie pierwszy request, widok API prezentuje dane przykładowe z oznaczeniem Sample na każdym panelu i wykresie, pod banerem This is sample data. zawierającym dwa kroki: Create API key, gdzie nowy klucz otwiera się wraz z poleceniem testowym, oraz Open Playground do wysłania requestu. Na telefonie lub tablecie instrukcja kieruje bezpośrednio do Playground, ponieważ na telefonie nie można uruchomić polecenia. Twój pierwszy rzeczywisty request na stałe zastąpi dane przykładowe.
Widok Proxy posiada własny baner No traffic yet. z opcjami Create proxy user i Open Proxy, wyświetlany do momentu, gdy któryś z Twoich użytkowników proxy wygeneruje ruch. Zamknięcie dowolnego z tych banerów ukrywa oba.
Karty podsumowania
Pięć paneli w górnej części ekranu oraz szósty, jeśli w danym okresie uruchomiono tryb Auto:
| Panel | Co pokazuje |
|---|---|
| Współbieżność | Żądania wykonywane równolegle w tej chwili, a także średnia i maksimum dla danego okresu |
| Żądania | Łączna liczba wywołań, a następnie Single, Proxy, Browser i Auto, każde z procentowym udziałem w sumie poniżej. Wywołanie Auto liczy się raz, w sekcji Auto. |
| Próby Auto | Wyświetlane tylko wtedy, gdy Auto wykonało operacje w danym okresie. Żądania Single, Proxy i Browser wykonane przez Auto w tle Twoich wywołań Auto, wraz z liczbą prób na wywołanie Auto. Nigdy nie liczą się jako żądania ani nie wpływają na wskaźnik sukcesu, a ich kredyty są wliczone w kredyty Auto. Wliczają się one do limitów rate limit i współbieżności dla Single, Proxy i Browser. |
| Kredyty | Rozliczone kredyty jako wartość główna, zużyte kredyty poniżej, łącznie oraz dla każdego produktu, w tym Auto |
| Bajty | Przesłane dane: Wejście to dane wysłane, Wyjście to dane odebrane, a Premium to część tego ruchu, która przeszła przez węzeł wyjściowy premium, niezależnie od tego, czy zwrócił on stronę. Wartość Premium mieści się w obu sumach i nigdy nie jest do nich dodawana. |
| Czas odpowiedzi | Średnia, minimum i maksimum w danym okresie |
Wartości rozliczone i zużyte to różne liczby. Rozliczane jest tylko udane żądanie, więc wartość rozliczona to koszt, który ponosisz. Zużyte obejmuje każdy wynik, ponieważ nieudane żądanie nadal zużywa zasoby proxy lub przeglądarki. Mylenie tych dwóch pojęć sprawia, że to samo konto wygląda inaczej na różnych stronach. Zobacz Wyniki żądań, aby sprawdzić, które wyniki są rozliczane.
Panele Żądania i Kredyty oznaczają cztery endpointy jako Single, Proxy, Browser i Auto. Pasek filtra Endpointy nad nimi nazywa Proxy jako Proxy Finder, co oznacza dokładnie to samo: POST /api/proxy/.
Suma tych czterech wartości nie zawsze daje wartość całkowitą. Niewielka liczba wywołań nie przypisuje się do żadnego z nich; są one wliczane do sumy, ale nie do konkretnego endpointu.
Wykresy osi czasu
Poniżej paneli sześć wykresów osi czasu przedstawia wolumen żądań, zużycie kredytów, podział wyników, czas odpowiedzi, przepustowość i współbieżność. Każdy wykres zawiera w nagłówku przełącznik, który zamienia wykres na tabelę źródłową.
Strona Przegląd, produkt Proxy
Przełącz Produkt na Proxy, a strona przedstawi dane w tunelach. Cztery panele:
| Panel | Co pokazuje |
|---|---|
| Tunele jednocześnie | Tunele otwarte w tym samym momencie. Bieżące obejmuje ostatnie kilka sekund i odświeża się co pięć; Średnia i Maks. obejmują cały okres. Twój plan ogranicza tę wartość łącznie dla wszystkich użytkowników proxy. |
| Tunele | Udane i Nieudane, każde z udziałem w sumie. Nieudane to każdy inny wynik, a wiersz Wynik wskazuje konkretny typ. |
| Ruch | Wejście to dane wysłane przez Twoje narzędzia, Wyjście to dane odebrane, a Premium to część przesłana przez sieć premium, wliczona w sumy, a nie do nich dodawana. |
| Czas konfiguracji | Średni, minimalny i maksymalny czas oczekiwania na przekazanie tunelu, liczony tylko dla udanych tuneli. Jest to czas oczekiwania przed pierwszym bajtem, a nie szybkość strony za tunelem. |
Poniżej znajduje się pięć wykresów osi czasu: Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline oraz Tunnels at Once Timeline. Każdy z nich ma ten sam przełącznik widoku wykresu lub tabeli, co wykresy API.
Trzy panele są wyszarzone, gdy aktywny jest filtr Outcome, ponieważ ta wartość nie istnieje dla danego wyniku. Tunnels at Once jest wyszarzony przy dowolnym wybranym wyniku. Setup Time i Traffic są wyszarzone przy wyniku błędu i mają plakietkę Success only, ponieważ nieudany tunel nigdy nie został przekazany i nie przesłał żadnych danych.
Period i Detail
Period określa zakres czasu wstecz. Osiem opcji plus Custom:
| Przycisk | Zakres |
|---|---|
| 30M | Ostatnie 30 minut |
| 3H | Ostatnie 3 godziny |
| 12H | Ostatnie 12 godzin |
| 24H | Ostatnie 24 godziny |
| 7D | Ostatnie 7 dni |
| 30D | Ostatnie 30 dni |
| 90D | Ostatnie 90 dni |
| 1Y | Ostatnie 12 miesięcy |
Custom otwiera okno dialogowe z czterema presetami: This month, Last month, Last 6 months i All time, a także parą dat Od i Do. Zakres dat obejmuje czas do końca wybranego dnia, nigdy poza bieżący moment.
Detail określa szerokość każdego słupka: co minutę, co 5 minut, co 30 minut, co godzinę, co 6 godzin, dziennie, tygodniowo lub miesięcznie. Domyślną wartością jest Auto, która wybiera najmniej szczegółowy krok dający co najmniej piętnaście słupków na wykresie, dzięki czemu cały rok jest czytelnym wykresem, a nie 365 cienkimi liniami. Opcja Auto wyświetla nazwę wybranego kroku.
Period i Detail dotyczą obu produktów.
Kroki Detail sięgające dalej wstecz, niż FourA przechowuje daną rozdzielczość, są wyszarzone, a nie ukryte:
| Rozdzielczość | Dostępny zakres wstecz |
|---|---|
| Na request | 7 dni |
| 5-minutowa | 30 dni |
| Godzinowa | 12 miesięcy |
| Dziennie | Cała historia |
Wybranie okresu dłuższego, niż pozwala dany poziom, powoduje wyszarzenie bardziej szczegółowych opcji. Tryb Auto nigdy nie wybiera żadnej z nich, więc wykres nigdy nie jest pusty z powodu agregacji danych.
Filtry
Filtry można łączyć ze sobą, a opcje Period i Detail działają równolegle z nimi.
| Filtr | Produkt | Działanie |
|---|---|---|
| Product | oba | API lub Proxy |
| Endpoints | API | Ograniczenie do jednego endpointu: Single, Proxy Finder, Browser lub Auto. Wywołanie Auto liczy się raz, w sekcji Auto; żądania Single, Proxy i Browser wykonane pod spodem w ramach fallbacku są pokazywane z nazwy w panelu prób Auto, nigdy jako osobne requesty. |
| Outcome | oba | Wyodrębnienie jednej kategorii. API oferuje wszystkie siedem; produkt Proxy oferuje pięć możliwych stanów zakończenia tunelu. |
| Owner | oba | Everything, Personal lub jedna z Twoich organizacji. Widoczne tylko wtedy, gdy należysz do przynajmniej jednej. |
| Key | API | Ograniczenie do pojedynczego klucza API |
| Proxy user | Proxy | Ograniczenie do pojedynczego użytkownika proxy |
Panel i wykres Concurrency po stronie API nie obsługują filtrów Endpoints ani Outcome. Oba elementy są wyszarzone, gdy którykolwiek z tych filtrów jest aktywny, o czym wykres informuje w nagłówku.
Filtr Owner
Menu rozwijane Właściciel odpowiada na pytanie „czyj ruch przeglądam”. Oferuje opcje Wszystko, Osobiste oraz po jednej pozycji dla każdej organizacji, do której należysz. Ten sam filtr w sekcjach Metryki, Aktywność, Klucze API oraz Proxy podąża za Twoim wyborem, dzięki czemu dane na stronach są zawsze spójne.
Sekcje Użycie i limity oraz Rozliczenia celowo go nie używają. Odpowiadają one na pytanie „co jest rozliczane na moje konto”, co w Twoim przypadku oznacza Twoje osobiste klucze i użytkowników proxy oraz zasoby organizacji, których jesteś właścicielem. Zobacz Organizacje.
Sekcje paska bocznego
Jedenaście sekcji w czterech grupach: Panel główny, Narzędzia, Dostęp i Konto.
Panel główny: Przegląd, Metryki, Aktywność
Trzy strony, które odpowiadają na pytanie „co się wydarzyło”. Wszystkie trzy zawierają przełącznik Produktu.
Przegląd to strona opisana powyżej, będąca zawsze punktem startowym po zalogowaniu.
Metryki zawierają panel Użycie: zestawienie pogrupowane według klucza API, adresu IP klienta lub domeny po stronie API oraz według użytkownika proxy, celu, kraju wyjściowego, adresu IP klienta lub wyniku po stronie Proxy, z kartami podsumowującymi cały okres nad tabelą z podziałem na strony. Zobacz przewodnik po Metrykach.
Aktywność to transmisja na żywo z ostatniej godziny. Po stronie API każdy wiersz oznacza jedno żądanie: metodę, domenę docelową, status, wynik, czas trwania, rozmiar transferu oraz kredyty. Po stronie Proxy każdy wiersz to jeden tunel: użytkownik proxy, cel, punkt wyjściowy, wynik, konfiguracja, czas trwania, bajty i adres IP klienta. Zobacz Dziennik aktywności.
Narzędzia: Playground, Rozszerzenie
Testuj żądania na żywo przy użyciu rzeczywistego klucza API bez pisania kodu. Wybierz Auto, Pojedyncze, Proxy lub Przeglądarka, ustaw adres URL, dostosuj flagi i limity czasu, a następnie kliknij Wyślij. Zapisuj popularne konfiguracje jako szablony i odtwarzaj dowolne z ostatnich 20 uruchomień z Historii.
Użycie wlicza się do limitu klucza, dokładnie tak samo jak wywołanie produkcyjne. Zobacz przewodnik po Playground.
Rozszerzenie, oznaczone jako Beta, pozwala pobrać rozszerzenie FourA dla przeglądarki Chrome. Jego okno pop-up kieruje ruch Chrome przez jednego z Twoich użytkowników proxy, a karta FourA w DevTools przekształca dowolne żądanie wygenerowane przez stronę w gotowe wywołanie API. Zobacz Rozszerzenie Chrome.
Dostęp: Klucze API, Proxy
Klucze API to miejsce, w którym tworzysz, przeglądasz i zarządzasz kluczami używanymi przez Twoje aplikacje do wywoływania API. Klucze używają prefiksu pk_live_. Zobacz Zarządzanie kluczami API.
Proxy to miejsce, w którym tworzysz użytkowników proxy i kopiujesz ciąg połączenia dla dowolnego klienta obsługującego adres URL proxy. Tunele i ruch przez port wliczają się do Twojego planu, tak samo jak API. Zobacz sekcję Użytkownicy Proxy oraz dokumentację Port Proxy.
Konto: Organizacje, Użycie i limity, Rozliczenia, Ustawienia
Organizacje pozwalają współdzielić klucze API i użytkowników proxy ze współpracownikami w ramach jednego właściciela. Dodawaj użytkowników za pomocą adresu e-mail, przypisuj im role i przekazuj organizację, gdy zajdzie potrzeba zmiany właściciela. Użycie danych uwierzytelniających organizacji wlicza się do planu jej właściciela. Zobacz Organizacje.
Usage & Limits pokazuje Twój plan, zużycie w bieżącym okresie rozliczeniowym oraz wszystkie obowiązujące limity, ze szczegółowym podziałem na klucze, endpointy i użytkowników proxy. Zobacz Usage & Limits.
Billing zarządza subskrypcją, zakupem dodatkowych kredytów lub transferu, metodami płatności i fakturami, a także przedstawia zużycie kredytów, transferu oraz transferu premium w odniesieniu do Twojego planu. Zobacz Billing & Subscriptions.
Settings zawiera Twoją nazwę wyświetlaną, hasło, aktywne sesje oraz połączonych dostawców logowania. Zmiana adresu e-mail nie jest dostępna w panelu: skontaktuj się z pomocą techniczną.
Wskazówki
- Skorzystaj z Playground przed pisaniem kodu. Jeśli nie wiesz, jakiego silnika wymaga nowa strona, zacznij od opcji Auto i pozwól mu dokonać wyboru.
- Porównaj wartości naliczone ze zużytymi na karcie Credits. Endpoint, w którym te wartości mocno się różnią, często zwraca błędy, a attempt report wyjaśnia przyczynę.
- W usłudze Proxy blok ze statusem Rate Limited na osi czasu Outcome Timeline wynika z limitu Twojego planu, a nie z odmowy serwera docelowego. Widok Outcome w sekcji Metrics wskazuje, o który limit chodzi.
- Dbaj o bezpieczeństwo kluczy API i użytkowników proxy. Natychmiast wyłącz dany element, jeśli podejrzewasz jego ujawnienie.
Kolejne kroki
- Authentication: Szczegóły tworzenia i zarządzania kluczami API
- Quick Start: Wykonaj pierwsze zapytanie z poziomu CLI
- How Your Plan Is Metered: Kredyty, transfer i obowiązujące limity
- Usage & Limits: Śledź zużycie kredytów i transferu w ramach planu
- API Endpoints: Korzystaj bezpośrednio z API