Skip to main content

Output Capture

Saturn captures job output (stdout/stderr) for debugging failed runs.

How It Works​

  1. Send with ping: Include output field in success/fail ping
  2. Redaction: Sensitive data automatically redacted
  3. Storage: Stored in MinIO/S3
  4. Retrieval: View in dashboard or via API

Configuration​

Configure output capture in your monitor settings:

  • maxOutputSizeKb: Maximum output size (default: 10 KB)
  • captureOutput: Enable/disable output capture (default: false)

Sending Output​

```bash OUTPUT=$(./backup.sh 2>&1) EXIT_CODE=$?

if [ $EXIT_CODE -eq 0 ]; then curl -X POST .../success
-d "{"output": $(echo "$OUTPUT" | jq -Rs .)}" else curl -X POST .../fail
-d "{"exitCode": $EXIT_CODE, "output": $(echo "$OUTPUT" | jq -Rs .)}" fi ```

Viewing Output​

Dashboard: Click incident → View Output

API: ```bash GET /api/runs/RUN_ID/output ```

Redaction​

Automatically redacts:

  • Passwords (password=secret)
  • API keys (api_key: abc123)
  • Bearer tokens (Bearer eyJ...)
  • AWS credentials
  • Private keys
  • Credit card numbers

Size Limits​

  • Default: 10 KB
  • Max: 100 KB (Enterprise)
  • Truncated if exceeded

Next Steps​