Массовый импорт мониторов через CSV

4 мин чтения · Продвинутые мониторы

Если вы переходите с другого инструмента мониторинга сайтов или у вас 20 и более страниц, добавлять их вручную - пустая трата времени. Массовый импорт загружает за один раз файл CSV (таблица, сохранённая как текст) и создаёт из него десятки мониторов.

Подготовка файла CSV

CSV можно подготовить в Excel, Google Таблицах или в любом текстовом редакторе. Сохраните его в кодировке UTF-8 (поддержка диакритики). Первая строка содержит названия столбцов, остальные строки - отдельные мониторы.

name,type,target,interval_minutes,expected_status,expected_keyword
"Главная страница",http,https://www.mojakompanija.ru,5,200,"Добро пожаловать"
"API health",http,https://api.mojakompanija.ru/health,1,200,"\"status\":\"ok\""
"Сервер БД",tcp,db.mojakompanija.ru:5432,5,,
"Email MX",dns,mojakompanija.ru,30,,
"SSL-сертификат",ssl,www.mojakompanija.ru,1440,,

Столбцы

name - обязательный, макс. 120 символов. Название, которое вы увидите в обзоре.
type - обязательный. Один из: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - обязательный (кроме типа heartbeat). URL, имя хоста или host:port в зависимости от типа монитора.
interval_minutes - необязательный, по умолчанию 5. Минимум зависит от тарифа.
expected_status - необязательный, применяется только к монитору http. Ожидаемый код ответа (по умолчанию 200).
expected_keyword - необязательный. При типе http проверяет, есть ли строка в теле ответа; при типе dns проверяет, есть ли она в значении DNS-записи.

Для LAN-типов (lan_*) монитор привязывается к вашему существующему LAN-агенту, а в качестве цели вы указываете локальный IP или имя хоста (например 192.168.1.10).

Порядок импорта

Страница массового импорта мониторов из CSV — Страница импорта показывает образец формата и результат после загрузки файла.

В панели нажмите Импортировать CSV.
На странице импорта вы видите образец формата CSV - подготовьте по нему свои мониторы и сохраните файл как CSV (UTF-8).
Нажмите Выбрать файл, загрузите CSV и подтвердите кнопкой Импортировать.
По завершении отображается число созданных мониторов и возможные пропущенные строки с причиной (например, неизвестный тип или превышенный лимит тарифа).

Внимание на лимит тарифа: если импорт превысит число мониторов в вашем тарифе, он остановится на границе лимита, а оставшиеся строки будут отмечены как пропущенные. Текущее состояние (X / Y мониторов) вы видите в левом верхнем углу панели.

Частые ошибки в CSV

Неизвестный тип - опечатка в столбце type. Проверьте список допустимых значений.
Отсутствует target - кроме типа heartbeat, у каждого монитора должна быть цель.
Кавычки в ключевом слове - если expected_keyword содержит кавычки, их нужно записывать с обратной косой чертой (так называемое экранирование): "\"status\":\"ok\"".
Точка с запятой вместо запятой - в некоторых странах Excel сохраняет CSV с точкой с запятой. При сохранении выберите формат "CSV UTF-8 (разделители - запятые)".
Слишком большой файл - максимальный размер файла CSV - 2 МБ. Для обычного импорта десятков и сотен мониторов этого с лихвой хватает.

Совет: После импорта все мониторы запускают первую проверку в течение минуты. Достаточно подождать и следить за панелью.

Было ли это руководство полезным?