CLI

Inspect deployments and logs

List and inspect Easel deployments, and query or follow request logs, from the CLI.

These commands use the linked project unless you pass a project. See Link a project.

List deployments

easel list
easel ls my-app
easel list --prod
easel list --environment preview --status READY --limit 20

Option	Description
`[project]`	Project slug or ID (defaults to the linked project)
`--status`	Comma-separated statuses, such as `READY,BUILDING`
`--environment`	`production` or `preview`
`--prod`	Shorthand for `--environment production`
`--limit`	Maximum number of deployments to return
`--cursor`	Pagination cursor from a previous response

The output lists each deployment's ID, status, environment, branch, age, and URL.

Inspect a deployment

Inspect a deployment by ID or by its URL:

easel inspect dpl_1234567890
easel inspect https://my-app-git-main-acme.preview.easelusercontent.com

The output shows the deployment's status, target, source, URL, Git commit, aliases, and timestamps.

Option	Description
`-l, --logs`	Print build logs
`--wait`	Wait until the deployment reaches `READY`, `ERROR`, `CANCELLED`, or `SPUN_DOWN`
`--timeout`	How long `--wait` waits, such as `5m` or `30s` (default `3m`)

easel inspect dpl_1234567890 --wait --timeout 5m --logs

Query request logs

easel logs shows recent requests for the project. Pass a deployment ID or URL to narrow it to one deployment. Without --since, it shows the last 24 hours.

easel logs
easel logs dpl_1234567890
easel logs --environment production --status-code 5xx --since 1h
easel logs --request-id <request-id> --expand

Option	Description
`[reference]`, `--deployment`	Deployment ID or URL
`--project`	Project slug or ID (defaults to the linked project)
`-e, --environment`	`production` or `preview`
`--status-code`	Status code or family, such as `500` or `5xx`
`--level`	Function log level: `warning`, `error`, or `fatal`
`-q, --query`	Filter query, such as `path:"/api" method:GET`
`--request-id`	One request by its ID
`--since`, `--until`	Time bounds, such as `1h`, `30m`, or an ISO 8601 timestamp
`--limit`	Maximum number of requests to return
`-x, --expand`	Print function log lines under each request
`-f, --follow`	Keep polling for new requests
`--timeout`	How long `--follow` runs, such as `10m`

Follow live traffic

easel logs --follow --expand --timeout 10m

For how far back you can query and how often --follow polls, see Observability limits. To search and filter requests in the dashboard, see Logs.

Deploy

Upload a local project and create a preview or production deployment with easel deploy, locally or in CI.

Limits reference

Every enforced Easel limit for builds, Functions, requests, Runtime Cache, domains, security, and observability.