Stream Logs

Stream real-time logs for an active execution via Server-Sent Events (SSE).

Required Role: VIEWER or higher

This endpoint provides real-time log streaming using Hatchet’s native streaming capability. Logs are streamed as JSON objects in SSE format (data: {json}\n\n).

Event Payload: Each SSE event contains a JSON object. The fields vary by event type:

Log Events (file operations, progress updates):

• level: Log level (INFO, WARNING, ERROR)
• timestamp: ISO 8601 timestamp
• message: Raw RClone message (e.g., “Copied (new)”, “Deleted”, progress stats)
• object: File path (present for file operations, e.g., “bucket/file.txt”)
• size: File size in bytes (present for file operations)
• progress: Progress percentage (0-100, present for stats updates)
• transfer_rate_mbps: Transfer rate in MB/s
• files_transferred: Number of files transferred
• files_total: Total number of files
• bytes_transferred: Bytes transferred so far
• bytes_total: Total bytes to transfer
• eta_seconds: Estimated time remaining in seconds

Stream End Event (sent when execution completes):

• type: Always “stream_end”
• status: Final status (“completed”, “failed”, “cancelled”)
• reason: Human-readable description
• timestamp: ISO 8601 timestamp

Example Events:

{"level":"INFO","timestamp":"...","message":"Copied (new)","object":"file.bin","size":71680}
{"level":"INFO","timestamp":"...","message":"Deleted","object":"old_file.bin"}
{"level":"INFO","timestamp":"...","message":"29.5 MiB / 49.5 MiB, 60%, 2.9 MiB/s, ETA 6s"}
{"type":"stream_end","status":"completed","reason":"Execution completed","timestamp":"..."}

Note: This endpoint streams until the execution completes. For completed executions, use /logs/download to retrieve the full log file.