Skip to main content
CLI

Query request logs

Query and follow request logs for Easel projects from the CLI.

Show recent request logs for the linked project, optionally filtered to a deployment.

Basic usage

easel logs
easel logs dpl_1234567890
easel logs --environment production --status-code 5xx --since 1h

Log command options

OptionDescription
-f, --followPoll for new request logs
-x, --expandPrint function log lines for each request
--projectProject slug or ID (defaults to the linked project)
--deploymentDeployment ID or URL filter
-e, --environmentproduction or preview
--status-codeStatus code or family (for example 500, 5xx)
--levelConsole log level (warning, error, fatal)
-q, --queryFilter query (for example path:"/api" method:GET)
--request-idShow logs for a specific request ID
--since / --untilTime bounds (1h, 30m, or ISO 8601)
--limitMaximum number of requests to return
--timeoutHow long --follow should run (default 5m)

Follow live traffic

Follow live traffic and expand function output:

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

Next steps

On this page

Edit on GitHub