Recursos

O painel

Esta página explica o que cada número significa e como filtrar, comparar, compartilhar e acompanhar tudo ao vivo.

O painel fica em /runlight no seu próprio site. A página única dele começa com uma frase principal e seis cartões de métricas sobre um gráfico, com um conjunto de quadros abaixo.

Os seis números

Métrica	O que conta
Visitantes	Pessoas diferentes, cada uma contada uma vez por dia (veja Privacidade para saber como uma pessoa é diferenciada sem ser identificada).
Visitas	Sessões, cada uma terminando após 30 minutos sem nada acontecer.
Visualizações	Páginas carregadas, incluindo as trocas de página em single page apps.
Páginas por visita	Visualizações divididas por visitas.
Taxa de rejeição	Visitas com uma visualização, nenhum evento e menos de 10 segundos de tempo de engajamento, como parcela de todas as visitas.
Duração da visita	O tempo médio de engajamento por visita, contando só o tempo em que a aba estava visível e em foco.

Clique num cartão para colocá-lo no gráfico; vários podem dividir o gráfico, cada um na escala do próprio pico, para que os formatos possam ser comparados. Passe o cursor sobre o gráfico para ver os números exatos.

Os quadros

Páginas mostra as páginas principais com o tempo na página, as páginas de entrada com a taxa de rejeição e as páginas de saída. O tempo na página é a média de todas as visualizações da página, e uma visualização de menos de um segundo não conta.
Origens divide o tráfego por canal (Busca orgânica, Redes sociais, Direto, IA, E-mail, Referências, Campanha, Busca paga), por origem nomeada e por host de referência.
Localizações mostra países, regiões e cidades, como lista ou como mapa.
Quando as pessoas visitam mostra as visitas por dia da semana e hora, no fuso horário do site.
Agentes de IA lista os agentes de IA que leram suas páginas e quais páginas cada um leu. Veja Origens e agentes de IA.
Dispositivos divide as visitas por tipo de dispositivo, navegador, sistema operacional, tamanho de tela e idioma.
Eventos mostra seus próprios eventos e os automáticos. O botão de lista em cada linha abre as propriedades, como o endereço de cada link externo e download ou o caminho de cada 404, com a frequência de cada um.
Campanhas mostra suas tags UTM por origem, mídia, campanha, termo e conteúdo.
Conversões mostra suas metas.
Links mostra seus links curtos.

Ver tudo abre a lista completa, com todas as colunas e uma caixa de busca.

Filtros

Clique em qualquer linha para filtrar o painel inteiro por ela. O botão Filtrar filtra por página, página de entrada ou de saída, origem, canal, referência, cada tag UTM, país, região, cidade, navegador, sistema operacional, dispositivo, tela, idioma, nome do host e evento. Cada filtro usa é, não é ou contém, e os filtros se combinam.

Um filtro escolhe visitas, e os números então descrevem essas visitas inteiras, contadas no período em que cada uma começou. Filtrar pelo evento Signup mostra as pessoas que se cadastraram, com todas as páginas, o tempo e a taxa de rejeição delas, e não é escolhe as visitas que nunca tiveram esse evento. Um filtro de página conta as visualizações dessa página como visualizações, então "página é /pricing" mostra quantas vezes /pricing foi vista. Com dois filtros de página, contam as visualizações de qualquer uma das páginas, e um filtro de nome do host ao lado deles mantém só as visualizações nesse host. Conversões, funis e propriedades de eventos contam as mesmas visitas, então uma visita que começa antes da meia-noite e converte depois conta no dia em que começou. Contém ignora maiúsculas e minúsculas, e até seis filtros valem ao mesmo tempo.

Datas e comparação

Escolha um período no calendário ou numa opção pronta (Últimos 30 dias é o padrão). Compare-o com o período anterior, com os mesmos dias do ano passado ou com quaisquer datas que você escolher; os cartões mostram a mudança e o gráfico desenha a comparação tracejada. Todo o período não tem nada antes dele, então desliga a comparação.

Redefinir volta tudo para Últimos 30 dias, sem filtros nem comparação, e o botão voltar do navegador desfaz isso. Cada visão fica na URL, então você pode salvá-la nos favoritos ou enviá-la.

