Configurando alertas de desempenho

O Zenovay oferece duas maneiras de ser notificado quando algo muda: regras de automação (para mudanças de tráfego, taxa de erro e taxa de conversão) e alertas de tempo de atividade (para quando um site fica inativo). Este guia aborda ambos.

Ambos os recursos estão disponíveis em Pro e acima. Espaços de trabalho gratuitos podem monitorar o tempo de atividade, mas não podem criar regras de automação.

Regras de automação

As regras de automação monitoram suas análises e acionam uma ação quando uma condição é atendida. Elas vivem nas configurações de cada site, não em uma área de alertas global.

Onde encontrá-las

Abra o painel da sua website
Vá para Configurações → Automação
Clique em Criar regra

Pro permite até 10 regras por site, e Scale permite até 50. Enterprise não tem limite de regras.

Tipos de acionadores

Acionador	Dispara quando
Pico de tráfego	As visitas aumentam bem acima da linha de base recente
Queda de tráfego	As visitas caem em uma porcentagem definida em relação à linha de base
Limite de taxa de erro	A taxa de erro ultrapassa o limite que você definiu
Taxa de conversão abaixo	A taxa de conversão de uma meta cai abaixo de um alvo
Taxa de rejeição acima	A taxa de rejeição sobe acima de um limite

Para regras de tráfego, você escolhe o período de linha de base (1, 7, 14 ou 30 dias) em relação ao qual o valor atual é comparado.

Ações

Quando uma regra é acionada, ela pode executar uma dessas ações:

Ação	O que faz
E-mail	Envia um alerta para um ou mais endereços de e-mail
Slack	Publica em um canal do Slack por meio de uma URL de webhook de entrada
Webhook	POSTs uma carga JSON para um endpoint HTTPS que você controla
Notificação push	Envia uma notificação push do navegador para dispositivos inscritos

Tempo de espera

Cada regra tem um tempo de espera (em minutos) para que uma única condição contínua não seja acionada repetidamente. O padrão é 60 minutos. Aumente-o para sinais ruidosos; diminua-o para aqueles que deseja saber rapidamente.

Alertas de tempo de atividade

O monitoramento de tempo de atividade executa verificações do lado do servidor contra seu site e o alerta quando fica inativo. Você não precisa do script de rastreamento para isso.

Configurar alertas de tempo de atividade

Abra o painel da sua website
Abra a guia Tempo de atividade
Abra a configuração do monitor

De lá você pode definir:

Intervalo de verificação — com que frequência o Zenovay verifica o site. O intervalo mais apertado depende do seu plano: 10 minutos em Free, 5 minutos em Pro e 1 minuto em Scale e Enterprise.
Limite de alerta — quantas verificações consecutivas com falha devem ocorrer antes que um alerta seja enviado. O padrão é 3, o que evita alertas em um único problema transitório.
Código de status esperado e uma palavra-chave opcional que a resposta deve conter.
Monitoramento SSL (planos pagos) para detectar problemas de certificado.

Os alertas de tempo de atividade podem ser entregues por e-mail, webhook, Slack ou Discord.

Cargas de Webhook

Quando uma regra de automação ou alerta de tempo de atividade usa uma ação de webhook, o Zenovay envia uma solicitação POST com um corpo JSON para a URL HTTPS que você fornece. Use-o para encaminhar alertas para suas próprias ferramentas.

A URL do webhook deve usar HTTPS.

Melhores práticas

Higiene de alertas

Evite fadiga de alerta. Muitos alertas são ignorados. Comece com algumas regras de alto sinal.
Defina limites significativos. Ajuste-os em relação à sua linha de base real para que não sejam acionados em variações normais.
Use o tempo de espera. É a forma mais simples de impedir que uma única condição o spam.
Revise regularmente. Ajuste os limites conforme seus padrões de tráfego mudam.

Diretrizes de limite

Estes são pontos de partida, não regras. Observe seus próprios dados por uma ou duas semanas e ajuste.

Sinal	Ponto de partida razoável
Taxa de erro	2x sua linha de base normal
Queda de tráfego	30% abaixo da linha de base
Tempo de atividade	Alerta após 3 verificações consecutivas com falha

Usando a API para verificações de implementação

Você também pode extrair análises para seu pipeline CI/CD para detectar regressões após uma implementação. Isso usa a API externa, disponível em Pro e acima.

# GitHub Actions example - check analytics after deploy
- name: Verify Post-Deploy Analytics
  run: |
    curl -X GET "https://api.zenovay.com/api/external/v1/analytics/${{ vars.ZENOVAY_WEBSITE_ID }}" \
      -H "X-API-Key: ${{ secrets.ZENOVAY_API_KEY }}"

Gere uma chave de API no seu espaço de trabalho em Configurações → Segurança → Chaves de API. Para alertas automatizados que não exigem pesquisa, configure uma regra de automação (acima) com uma ação de webhook para que o Zenovay notifique sua equipe quando um limite for ultrapassado.

Solução de problemas

Não recebe alertas

Verifique:

A regra ou monitor está habilitado.
Para ações de e-mail, o endereço do destinatário está correto e a mensagem não está na caixa de spam.
Para Slack, a URL do webhook de entrada é válida e o canal ainda existe.
Para webhooks, seu endpoint é acessível por HTTPS e retorna uma resposta 2xx.

Muitos alertas

Ajuste:

Aumente o limite para que seja acionado com menos frequência.
Aumente o tempo de espera da regra.
Use um período de linha de base mais longo para regras de tráfego para suavizar variações normais.

Falsos positivos

Revise:

Se o limite corresponde aos seus padrões de tráfego reais.
O período de linha de base que a regra de tráfego compara.
Se uma mudança recente (uma campanha, uma implementação, uma janela de manutenção conhecida) explica o sinal.