# Logs, métricas y alertas: señales que ayudan a notar un fallo antes

Monitoreo de aplicaciones y alertas: logs de build, logs de runtime, métricas e historial. Ayudan a ver un fallo antes. No lo garantizan.

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

## La respuesta corta

El monitoreo de aplicaciones y las alertas en Unbroker son cuatro señales: el log de build, el log de runtime, las métricas de recursos y el historial de deployments. Unas pocas alertas sobre esas señales ayudan a notar un fallo más temprano. No garantizan que veas cada caída antes que un usuario.

Las alertas de la plataforma no son error tracking. Un chequeo sano no prueba que cada request haya funcionado.

## Cuatro señales, cuatro preguntas

| Señal | Pregunta que responde |
| --- | --- |
| Log de build | Por qué una revisión de código se construyó o no |
| Log de runtime | Qué está informando la aplicación en marcha |
| Métricas | CPU, memoria, reinicios, instancias unhealthy y readiness |
| Historial de deployments | Qué cambió, y qué revisión está live |

Leer la señal equivocada esconde la causa. Un deploy fallido está en [Depurar un deploy fallido](https://unbroker.cloud/es/blog/debug-failed-deployment). Qué push se volvió ese deploy está en [Desplegar con git push](https://unbroker.cloud/es/blog/deploy-on-git-push). La referencia es [Logs, metrics, and monitoring](https://docs.unbroker.cloud/apps/monitoring).

## Logs de runtime que se pueden buscar

La pestaña **Logs** es stdout y stderr. Las líneas se juntan más o menos cada 30 segundos y se guardan 7 días. La búsqueda corre en el servidor para el rango que elijas. Podés filtrar por errors, warnings, info o debug. **Download** guarda las líneas que coinciden.

Una línea tiene nivel solo si trae un marcador explícito: un campo JSON `level` o `severity`, `level=warn`, `[ERROR]`, un `WARN:` al inicio, o los formatos de nginx y PostgreSQL. Una línea sin marcador se muestra sin nivel. El producto no adivina.

Si un servicio escribe más de 5.000 líneas, o 2 MiB, en una ventana de 30 segundos, las líneas más viejas de esa ventana no se guardan. Unbroker agrega una línea que dice cuántas se descartaron.

La salida de build es otro registro. Queda con ese deployment. Un log de build muy grande conserva el principio y la salida más reciente. La salida de más de 90 días se borra, salvo la del deployment que el servicio está corriendo ahora.

No pegues un secreto en un log que compartís. Dejá el valor en una variable. Cómo se agrupan esas variables está en [Variables de entorno y secretos](https://unbroker.cloud/es/blog/environment-variables-and-secrets).

## Métricas: CPU, memoria, reinicios, readiness

La pestaña **Resources** grafica CPU, memoria, tráfico de red y réplicas. Los rangos fijos son 15 minutos, 1 hora, 6 horas, 24 horas, 7 días y 30 días. Una ventana a medida se queda dentro de los últimos 30 días.

Las muestras se juntan cada minuto. Los gráficos las promedian en buckets. Las muestras por minuto se guardan 7 días. Los promedios horarios se guardan 90 días, así que un rango de más de una semana es horario. CPU y memoria se suman entre réplicas. La línea punteada es el techo de ese momento: el límite por réplica por las réplicas que están corriendo. Una línea fina en los gráficos de CPU y memoria es el pico del bucket, sobre el promedio, así que un pico corto se sigue viendo.

Un hueco en una línea quiere decir que no hubo muestra. No se dibuja como cero. **Availability** es la parte de las réplicas deseadas que estaban ready. **Restarts** son reinicios de contenedor por bucket, y la serie aparece solo cuando hubo alguno. El tráfico de red aparece donde el clúster expone contadores por réplica.

Las métricas de recursos son parte de Pro. Cómo cambia la cantidad de réplicas por CPU o memoria es otro control, en [Autoscaling de réplicas](https://unbroker.cloud/es/blog/replica-autoscaling).

## Ejemplos de alertas, no un set obligatorio

La página de monitoreo usa estos valores como ejemplos. No son una recomendación universal.

| Métrica | Ejemplo de la documentación |
| --- | --- |
| CPU | Por encima de `800` milicores en 5 minutos. `1000` milicores es 1 vCPU. La CPU se suma entre réplicas. |
| Memoria | Por encima de `1536` MiB en 10 minutos, en la tabla. La página de la CLI usa otro ejemplo: por encima de `768` MiB en 5 minutos. |
| Restarts | Por encima de `3` en 5 minutos. |
| Unhealthy pods | Por encima de `0` en 5 minutos. |
| Ready replicas | Por debajo de `100` por ciento de la cantidad deseada, en 5 minutos. |

Un chequeo de uptime HTTPS pide una URL pública y está sano con cualquier `2xx`. La URL tiene que ser la dirección del servicio o un dominio propio activo. El ejemplo de la CLI es `https://api.example.com/health`. Un dominio propio está en [Dominio propio y HTTPS](https://unbroker.cloud/es/blog/custom-domain-https).

La ventana de una métrica va de 1 a 1440 minutos. El default es 5. Las reglas se evalúan cada minuto. El estado es **Healthy**, **Alerting** o **Unknown** cuando todavía no hay datos o el chequeo no pudo correr. Crear y editar reglas pide el permiso de settings de la organización.

Las alertas de métricas requieren Pro. La documentación de monitoreo no dice un requisito de plan para crear un chequeo de uptime HTTPS. Esta nota no agrega uno.

## Adónde llega una alerta

Una regla avisa cuando empieza a alertar y otra vez cuando se recupera. Toda alerta aparece en la campana.

En Pro, la misma alerta también puede ir a los canales del proyecto: email al owner de la organización, y un webhook compatible con Slack. Eso pasa si **Health alerts** está prendido, en **Project settings → Deploy notifications**. Las deploy notifications no están en Free. En Pro son email y un webhook de Slack.

Dos avisos no necesitan regla. Mientras **Enable alerts** esté prendido para la organización, Unbroker avisa cuando un servicio se cae o entra en crash-loop. Esas alertas incluidas usan la campana y, en Pro, los canales del proyecto si **Health alerts** está prendido.

## Lo que estas alertas no cubren

No reemplazan la telemetría de la aplicación ni el error tracking. La documentación de monitoreo lo dice directo. Un chequeo de uptime que devuelve 2xx no muestra una query lenta, un checkout fallido ni un stack trace adentro de una respuesta 200.

Beacon no es este sistema de alertas. Es pub/sub en tiempo real con entrega at-most-once, y no es una cola durable. La nota es [Beacon reliability](https://docs.unbroker.cloud/beacon/reliability). Un síntoma de base que después encontrás en Postgres está en [Postgres en producción](https://unbroker.cloud/es/blog/postgres-in-production).

## Cómo funciona en Unbroker

Abrí **Logs** para stdout y stderr. Abrí **Resources** para los gráficos y la tarjeta **Alerts**. Desde la tarjeta podés pausar, reanudar, correr **Check now** o borrar una regla. **New alert** agrega una métrica de recursos o un chequeo de uptime.

Desde la terminal, los comandos documentados son:

```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` y el nombre `high-memory` son el ejemplo de la página de la CLI. Los nombres de métrica son `cpu`, `memory`, `restarts`, `unhealthy` y `ready_percent`. La referencia de comandos es [Monitoring commands](https://docs.unbroker.cloud/cli/monitoring). Las rutas HTTP son [la API de monitoreo](https://docs.unbroker.cloud/api/monitoring). Otros comandos de `ubctl` están en [Operate with ubctl](https://docs.unbroker.cloud/guides/operate-with-ubctl).

Un agente de código puede correr esos comandos solo con un token que tenga permiso. Qué no tiene que ver ese token está en [Dejar que un agente despliegue con cuidado](https://unbroker.cloud/es/blog/coding-agent-deploy-safely). Las páginas de agentes empiezan en [Agentes de código](https://unbroker.cloud/agents).

Pro sale $25 por mes con $25 de crédito de uso. El crédito no se acumula. Si el uso queda por debajo del crédito, el cargo sigue siendo $25. Las filas del plan están en [precios](https://unbroker.cloud/es/precios) y en [Plans](https://docs.unbroker.cloud/billing/plans).

## Lista de control

1. Leé el log de build, el log de runtime y el deployment que está live de verdad antes de cambiar la capacidad.
2. Logueá un nivel con un marcador explícito si querés que el filtro de nivel lo vea.
3. Tratá un hueco en una línea de métrica como dato faltante, no como cero.
4. Prendé **Enable alerts** para que los avisos de caída y de crash-loop estén activos.
5. Agregá un chequeo de uptime HTTPS solo para una URL que el servicio posea, incluido un dominio propio activo.
6. Si agregás una regla de métrica, copiá un ejemplo documentado solo como etiqueta de partida, y después fijá el umbral de este servicio.
7. En Pro, prendé **Health alerts** si el email o un webhook compatible con Slack tienen que dispararse.
8. Dejá el error tracking para los fallos de request. No tomes un 2xx de uptime como ese tracker.
9. Usá Pro para métricas de recursos y alertas de métricas. Los logs de runtime también están en Free.

## Preguntas frecuentes

### ¿Qué conviene mirar primero en un servicio nuevo de producción?

Las cuatro señales: el log de build, el log de runtime, las métricas de recursos y el historial de deployments. Los ejemplos de la documentación son un chequeo HTTPS de uptime, reinicios de contenedor por encima de 3 en 5 minutos, y réplicas ready por debajo de 100 en 5 minutos. Esos números son ejemplos, no un set obligatorio. Las alertas de caída y de crash-loop no necesitan una regla mientras Enable alerts esté prendido.

### ¿Cuánto se guardan los logs de runtime en Unbroker?

Los logs de runtime se guardan 7 días. Las líneas se juntan más o menos cada 30 segundos. Si una ventana de 30 segundos pasa de 5.000 líneas o de 2 MiB, las líneas más viejas de esa ventana se descartan. La salida de build queda en cada deployment. La de más de 90 días se borra, salvo la del deployment que el servicio está corriendo ahora.

### ¿Cómo te llega una alerta si la app se cae?

Prendé Enable alerts. Unbroker avisa cuando un servicio se cae o entra en crash-loop, sin una regla extra. Un chequeo de uptime HTTPS es otra regla: pide una URL HTTPS pública y está sano con cualquier 2xx. Toda alerta aparece en la campana. El email y un webhook compatible con Slack son canales de Pro, y solo si Health alerts está prendido.

### ¿Las alertas pueden ir a Slack?

En Pro, sí, como webhook compatible con Slack, si Health alerts está prendido en Project settings, Deploy notifications. El mismo interruptor cubre el email al owner de la organización. La campana no depende de ese interruptor. Las deploy notifications no están en Free.

### ¿Unbroker avisa de un crash-loop sin una regla?

Sí, mientras Enable alerts esté prendido para la organización. Los avisos de caída y de crash-loop vienen incluidos. Usan la campana y, en Pro, los canales del proyecto si Health alerts está prendido. Una regla de reinicios es opcional y es una alerta de métrica, que requiere Pro.

### ¿Las métricas de recursos y las alertas de métricas están en Free?

No. Las métricas de recursos son parte de Pro. Las alertas de métricas requieren Pro. Los logs de runtime están en Free y en Pro. La tabla de planes lista las deploy notifications, que llevan el email y el webhook de Slack, como no disponibles en Free.

### ¿Qué diferencia hay entre un chequeo de uptime y una alerta de métrica?

Un chequeo de uptime pide una URL HTTPS pública y está sano con cualquier 2xx. La URL tiene que ser la dirección de ese servicio o un dominio propio activo. Una alerta de métrica compara CPU, memoria, reinicios, pods unhealthy o réplicas ready con un umbral, en una ventana de 1 a 1440 minutos. La documentación exige Pro para las alertas de métricas. No dice un plan para crear un chequeo de uptime.

### ¿Las alertas de la plataforma reemplazan el error tracking?

No. La documentación dice que las alertas ayudan a notar un problema y no reemplazan la telemetría de la aplicación ni el error tracking. Un 200 de /health no prueba que un request posterior haya salido bien. Los errores por request, la latencia y las trazas quedan en el tracker que corrés vos.

### ¿Cómo se crea una alerta desde la terminal?

ubctl monitoring ls lista las reglas. ubctl monitoring alert-create agrega una regla de métrica. ubctl monitoring uptime-create agrega un chequeo HTTPS. ubctl monitoring check evalúa una ahora. ubctl monitoring rm borra una. El valor 768 de memoria en la página de la CLI es el ejemplo de esa página, no un límite que tengas que usar. Administrar reglas pide el permiso de settings de la organización.

## Related reading

- [Depurar un deploy fallido](https://unbroker.cloud/es/blog/debug-failed-deployment)
- [Desplegar con git push](https://unbroker.cloud/es/blog/deploy-on-git-push)
- [Autoscaling de réplicas](https://unbroker.cloud/es/blog/replica-autoscaling)
- [Dominio propio y HTTPS](https://unbroker.cloud/es/blog/custom-domain-https)
- [Precios](https://unbroker.cloud/es/precios)
- [Agentes de código](https://unbroker.cloud/agents)
