Bulk import monitorów przez CSV

4 min czytania · Zaawansowane monitory

Jeśli przechodzisz z innego narzędzia do monitorowania stron lub masz 20 i więcej witryn, ręczne dodawanie to strata czasu. Import zbiorczy wgrywa naraz plik CSV (tabela zapisana jako tekst) i tworzy z niego dziesiątki monitorów.

Przygotowanie pliku CSV

Plik CSV przygotujesz w Excelu, Arkuszach Google lub w dowolnym edytorze tekstu. Zapisz go w kodowaniu UTF-8 (obsługa znaków diakrytycznych). Pierwszy wiersz zawiera nazwy kolumn, kolejne wiersze poszczególne monitory.

name,type,target,interval_minutes,expected_status,expected_keyword
"Strona główna",http,https://www.mojafirma.pl,5,200,"Witamy"
"API health",http,https://api.mojafirma.pl/health,1,200,"\"status\":\"ok\""
"Serwer DB",tcp,db.mojafirma.pl:5432,5,,
"Email MX",dns,mojafirma.pl,30,,
"Certyfikat SSL",ssl,www.mojafirma.pl,1440,,

Kolumny

name - wymagana, maks. 120 znaków. Nazwa, którą zobaczysz w przeglądzie.
type - wymagana. Jedna z: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - wymagana (poza typem heartbeat). URL, nazwa hosta lub host:port w zależności od typu monitora.
interval_minutes - opcjonalna, domyślnie 5. Minimum zależy od planu.
expected_status - opcjonalna, stosowana tylko przy monitorze http. Oczekiwany kod odpowiedzi (domyślnie 200).
expected_keyword - opcjonalna. Przy typie http sprawdza, czy ciąg znaków znajduje się w treści odpowiedzi; przy typie dns sprawdza, czy znajduje się w wartości rekordu DNS.

Dla typów LAN (lan_*) monitor zostaje przypisany do istniejącego agenta LAN, a jako cel podajesz lokalny adres IP lub nazwę hosta (na przykład 192.168.1.10).

Procedura importu

Strona zbiorczego importu monitorów z CSV — Strona importu pokazuje przykładowy format oraz wynik po wgraniu pliku.

W panelu kliknij Importuj CSV.
Na stronie importu widzisz przykładowy format CSV - przygotuj według niego swoje monitory i zapisz plik jako CSV (UTF-8).
Kliknij Wybierz plik, wgraj CSV i potwierdź przyciskiem Importuj.
Po zakończeniu wyświetli się liczba utworzonych monitorów oraz ewentualne pominięte wiersze z powodem (na przykład nieznany typ lub przekroczony limit planu).

Uwaga na limit planu: jeśli import przekroczyłby liczbę monitorów w Twoim planie, zatrzyma się na granicy limitu, a pozostałe wiersze zostaną oznaczone jako pominięte. Bieżący stan (X / Y monitorów) widzisz w lewym górnym rogu panelu.

Częste błędy w CSV

Nieznany typ - literówka w kolumnie type. Sprawdź listę dozwolonych wartości.
Brakujący target - poza typem heartbeat każdy monitor musi mieć cel.
Cudzysłowy w słowie kluczowym - jeśli expected_keyword zawiera cudzysłowy, trzeba je zapisać z ukośnikiem wstecznym (tak zwane escapowanie): "\"status\":\"ok\"".
Średnik zamiast przecinka - Excel w niektórych krajach zapisuje CSV ze średnikiem. Przy zapisie wybierz format "CSV UTF-8 (rozdzielany przecinkami)".
Zbyt duży plik - maksymalny rozmiar pliku CSV to 2 MB. Na typowy import dziesiątek do setek monitorów to z naddatkiem wystarcza.

Wskazówka: Po imporcie wszystkie monitory uruchamiają pierwsze sprawdzenie w ciągu minuty. Wystarczy poczekać i obserwować panel.

Czy ten poradnik był pomocny?