Monitoring
crab usage, crab calls, crab logs and crab cost read what a service used, each call of the last 30 days, its logs and what it cost.
| Command | Prints |
|---|---|
crab usage <service> |
What it used each of the last 30 days. With no service, what the account's services used and how much of its plan. |
crab calls <service> |
Its calls of the last 30 days, newest first: caller, outcome, duration, what each used and cost. --tool, --outcome and --limit narrow them. |
crab logs <service> |
Its logs, oldest first. --after <n> prints those after a sequence number. |
crab cost <service> |
What it cost in a UTC month, by resource. --month YYYY-MM picks one. |
crab calls and crab cost reach Cloud only. Only owners of the account read these.
- Every cost, here and on crabtalk.ai, is at the rates on Pricing, before the plan's included amounts. What the plan covered is on the account's Usage page; see Plans.
- A stopped service keeps its data and answers no calls until it is started again.
Current usage
A service's Monitoring page shows calls running, memory held and database allocation against its capacity. The Now card on its overview shows the same resources. These are snapshots loaded when you open the page.
Database allocation includes SQLite tables, indexes and reusable allocated pages. WAL, logs and runtime caches are excluded. Hosts without a database measurement show —. Monthly charts use recorded samples and leave missing database samples blank. Selecting a historical month does not change the current-usage section.
The account's Usage page shows storage allocated against its plan, broken into database reservations and objects. The service list compares sampled database allocation with each reservation. crab usage <service> reports the recorded database allocation in its Database column.
Calls
- A call ends
done,failed(the tool reported a failure),denied(the tool refused its caller) orrefused(the host refused it before the tool ran). - Calls are kept 30 days.
- A call that failed keeps its input and a tape of its answers, which
crab replayruns again on a developer's machine, exactly as it failed: see Replaying.
Logs
- A log belongs to the call that wrote it, with its topics and data. See Logs in the guest API.
- A log is at most 4 KiB and is kept 30 days.
- Search on crabtalk.ai finds the calls whose logs hold its text, in any case.
Projects
- Services deployed from one workspace are a project, named after the workspace's directory.
- A project holding one service shows no row of its own.