Logs de la aplicación en tiempo real
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/realtime \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/realtime', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/realtime"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/realtime"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}event: logs
data: 2026-03-20T19:58:00Z [INFO] Application iniciada com sucesso
event: logs
data: 2026-03-20T19:58:01Z [DEBUG] Connected to database
event: logs
data: 2026-03-20T19:58:02Z [ERROR] Failed to process request
event: system
data: 2026-03-20T19:58:03Z Connection Closed
Aplicaciones
Logs de la aplicación en tiempo real
Devuelve los logs en tiempo real de una aplicación a partir de su ID, transmitidos como un flujo de eventos de texto.
GET
/
v1
/
apps
/
{id}
/
realtime
Logs de la aplicación en tiempo real
curl --request GET \
--url https://api.vertracloud.app/v1/apps/{id}/realtime \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/apps/{id}/realtime', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/apps/{id}/realtime"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/apps/{id}/realtime"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}event: logs
data: 2026-03-20T19:58:00Z [INFO] Application iniciada com sucesso
event: logs
data: 2026-03-20T19:58:01Z [DEBUG] Connected to database
event: logs
data: 2026-03-20T19:58:02Z [ERROR] Failed to process request
event: system
data: 2026-03-20T19:58:03Z Connection Closed
string
requerido
El ID de la aplicación cuyos logs en tiempo real quieres obtener. Si la aplicación pertenece a un workspace, pasa su ID en el parámetro de consulta
workspace_id.string
Si la aplicación pertenece a un workspace, el ID del workspace. Es obligatorio para los miembros del workspace que actúen sobre una aplicación que no les pertenece.
Respuesta
La respuesta se transmite como un flujo de eventos de texto (text/event-stream). Cada entrada de log se envía como un evento con el siguiente formato:
- Tipo de evento:
logspara los mensajes de log,systempara los avisos del flujo y de la plataforma (por ejemplo,install_note:started),heartbeatpara los eventos de keep-alive sin contenido. - Data: Texto plano (no JSON). Un evento
logslleva una o más líneas separadas por saltos de línea, cada una con una marca de tiempo ISO 8601 seguida del mensaje del log.
system también pueden informar de lo que ocurrió con la nueva versión. El aviso nombra las releases implicadas por su ID, tal como aparecen en Listar releases de la aplicación:
deploy_note:failed:<release_id>: la nueva versión se detuvo justo después de arrancar. El log del fallo está disponible en esa release.deploy_note:rollback:<from>:<to>: la plataforma volvió automáticamente a la versión anterior, porque la nueva se detuvo en los 60 segundos posteriores al despliegue.<from>es la release que falló y<to>es la que vuelve a estar en ejecución.deploy_note:discarded:<release_id>: en el plan Enterprise, la nueva versión no llegó a estar sana y se descartó; la versión anterior siguió ejecutándose.
install_note:started.
La instalación se ejecuta fuera del límite de memoria del plan, y la aplicación arranca en cuanto termina.
event: logs
data: 2026-03-20T19:58:00Z [INFO] Application iniciada com sucesso
event: logs
data: 2026-03-20T19:58:01Z [DEBUG] Connected to database
event: logs
data: 2026-03-20T19:58:02Z [ERROR] Failed to process request
event: system
data: 2026-03-20T19:58:03Z Connection Closed
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: Falta la cabeceraAuthorization, la clave de API no es válida o la sesión del panel fue revocada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (403).ACCESS_DENIED: El recurso pertenece a otra cuenta, o no tienes el permiso de workspace necesario para él (403).APP_NOT_FOUND: La aplicación indicada no existe.FORBIDDEN: El usuario no tiene permiso para acceder a la aplicación.
string
Un mensaje descriptivo con más detalles sobre el error.
{
"code": "APP_NOT_FOUND"
}
{
"code": "FORBIDDEN"
}
Última modificación el 28 de octubre de 2026