Agora mesmo

Clique em agora, abaixo do nome do site, para ver o que está acontecendo no site. A visão mostra as visualizações de cada um dos últimos 30 minutos e uma lista do que aconteceu neles, como "Alguém em Toronto, Canadá viu /pricing vindo de Google". A contagem de pessoas, e as páginas, origens e países ao lado dela, cobrem os últimos cinco minutos. Ela se atualiza a cada 10 segundos e nunca mostra quem é ninguém.

Configurações, Compartilhar cria um link só de leitura para o painel de um site, para um cliente ou para sua equipe. Quem tem o link vê os relatórios e as conversões, e o link esconde seus links curtos, suas configurações e o endereço do site. Apague o link e ele para de funcionar na hora. Um painel compartilhado usa a mesma página, servida em /runlight/share/<id> (ou /share/<id> no servidor independente), e o id tem 128 bits aleatórios.

Exportação

Exportar, no rodapé, baixa tudo o que o painel mostra para as datas e filtros atuais como um ZIP de arquivos CSV. Ele traz os seis números, os números de cada dia, cada detalhamento com até 1.000 linhas e as suas metas. As datas são as do próprio site, as taxas são porcentagens e os tempos estão em segundos, então uma planilha os lê como estão. Cada lista completa também tem Baixar CSV para aquela tabela. Um link de compartilhamento pode exportar o próprio site, e os mesmos arquivos vêm da API em /api/export e de /api/breakdown com format=csv.

Importar o histórico do Umami

Em Configurações, Importar, Visitas, entre no seu Umami com uma chave de API (ou com usuário e senha num Umami auto-hospedado padrão) e escolha o site do Umami que corresponde a este site. O Runlight lê as visualizações e os eventos personalizados dele poucos dias por vez, dos mais antigos para os mais recentes, e os grava como visitas com as origens, campanhas, locais e dispositivos. Um intervalo de trinta minutos inicia uma nova visita, como acontece com as visitas ao vivo.

A importação para onde começam as visitas do próprio Runlight, então nenhum dia é contado duas vezes. Se você a interromper ou fechar a página, rodá-la de novo continua a partir do último dia concluído. O Umami não registra tempo de engajamento, então a duração de uma visita importada vai da primeira visualização até a última. Sua chave ou senha só é usada enquanto a importação roda e nunca é salva.

Importar o histórico de um arquivo CSV

Em Configurações, Importar, Visitas, escolha Um arquivo CSV e selecione o arquivo. O Runlight aceita dois tipos de arquivo e os distingue pela linha de cabeçalho. O primeiro é o CSV da exportação de dados do Umami, com uma linha para cada visualização ou evento, que serve para um Umami que você não consegue mais acessar. O segundo é o formato de visitas do próprio Runlight, para histórico de qualquer outro lugar, desde que tenha uma linha para cada visualização. Um script ou um assistente de IA consegue transformar a maioria dos logs brutos nesse formato.

Coluna	O que contém
`time`	Quando aconteceu, em ISO 8601 (`2024-05-01T12:34:56Z`), `2024-05-01 12:34:56` em UTC ou um Unix time em segundos ou milissegundos. Obrigatória.
`url` ou `path`	O endereço completo, ou o caminho com a query string. Obrigatória.
`hostname`	O host, quando `path` é usado. O padrão é o primeiro domínio do site.
`visitor`	Qualquer id que continue o mesmo para uma pessoa, como um id de sessão. Linhas com o mesmo visitante a menos de trinta minutos uma da outra formam uma visita. Sem ele, cada linha é uma visita própria.
`event`	O nome de um evento personalizado. Uma linha com ele é um evento naquela página, e uma linha sem ele é uma visualização.
`referrer`	De onde a visita veio, como endereço ou domínio.
`title`	O título da página.
`country`, `region`, `city`	Um código de país de duas letras, um código de região como `CA-ON` e o nome de uma cidade.
`browser`, `os`, `device`	Nomes como `Chrome`, `macOS` e `mobile`, `tablet` ou `desktop`.
`screen`, `language`	Como `1440x900` e `en-CA`.

