Skip to main content
Version: v4 (current)

Logging

Orchestrator streams logs from the remote build back to your CI runner in real time.

  Cloud Container         Orchestrator          Your CI
 ┌───────────────┐       ┌──────────────┐      ┌──────────────┐
 │ Build output  │──────►│ Log stream   │─────►│ Console      │
 │               │       │              │      │ output       │
 └───────────────┘       └──────────────┘      └──────────────┘

Provider-Specific Log Transport​

Kubernetes​

Uses the native Kubernetes logging API to stream pod logs directly.

AWS​

Logs flow through a CloudWatch → Kinesis pipeline:

  1. Orchestrator job (Fargate task) writes logs to CloudWatch Logs
  2. A Kinesis subscription forwards logs in real time
  3. Orchestrator consumes from the Kinesis stream

🐛 Debug Logging​

Enable orchestratorDebug: true to get verbose output including:

  • Resource allocation summaries (CPU, memory, disk)
  • Directory structure via tree
  • Environment variable listing
  • Disk usage snapshots (df -h, du -sh)