Captura de tela das métricas do projeto


Acessando as Métricas

  1. No menu lateral, clique em Projetos
  2. Localize e clique no nome do projeto desejado
  3. Você será direcionado para a página de visualização do projeto

Nota: Logs e métricas detalhadas de CPU, memória, storage e requisições HTTP estão disponíveis apenas para projetos nos planos Premium ou superior.


Visão Geral do Projeto

Na página de visualização, você encontra:

Status do Projeto

StatusDescrição
ExecutandoProjeto ativo e acessível
ParadoProjeto pausado, não acessível
CriandoProjeto em processo de criação

Informações Principais

  • Nome e Descrição: Identificação do projeto
  • Tipo: HTTP
  • Instâncias: Réplicas ativas / Total configurado
  • Plano: Plano atual do projeto
  • Última Publicação: Data e hora da última atualização
  • Criado em: Data de criação do projeto

Armazenamento

Na seção de storage, você visualiza:

  • Capacidade: Total de armazenamento configurado (em GB)
  • Persistente: Indicação se o armazenamento é persistente (Sim/Não)
  • Path: Diretório configurado para persistência (quando aplicável)

Informações de Cobrança

Projetos com Pagamento por Hora

Exibe o valor utilizado até o momento. Este valor pode estar desatualizado.

Atenção: O valor exibido é uma estimativa e pode não refletir o valor final da fatura.

Projetos com Contrato (Mensal/Anual)

Exibe informações do contrato:

  • Modo de pagamento: Contrato de Mês ou Contrato de Ano
  • Data de término: Quando o contrato expira
  • Renovação automática: Se o contrato será renovado automaticamente

Ações do Projeto

Na página de visualização, você tem acesso às seguintes ações:

BotãoDescrição
EditarAcessa as configurações do projeto
IniciarInicia um projeto parado
PararPara o projeto em execução
DeletarExclui o projeto permanentemente

Logs do Projeto

Os logs permitem acompanhar o comportamento da aplicação por instância.

Como acessar

  1. Na página do projeto, clique em "Mostrar Logs"
  2. Os logs serão carregados automaticamente e atualizados em até 60 segundos

Limitações

  • Projetos no plano Basic não podem visualizar logs
  • O projeto deve estar em status "Executando"

Dicas

  • Use os logs para diagnosticar problemas
  • Identifique erros e exceptions
  • Diferencie versões e releases usando informações da sua aplicação, como ZENIFRA_INSTANCE_VERSION

Uso de Recursos (Planos Premium+)

Para projetos Premium ou superior, você pode monitorar:

CPU

  • Visualização do uso de CPU por instância
  • Comparação com o limite máximo permitido pelo plano
  • Atualização em até 5 minutos

Memória RAM

  • Visualização do uso de memória por instância
  • Comparação com o limite máximo permitido pelo plano
  • Formatação em MB ou GB automaticamente

Requisições HTTP

  • Visualização da quantidade de requisições que chegaram à aplicação
  • Apoio para investigar picos de tráfego e validar se o projeto recebeu chamadas depois do deploy
  • Uso em conjunto com logs para entender comportamento por janela de tempo

Visualização de Rede

A seção Tráfego de Rede mostra um resumo agregado do comportamento HTTP da aplicação. Ela ajuda a entender volume, rotas mais acessadas, respostas por classe de status e clientes que mais chamaram o projeto.

Você pode alternar entre as janelas de tempo:

PeríodoQuando usar
5 minValidar deploys recentes, smoke tests e tráfego imediato
1 hInvestigar picos curtos ou comportamento depois de uma mudança
6 hAcompanhar incidentes ou variações durante parte do dia
24 hRevisar o comportamento operacional do dia
7 diasIdentificar padrões recorrentes e rotas mais usadas na semana

Na visualização principal, você encontra:

  • Requisições: total de chamadas HTTP no período selecionado
  • Entrada: volume de dados recebidos pela aplicação
  • Saída: volume de dados enviados nas respostas
  • P95: latência no percentil 95 quando a informação está disponível
  • Status HTTP: distribuição entre respostas 2xx, 3xx, 4xx e 5xx
  • Top rotas: rotas mais acessadas, com método HTTP e quantidade de requisições
  • Principais clientes: user agents mais frequentes no período
  • Eventos de requisição: linhas individuais com IP de origem bruto, método, rota sanitizada, status, latência e user agent

Você também pode clicar em uma classe de status, como 4xx ou 5xx, para abrir um detalhamento com rotas, user agents e eventos de requisição associados àquele tipo de resposta. Use esse drill-down para encontrar rapidamente endpoints com erro, clientes que estão gerando falhas, IPs de origem envolvidos ou rotas com maior impacto.

Nota: As métricas de rede e eventos de requisição podem levar alguns minutos para aparecer. Eventos de requisição exibem IPs de origem brutos para usuários com acesso às métricas do projeto e ficam retidos por até 7 dias. A Zenifra não armazena query strings ou referrers nessa visualização.

Seleção de Instância

Quando o projeto possui múltiplas instâncias, você pode selecionar uma instância específica para visualizar logs e métricas.


Uso de Storage (Planos Premium+)

Para projetos Premium ou superior, a seção de storage exibe:

  • Barra de progresso: Porcentagem de armazenamento utilizado
  • Valor utilizado: Espaço consumido em bytes
  • Capacidade total: Limite de armazenamento do projeto

Próximos Passos


FAQ

Por que não consigo visualizar as métricas?

As métricas detalhadas estão disponíveis apenas para projetos nos planos Premium ou superior. Faça upgrade do seu plano para acessar essas funcionalidades.

Os logs não estão carregando. O que fazer?

Verifique se:

  • O projeto está em status "Executando"
  • Você possui um plano Premium ou superior
  • A aplicação está gerando logs corretamente

Posso exportar os logs?

No momento, a exportação de logs não está disponível. Você pode visualizar os logs diretamente no console.

Com que frequência as métricas são atualizadas?

As métricas são atualizadas em até 5 minutos. Os logs são atualizados em até 60 segundos.