Leer los logs
En la consola
Abra una instancia y seleccione la pestaña Logs. La vista contiene la salida más reciente del contenedor, se actualiza cada pocos segundos mientras la pestaña está abierta y se desplaza hasta la línea más nueva a medida que llega. Antes de que la instancia haya llegado alguna vez a running no hay nada que mostrar y el panel así lo indica.
Lo que obtiene es el registro de arranque y todo lo que el contenedor haya impreso desde entonces:
[2026-07-24 09:12:03] superheat-agent: pulling image pytorch/pytorch:2.4.0-cuda12.4-cudnn9-runtime
[2026-07-24 09:12:07] superheat-agent: image ready, creating container
[2026-07-24 09:12:09] nvidia-smi: detected 2 GPU(s), driver 570.86
[2026-07-24 09:12:10] sshd: listening on 0.0.0.0:40123
[2026-07-24 09:12:11] superheat-agent: instance is ready
Este es el primer lugar donde mirar cuando una instancia llega a error, cuando JupyterLab no arranca o cuando un script onstart no hizo lo que usted esperaba.
Desde la API
Estos ejemplos usan $SUPERHEAT_API y $SUPERHEAT_KEY; defínelos como se
indica en la descripción general de la API.
curl -H "Authorization: Bearer $SUPERHEAT_KEY" \
"$SUPERHEAT_API/v1/instances/$INSTANCE_ID/logs?tail=500"
{
"lines": [
"[2026-07-24 09:12:10] sshd: listening on 0.0.0.0:40123",
"[2026-07-24 09:12:11] superheat-agent: instance is ready"
]
}
| Parámetro | Valor |
|---|---|
tail | cuántas de las líneas más recientes devolver |
| Rango | 1 a 1000 |
| Por omisión | 200 |
Un tail fuera de ese rango se rechaza en lugar de ajustarse al límite, así que pida 1000 si quiere el máximo. No hay paginación ni forma de llegar más atrás de las últimas 1000 líneas. Consulte Instancias para el resto de la forma del endpoint.
Estos son logs del contenedor
Las líneas que ve son la salida propia del contenedor: los pasos de aprovisionamiento del agente y todo lo que la carga de trabajo escriba en la salida estándar o el error estándar. Ese es todo el alcance.
No son los archivos de log de su aplicación. Si su script de entrenamiento escribe en /workspace/train.log, o un framework rota archivos en un directorio logs/, nada de eso aparece aquí. Lea esos archivos por SSH:
tail -f /workspace/train.log
La imagen base mantiene dos archivos propios en disco por la misma razón, y contienen más detalle que el flujo del contenedor:
| Archivo | Contenido |
|---|---|
/var/log/superheat/jupyter.log | la salida del servidor de JupyterLab |
/var/log/superheat/onstart.log | la salida del script onstart de la plantilla |
Si quiere que su propio proceso sea visible en la vista de la consola, haga que imprima en la salida estándar y no solo en un archivo.
Qué se conserva
Los logs pertenecen a la instancia. Una detención los conserva y agrega una línea que registra que el contenedor se detuvo y que el disco se retuvo; un inicio continúa el mismo flujo. Una instancia destruida desaparece de la lista Instancias, por lo que la vista de la consola ya no es accesible: lea lo que necesite antes de destruirla. Consulte Detener frente a destruir.