maksa

docs · runbook

Runbook

For the person on call at your company. Short on purpose.

A job looks late#

python
b = client.batches.retrieve("batch_…")
b.status, b.model_extra["eta"], b.model_extra["deadline_at"]

If eta is after deadline_at, an engineer has already been paged and the job is free. You don't need to file anything.

States#

statusmeaningyou do
validatingChecking the input fileNothing
queuedWaiting for the cheapest window that meets the deadlineNothing; eta is set
in_progressRunning; placement lists regions and GPUsNothing
deliveringWriting to your bucketCheck the delivery role if this exceeds 15 minutes
completedDelivered; receipt_id setVerify the receipt if you like
failedInput invalid or delivery denied; you are not billedRead errors.jsonl

Reach a human#

Pilot and Lock customers: your shared Slack channel, answered within the hour, 24/7. Everyone else: support@maksa.com, answered within a business day.

Incidents are posted on /trust with a postmortem within five business days.