CLI Reference
whatalo logs
View and stream webhook delivery logs for your plugin — filter by event type, status, or store.
Syntax
whatalo logs [options]Options
| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--follow | -f | boolean | — | Watch mode — poll for new logs every 3 seconds |
--event <type> | — | string | — | Filter by event type (e.g., ORDER_CREATED) |
--status <s> | — | string | — | Filter by delivery status: delivered or failed |
--store <id> | — | string | — | Filter by store ID |
--limit <n> | — | string | 20 | Number of results to return (maximum: 100) |
--detail <id> | — | string | — | Show full detail for a specific log entry |
--json | — | boolean | — | Output as JSON |
--portal-url <url> | — | string | — | Developer Portal URL |
Examples
Show the 20 most recent webhook deliveries:
whatalo logsStream logs in real time:
whatalo logs --followShow only failed deliveries:
whatalo logs --status failedFilter by event type:
whatalo logs --event ORDER_CREATED --limit 50View full detail for a specific log entry (supports 8-character ID prefix):
whatalo logs --detail a1b2c3d4Output as JSON for scripting:
whatalo logs --json --limit 100Follow Mode
When --follow is active, the CLI polls for new logs every 3 seconds and prints only entries that appeared since the last poll. Stop with Ctrl+C.
whatalo logs --follow --event CHECKOUT_COMPLETEDDetail View
The --detail flag shows the full record for a single log entry, including:
| Field | Description |
|---|---|
| Event | Event type (e.g., ORDER_CREATED) |
| Status | delivered or failed |
| HTTP code | Response status code from your server |
| Store | Store that triggered the event |
| Time | Timestamp of the delivery attempt |
| Duration | Time taken for your server to respond |
| Attempts | Number of delivery attempts |
| Source | Origin of the event |
| Request URL | The URL the webhook was sent to |
| Payload | Request body (truncated to 500 characters) |
| Response | Response body from your server |
| Error | Error message if delivery failed |
Related Commands
whatalo webhook trigger— Send a test webhook during developmentwhatalo dev— Start local development