# Logs, métricas e alertas: sinais para perceber uma falha mais cedo

Monitoramento de aplicações e alertas: logs de build, logs de runtime, métricas e histórico. Ajudam a ver uma falha mais cedo. Não garantem.

Canonical URL: https://unbroker.cloud/pt/blog/logs-metrics-alerts
Published: 2026-11-08
Reviewed: 2026-11-08
Author: Timoteo Borgobello

## A resposta curta

Monitoramento de aplicações e alertas na Unbroker são quatro sinais: o log de build, o log de runtime, as métricas de recursos e o histórico de deployments. Alguns alertas sobre esses sinais ajudam a perceber uma falha mais cedo. Eles não garantem que você veja cada queda antes de um usuário.

Alertas da plataforma não são error tracking. Um check saudável não prova que cada request funcionou.

## Quatro sinais, quatro perguntas

| Sinal | Pergunta que responde |
| --- | --- |
| Log de build | Por que uma revisão de código construiu ou não |
| Log de runtime | O que a aplicação em execução está informando |
| Métricas | CPU, memória, restarts, instâncias unhealthy e readiness |
| Histórico de deployments | O que mudou, e qual revisão está live |

Ler o sinal errado esconde a causa. Um deploy que falhou está em [Depurar um deploy que falhou](https://unbroker.cloud/pt/blog/debug-failed-deployment). Qual push virou esse deploy está em [Deploy com git push](https://unbroker.cloud/pt/blog/deploy-on-git-push). A referência é [Logs, metrics, and monitoring](https://docs.unbroker.cloud/apps/monitoring).

## Logs de runtime que dá para buscar

A aba **Logs** é stdout e stderr. As linhas são coletadas mais ou menos a cada 30 segundos e ficam por 7 dias. A busca roda no servidor para o intervalo que você escolhe. Dá para filtrar por errors, warnings, info ou debug. **Download** salva as linhas que coincidem.

Uma linha ganha nível só com um marcador explícito: um campo JSON `level` ou `severity`, `level=warn`, `[ERROR]`, um `WARN:` no início, ou os formatos do nginx e do PostgreSQL. Uma linha sem marcador aparece sem nível. O produto não adivinha.

Se um serviço escreve mais de 5.000 linhas, ou 2 MiB, numa janela de 30 segundos, as linhas mais antigas dessa janela não são guardadas. A Unbroker acrescenta uma linha que diz quantas foram descartadas.

A saída de build é outro registro. Ela fica com aquele deployment. Um log de build muito grande guarda o começo e a saída mais recente. Saída com mais de 90 dias é removida, exceto a do deployment que o serviço está rodando agora.

Não cole um segredo num log que você compartilha. Deixe o valor numa variável. Como essas variáveis são agrupadas está em [Variáveis de ambiente e segredos](https://unbroker.cloud/pt/blog/environment-variables-and-secrets).

## Métricas: CPU, memória, restarts, readiness

A aba **Resources** mostra gráficos de CPU, memória, tráfego de rede e réplicas. Os intervalos fixos são 15 minutos, 1 hora, 6 horas, 24 horas, 7 dias e 30 dias. Uma janela personalizada fica dentro dos últimos 30 dias.

As amostras são coletadas a cada minuto. Os gráficos fazem a média em buckets. Amostras por minuto ficam por 7 dias. Médias horárias ficam por 90 dias, então um intervalo de mais de uma semana é horário. CPU e memória são somadas entre réplicas. A linha tracejada é o teto daquele momento: o limite por réplica vezes as réplicas que estão rodando. Uma linha fina nos gráficos de CPU e memória é o pico do bucket, sobre a média, então um pico curto continua visível.

Um buraco numa linha quer dizer que não houve amostra. Ele não é desenhado como zero. **Availability** é a parte das réplicas desejadas que estavam ready. **Restarts** são restarts de contêiner por bucket, e a série só aparece quando houve algum. O tráfego de rede aparece onde o cluster expõe contadores por réplica.

Métricas de recursos fazem parte do Pro. Como a quantidade de réplicas muda por CPU ou memória é outro controle, em [Autoscaling de réplicas](https://unbroker.cloud/pt/blog/replica-autoscaling).

## Exemplos de alertas, não um conjunto obrigatório

A página de monitoramento usa estes valores como exemplos. Não são uma recomendação universal.

| Métrica | Exemplo da documentação |
| --- | --- |
| CPU | Acima de `800` milicores em 5 minutos. `1000` milicores é 1 vCPU. A CPU é somada entre réplicas. |
| Memória | Acima de `1536` MiB em 10 minutos, na tabela. A página da CLI usa outro exemplo: acima de `768` MiB em 5 minutos. |
| Restarts | Acima de `3` em 5 minutos. |
| Unhealthy pods | Acima de `0` em 5 minutos. |
| Ready replicas | Abaixo de `100` por cento da quantidade desejada, em 5 minutos. |

Um check de uptime HTTPS pede uma URL pública e fica saudável com qualquer `2xx`. A URL precisa ser o endereço do serviço ou um domínio próprio ativo. O exemplo da CLI é `https://api.example.com/health`. Um domínio próprio está em [Domínio próprio e HTTPS](https://unbroker.cloud/pt/blog/custom-domain-https).

A janela de uma métrica vai de 1 a 1440 minutos. O padrão é 5. As regras são avaliadas a cada minuto. O estado é **Healthy**, **Alerting** ou **Unknown** quando ainda não há dados ou o check não pôde rodar. Criar e editar regras exige a permissão de settings da organização.

Alertas de métrica exigem Pro. A documentação de monitoramento não declara um requisito de plano para criar um check de uptime HTTPS. Este texto não acrescenta um.

## Para onde um alerta vai

Uma regra avisa quando começa a alertar e de novo quando se recupera. Todo alerta aparece no sino.

No Pro, o mesmo alerta também pode ir para os canais do projeto: e-mail para o owner da organização, e um webhook compatível com Slack. Isso acontece se **Health alerts** estiver ligado, em **Project settings → Deploy notifications**. Deploy notifications não estão no Free. No Pro são e-mail e um webhook do Slack.

Dois avisos não precisam de regra. Enquanto **Enable alerts** estiver ligado para a organização, a Unbroker avisa quando um serviço cai ou entra em crash-loop. Esses alertas inclusos usam o sino e, no Pro, os canais do projeto se **Health alerts** estiver ligado.

## O que estes alertas não cobrem

Eles não substituem a telemetria da aplicação nem o error tracking. A documentação de monitoramento diz isso direto. Um check de uptime que devolve 2xx não mostra uma query lenta, um checkout que falhou nem um stack trace dentro de uma resposta 200.

O Beacon não é este sistema de alertas. É pub/sub em tempo real com entrega at-most-once, e não é uma fila durável. A nota é [Beacon reliability](https://docs.unbroker.cloud/beacon/reliability). Um sintoma de banco que você encontra depois no Postgres está em [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production).

## Como isso funciona na Unbroker

Abra **Logs** para stdout e stderr. Abra **Resources** para os gráficos e o cartão **Alerts**. No cartão dá para pausar, retomar, rodar **Check now** ou apagar uma regra. **New alert** adiciona uma métrica de recurso ou um check de uptime.

Pelo terminal, os comandos documentados são:

```bash
ubctl monitoring ls
ubctl monitoring alert-create \
  --name high-memory \
  --service svc_123 \
  --metric memory \
  --compare above \
  --value 768 \
  --window 5
ubctl monitoring uptime-create --name public-api --url https://api.example.com/health
ubctl monitoring check mon_123
ubctl monitoring rm mon_123
```

`768` e o nome `high-memory` são o exemplo da página da CLI. Os nomes de métrica são `cpu`, `memory`, `restarts`, `unhealthy` e `ready_percent`. A referência de comandos é [Monitoring commands](https://docs.unbroker.cloud/cli/monitoring). As rotas HTTP são [a API de monitoramento](https://docs.unbroker.cloud/api/monitoring). Outros comandos do `ubctl` estão em [Operate with ubctl](https://docs.unbroker.cloud/guides/operate-with-ubctl).

Um agente de código só pode rodar esses comandos com um token que tenha permissão. O que esse token não deve ver está em [Deixar um agente fazer deploy com cuidado](https://unbroker.cloud/pt/blog/coding-agent-deploy-safely). As páginas de agentes começam em [Agentes de código](https://unbroker.cloud/agents).

O Pro custa $25 por mês com $25 de crédito de uso. O crédito não acumula. Se o uso fica abaixo do crédito, a cobrança continua $25. As linhas do plano estão em [preços](https://unbroker.cloud/pt/precos) e em [Plans](https://docs.unbroker.cloud/billing/plans).

## Checklist

1. Leia o log de build, o log de runtime e o deployment que está live de verdade antes de mudar a capacidade.
2. Registre um nível com um marcador explícito se quiser que o filtro de nível veja a linha.
3. Trate um buraco numa linha de métrica como dado ausente, não como zero.
4. Ligue **Enable alerts** para os avisos de queda e de crash-loop ficarem ativos.
5. Adicione um check de uptime HTTPS só para uma URL que o serviço possui, inclusive um domínio próprio ativo.
6. Se adicionar uma regra de métrica, copie um exemplo documentado só como ponto de partida, e depois defina o limite deste serviço.
7. No Pro, ligue **Health alerts** se o e-mail ou um webhook compatível com Slack precisarem disparar.
8. Deixe o error tracking para falhas de request. Não trate um 2xx de uptime como esse tracker.
9. Use o Pro para métricas de recursos e alertas de métrica. Logs de runtime também estão no Free.

## Perguntas frequentes

### O que monitorar primeiro num serviço novo de produção?

Os quatro sinais: o log de build, o log de runtime, as métricas de recursos e o histórico de deployments. Os exemplos da documentação são um check HTTPS de uptime, restarts de contêiner acima de 3 em 5 minutos, e réplicas ready abaixo de 100 em 5 minutos. Esses números são exemplos, não um conjunto obrigatório. Os alertas de queda e de crash-loop não precisam de regra enquanto Enable alerts estiver ligado.

### Por quanto tempo os logs de runtime ficam na Unbroker?

Os logs de runtime ficam por 7 dias. As linhas são coletadas mais ou menos a cada 30 segundos. Se uma janela de 30 segundos passa de 5.000 linhas ou de 2 MiB, as linhas mais antigas dessa janela são descartadas. A saída de build fica em cada deployment. A de mais de 90 dias é removida, exceto a do deployment que o serviço está rodando agora.

### Como receber um alerta quando a app cai?

Ligue Enable alerts. A Unbroker avisa quando um serviço cai ou entra em crash-loop, sem uma regra extra. Um check de uptime HTTPS é outra regra: pede uma URL HTTPS pública e fica saudável com qualquer 2xx. Todo alerta aparece no sino. E-mail e um webhook compatível com Slack são canais do Pro, e só se Health alerts estiver ligado.

### Alertas podem ir para o Slack?

No Pro, sim, como webhook compatível com Slack, se Health alerts estiver ligado em Project settings, Deploy notifications. O mesmo interruptor cobre o e-mail para o owner da organização. O sino não depende desse interruptor. Deploy notifications não estão no Free.

### A Unbroker avisa de um crash-loop sem uma regra?

Sim, enquanto Enable alerts estiver ligado para a organização. Os avisos de queda e de crash-loop já vêm inclusos. Eles usam o sino e, no Pro, os canais do projeto se Health alerts estiver ligado. Uma regra de restarts é opcional e é um alerta de métrica, que exige Pro.

### Métricas de recursos e alertas de métrica estão no Free?

Não. Métricas de recursos fazem parte do Pro. Alertas de métrica exigem Pro. Logs de runtime estão no Free e no Pro. A tabela de planos lista deploy notifications, que levam o e-mail e o webhook do Slack, como indisponíveis no Free.

### Qual é a diferença entre um check de uptime e um alerta de métrica?

Um check de uptime pede uma URL HTTPS pública e fica saudável com qualquer 2xx. A URL precisa ser o endereço daquele serviço ou um domínio próprio ativo. Um alerta de métrica compara CPU, memória, restarts, pods unhealthy ou réplicas ready com um limite, numa janela de 1 a 1440 minutos. A documentação exige Pro para alertas de métrica. Ela não declara um plano para criar um check de uptime.

### Alertas da plataforma substituem error tracking?

Não. A documentação diz que os alertas ajudam a perceber um problema e não substituem a telemetria da aplicação nem o error tracking. Um 200 de /health não prova que um request posterior funcionou. Erros por request, latência e traces ficam no tracker que você opera.

### Como criar um alerta pelo terminal?

ubctl monitoring ls lista as regras. ubctl monitoring alert-create adiciona uma regra de métrica. ubctl monitoring uptime-create adiciona um check HTTPS. ubctl monitoring check avalia uma agora. ubctl monitoring rm remove uma. O valor 768 de memória na página da CLI é o exemplo dessa página, não um limite que você precise usar. Administrar regras exige a permissão de settings da organização.

## Related reading

- [Depurar um deploy que falhou](https://unbroker.cloud/pt/blog/debug-failed-deployment)
- [Deploy com git push](https://unbroker.cloud/pt/blog/deploy-on-git-push)
- [Autoscaling de réplicas](https://unbroker.cloud/pt/blog/replica-autoscaling)
- [Domínio próprio e HTTPS](https://unbroker.cloud/pt/blog/custom-domain-https)
- [Preços](https://unbroker.cloud/pt/precos)
- [Agentes de código](https://unbroker.cloud/agents)
