User manual and SOP
The runbook for Cloud Console: how to get in, how to find your way around, and how to do the daily work step by step. Each task is a list of numbered steps beside a picture of the real screen, with the same numbers on the controls to use, and then what you see when it worked. The last part lists the messages the console shows, what each one means and how to fix it.
How to read the steps
- A number on a picture marks the control a step uses. The step below it has the same number.
- Bold words are labels on the screen, as the console writes them.
Text like this
is a message the console shows, word for word.- create names the permission a task needs.
The pictures are of a local copy of the console with a made-up project, shop, and a made-up admin. Your console has your own projects and names. Choose Dark in the top bar of this page to see the pictures in the dark theme.
The parts of the manual
Standard procedures
The routines most people repeat. Each line links to the walkthrough that shows it step by step.
The morning check
Any member, a few minutes.
- Open the Dashboard. Read the Last 24 hours tile:
No failures in the last 24 hours
is what you want. - Check that the Cron tile says Running.
- Look at Failing jobs and Backlogs. Open each row that is there.
- Open Usage. Every line should say OK.
- For a failure, follow A task failed for good or A job failed.
Before and after a deploy
Someone with the pause permission in the project.
- On Projects, click Hold dispatch for the project, and confirm (how).
- Check the banner
Maintenance is on for …: its queues and jobs are held
at the top of the page. - Run the deploy or the migration. New tasks are still accepted and wait.
- Click Resume dispatch. The banner goes.
- Check on the Dashboard that Backlogs empties.
A task failed for good
Someone with the run or delete permission.
A job failed
Someone with the run permission.
- Open the job from Failing jobs on the Dashboard, or from Jobs.
- On its Logs tab, click Show attempts on the failed run and read the error.
- Fix the cause, then click Force run (how).
- A run that says Skipped was not a failure: the label says why (see the FAQ).
A key or secret is expiring
Someone with the keys or secrets permission.
A person joins or leaves
Admins.
- To add someone, invite them with only the permissions they need. They accept within 7 days.
- To change what someone may do, use Edit access in their row on People.
- When someone leaves, choose Disable or Remove in their row. Either signs them out everywhere.
- Check the audit log for the change.
Words used here
| Word | What it is |
|---|---|
| Project | One app's own space, such as shop: its queues, jobs, API keys, secrets and alerts. You see only the projects you have a permission on. |
| Queue | A named line of HTTP tasks, with a rate limit and retry settings. Every project has a queue named default. |
| Task | One HTTP call the queue makes: a method, a URL, headers, a body and an auth option. It retries as its queue says. |
| Job | A call on a schedule (unix-cron, in a time zone): to a URL, to a queue (it adds a task), or an uptime check. |
| Attempt | One try of a task or a job run: its time, its answer's status or error, and how long it took. |
| Daily quota | How many task creations, job runs and task retries a project may make in one UTC day. 5,000 unless an admin sets another cap. |
| Maintenance | A switch that holds a project's sending (or the whole console's) during a deploy. Tasks are still accepted and wait. |
Cloud Console user manual, from the console as it is on main. The pictures are of a local copy with a made-up project, shop, and a made-up admin. 22 Oct 2026.