Registros y Streaming
Zeabur proporciona streaming de registros en tiempo real para cada servicio, brindándote visibilidad inmediata del comportamiento de tu aplicación directamente desde el panel.
Ver Registros
Para ver los registros de un servicio:
- Abre tu proyecto en el panel de Zeabur.
- Selecciona el servicio que deseas inspeccionar.
- Haz clic en la pestaña Registros.
El visor de registros muestra la salida de los flujos stdout y stderr de tu aplicación en tiempo real. Las nuevas entradas de registro aparecen automáticamente a medida que se emiten — no se necesita actualización manual.
Registros de Compilación vs. Registros de Ejecución
Zeabur separa los registros en dos categorías:
- Registros de compilación — Salida generada durante la fase de compilación (ej., instalación de dependencias, compilación). Estos están disponibles en la pestaña Despliegues para cada despliegue.
- Registros de ejecución — Salida generada mientras tu servicio está ejecutándose. Estos se muestran en la pestaña Registros y se transmiten en tiempo real.
Búsqueda y Filtrado
El visor de registros admite búsqueda por palabras clave para ayudarte a localizar entradas específicas. Escribe un término de búsqueda en la barra de filtro en la parte superior del visor de registros para resaltar y filtrar las líneas coincidentes.
Esto es particularmente útil para:
- Encontrar mensajes de error o trazas de pila
- Rastrear IDs de solicitud específicos
- Filtrar por nivel de registro (ej.,
ERROR,WARN)
Retención de Registros
Los registros de ejecución están disponibles mientras el servicio esté ejecutándose. Cuando un servicio se reinicia o se vuelve a desplegar, los registros de la instancia anterior ya no son accesibles en el panel.
Zeabur no proporciona almacenamiento de registros a largo plazo. Si necesitas retener registros más allá del ciclo de vida actual del servicio, integra un servicio externo de registros como Logflare, Better Stack o Datadog. Puedes reenviar registros configurando tu aplicación para enviar la salida a estos servicios directamente.
Mejores Prácticas
- Usa registro estructurado. Genera registros en formato JSON para facilitar la búsqueda y el análisis, especialmente si reenvías a servicios externos.
- Incluye marcas de tiempo. Aunque Zeabur agrega marcas de tiempo a las entradas de registro, incluirlas en la salida de tu aplicación asegura consistencia entre entornos.
- Registra en niveles apropiados. Usa
INFOpara eventos rutinarios,WARNpara problemas recuperables yERRORpara fallos que necesitan atención. Evita la salida excesiva deDEBUGen producción. - Evita registrar datos sensibles. Nunca registres contraseñas, claves API o información de identificación personal.