csv

time,url,visitor,referrer,country,device
2024-05-01T12:34:56Z,https://example.com/?utm_source=newsletter,3f9a,news.ycombinator.com,CA,mobile
2024-05-01T12:36:10Z,https://example.com/pricing,3f9a,,CA,mobile

Como no Umami, só entram as linhas anteriores à primeira visita do próprio Runlight, e as campanhas são lidas dos parâmetros utm_ de cada endereço. O arquivo é lido no seu navegador e enviado 2.000 linhas por vez. Importar o mesmo arquivo de novo substitui as linhas que ele trouxe antes, então nada é contado duas vezes.

Jornadas

O botão de setas no quadro Páginas abre Jornadas, os caminhos que as visitas fazem pelo site, página a página. Cada coluna é um passo, com as páginas mais comuns e quantas visitas não seguiram adiante, e as linhas entre as colunas mostram para onde as visitas foram em seguida, mais grossas quando são mais. Uma página vista duas vezes seguidas, como acontece ao recarregar, conta uma vez. Escolha quantos passos mostrar, comece por uma página como a de preços ou termine numa como uma página de agradecimento. Clique em qualquer página para seguir só as visitas que passaram por ela naquele passo. A mesma resposta vem de /api/journeys e da ferramenta MCP get_journeys.

O Assistente de IA

O botão do robô ao lado de Filtrar abre um assistente a quem você pode perguntar sobre suas estatísticas com palavras simples, como de onde vieram os visitantes no mês passado ou quais páginas prendem a leitura das pessoas. Ele lê os números com as mesmas ferramentas só de leitura do servidor MCP, para o site e as datas na tela, a menos que você pergunte sobre outros, e nunca consegue mudar nada.

O proprietário ou um administrador o configura uma vez em Configurações, Assistente de IA. Escolha Anthropic, OpenAI, Google Gemini, OpenRouter, Ollama, LM Studio ou qualquer serviço com uma API compatível com OpenAI, depois um modelo e uma chave. O Ollama e o LM Studio rodam um modelo na sua própria máquina sem chave, desde que o servidor que roda o Runlight consiga alcançá-lo. A chave fica no servidor, criptografada com RUNLIGHT_SECRET (ou com o token quando não há segredo), e nunca é devolvida a um navegador.

Cada pergunta vai para o serviço que você escolheu, junto com os números que o assistente lê para responder. O Runlight não guarda nada sobre visitantes individuais, então nada pessoal é enviado. Todos que entraram no painel podem perguntar, mas tokens de API e links de compartilhamento não podem. Cada pergunta gasta o seu crédito de IA, então cada pessoa pode fazer trinta perguntas por hora, e cada leitor 50 por dia, número que o proprietário ou um administrador pode mudar em Assistente de IA ou definir como 0 para deixar os leitores sem o assistente. A conversa vive na aba do navegador e some quando a aba é fechada.

Retenção dos dados

Cada site guarda todas as visitas, a menos que você escolha outra coisa. Em Configurações, Dados, Manter visitas por oferece 6 meses ou 1, 2, 3 ou 5 anos. Salvar um tempo menor apaga de vez as visitas e os eventos mais antigos, e o painel diz a partir de qual data antes de você salvar. Depois disso, a verificação agendada apaga todo dia o que passar do limite. Metas, links e configurações continuam. A mesma seção tem Exportar tudo, um ZIP com todos os relatórios desde a primeira visita do site, que vale a pena baixar antes de encurtar o tempo.

Configurações

A engrenagem ao lado do nome do site abre as Configurações. Geral traz o nome e o fuso horário do site, junto com o idioma e o tema do painel, que cada navegador guarda para si. As outras seções são Instalação, Metas, Funis, Serviço de e-mail, Relatórios por email, Compartilhar, API e IA, Domínios personalizados, Importar, Dados e Assistente de IA, e o proprietário e os administradores também veem Pessoas quando as contas estão ativadas, como sempre estão no servidor independente. O seletor de tema também fica no rodapé, e Shift+Cmd+D (Shift+Ctrl+D) o alterna de qualquer lugar.