Importação em massa via CSV

4 min de leitura · Monitores avançados

Se está a migrar de outra ferramenta de monitorização de sites ou tem 20 ou mais páginas, adicioná-las manualmente é uma perda de tempo. A importação em massa carrega de uma só vez um ficheiro CSV (uma tabela guardada como texto) e cria a partir dele dezenas de monitores.

Preparar o ficheiro CSV

Pode preparar o CSV no Excel, no Google Sheets ou em qualquer editor de texto. Guarde-o na codificação UTF-8 (suporte de caracteres acentuados). A primeira linha contém os nomes das colunas, as linhas seguintes os monitores individuais.

name,type,target,interval_minutes,expected_status,expected_keyword
"Página principal",http,https://www.minhaempresa.pt,5,200,"Bem-vindo"
"API health",http,https://api.minhaempresa.pt/health,1,200,"\"status\":\"ok\""
"Servidor DB",tcp,db.minhaempresa.pt:5432,5,,
"Email MX",dns,minhaempresa.pt,30,,
"Certificado SSL",ssl,www.minhaempresa.pt,1440,,

Colunas

name - obrigatório, máx. 120 caracteres. O nome que verá na visão geral.
type - obrigatório. Um de: http, ssl, tcp, dns, domain, heartbeat, ping, visual, lan_ping, lan_tcp, lan_http.
target - obrigatório (exceto para o tipo heartbeat). URL, nome de anfitrião ou host:port consoante o tipo de monitor.
interval_minutes - opcional, 5 por predefinição. O mínimo depende do seu plano.
expected_status - opcional, aplica-se apenas ao monitor http. O código de resposta esperado (200 por predefinição).
expected_keyword - opcional. No tipo http verifica se a cadeia de caracteres se encontra no corpo da resposta; no tipo dns verifica se se encontra no valor do registo DNS.

Para os tipos LAN (lan_*), o monitor é atribuído ao seu agente LAN existente e como destino introduz o IP local ou o nome de anfitrião (por exemplo 192.168.1.10).

Procedimento de importação

Página de importação em massa de monitores por CSV — A página de importação mostra o formato de exemplo e o resultado após o carregamento do ficheiro.

No painel, clique em Importar CSV.
Na página de importação vê o formato de exemplo do CSV - prepare os seus monitores em conformidade e guarde o ficheiro como CSV (UTF-8).
Clique em Escolher ficheiro, carregue o CSV e confirme com o botão Importar.
No final é apresentado o número de monitores criados e as eventuais linhas ignoradas com o motivo (por exemplo, tipo desconhecido ou limite do plano excedido).

Atenção ao limite do plano: se a importação ultrapassasse o número de monitores do seu plano, para no limite e as linhas restantes são marcadas como ignoradas. O estado atual (X / Y monitores) vê no canto superior esquerdo do painel.

Erros frequentes no CSV

Tipo desconhecido - um erro de escrita na coluna type. Verifique a lista de valores permitidos.
Destino em falta - exceto o tipo heartbeat, cada monitor tem de ter um destino.
Aspas na palavra-chave - se expected_keyword contiver aspas, é preciso escrevê-las com uma barra invertida (o chamado escaping): "\"status\":\"ok\"".
Ponto e vírgula em vez de vírgula - em alguns países o Excel guarda o CSV com ponto e vírgula. Ao guardar, escolha o formato "CSV UTF-8 (delimitado por vírgulas)".
Ficheiro demasiado grande - o tamanho máximo do ficheiro CSV é 2 MB. Para uma importação habitual de dezenas a centenas de monitores é mais do que suficiente.

Dica: Após a importação, todos os monitores executam a primeira verificação no prazo de um minuto. Basta esperar e acompanhar o painel.

Este guia foi útil?