Logs de aplicación

Los logs de aplicación le permiten enviar la salida Log:: de su aplicación a Quiet Guard y consultarla junto a las excepciones que explica. Los registros se encuentran en la pestaña Registros de cada proyecto, en el panel /app.

Funcionalidad de pago. Los logs de aplicación están condicionados a la funcionalidad de plan logs. En el plan Free, la ingesta de logs se rechaza; los planes Indie y Studio la incluyen. Vea Facturación y planes.

Ingesta por lotes

Los logs se envían por lotes, no una petición por línea, para limitar la sobrecarga. Su cliente almacena en un búfer las entradas de log y las envía a /api/v1/logs, generalmente al final de la petición y después de los jobs de cola.

Cada lote es un array de entradas de log:

{
  "logs": [
    {
      "level": "error",
      "message": "La passerelle de paiement a expiré",
      "context": { "order_id": 1234 },
      "channel": "payments",
      "environment": "production",
      "release": "9f2c1ab",
      "logged_at": "2026-06-28T10:15:00+00:00"
    }
  ]
}

Un lote debe contener entre 1 y 500 entradas. Solo message es requerido por entrada; level, context, channel, environment, release y logged_at son opcionales. El contrato completo figura en la referencia de la API de ingesta.

Si su plan no incluye los logs, el punto de entrada responde 403 Forbidden:

{ "message": "Application logs are not available on your current plan." }

Cómo se descuenta de la cuota

Los logs comparten la misma cuota mensual de eventos que las excepciones, cada entrada de log almacenada cuenta como un evento. Esto importa por dos razones:

1. Cuota flexible. Cuando un lote superaría la cuota de su plan (más un margen de tolerancia del 10 %), Quiet Guard almacena solo lo que cabe y descarta silenciosamente el excedente. Sin error, sin facturación sorpresa, la respuesta simplemente indica cuántas entradas se han almacenado:

``json { "message": "accepted", "stored": 137 } ``

Así, un lote de 200 entradas con solo 137 plazas restantes en su cuota almacena 137 y descarta 63.

1. Retención. Los logs almacenados se purgan según la ventana de retención de su plan (7 / 30 / 90 días para Free / Indie / Studio) mediante el job de limpieza diario.

Vea Facturación y planes para los detalles de cuota, tolerancia y retención.

Cifrado en reposo

Si su equipo tiene el almacenamiento cifrado activo, el mensaje y el contexto de cada entrada de log se sellan con la clave pública de su equipo en la ingesta, y las columnas en claro se vacían. Los metadatos (nivel, canal, entorno, release, marca de tiempo) permanecen en claro para que la lista y los filtros sigan funcionando. Los logs bloqueados muestran un marcador de posición hasta que usted desbloquee la sesión con su frase secreta.

Leer la página de logs

La pestaña Logs de un proyecto está pensada para el barrido visual:

• Una línea de tiempo de severidad de 7 días corona la tabla: errores, advertencias e info apilados por día, los picos se ven antes de desplazarse.
• Los filtros están siempre visibles encima de la tabla: grupo de severidad en un clic (errores / advertencias / info), selección múltiple de niveles, entorno y canal.
• La tabla se refresca automáticamente cada 30 segundos, y una nota bajo el encabezado recuerda la duración de conservación según su plan.
• En la página de una entrada, un contexto anidado se muestra también en JSON en bruto formateado, además de la cuadrícula clave-valor.