vercel inspect

Learn how to retrieve information about your Vercel deployments using the vercel inspect CLI command.
Table of Contents

The vercel inspect command is used to retrieve information about a deployment referenced either by its deployment URL or ID.

You can use this command to view either a deployment's information or its build logs.

terminal
vercel inspect [deployment-id or url]

Using the vercel inspect command to retrieve information about a specific deployment.

These are options that only apply to the vercel inspect command.

The --timeout option sets the time to wait for deployment completion. It defaults to 3 minutes.

Any valid time string for the ms package can be used.

terminal
vercel inspect https://example-app-6vd6bhoqt.vercel.app --timeout=5m

Using the vercel inspect command with the --timeout option.

The --wait option will block the CLI until the specified deployment has completed.

terminal
vercel inspect https://example-app-6vd6bhoqt.vercel.app --wait

Using the vercel inspect command with the --wait option.

The --logs option, shorthand -l, prints the build logs instead of the deployment information.

terminal
vercel inspect https://example-app-6vd6bhoqt.vercel.app --logs

Using the vercel inspect command with the --logs option, to view available build logs.

If the deployment is queued or canceled, there will be no logs to display.

If the deployment is building, you may want to specify --wait option. The command will wait for build completion, and will display build logs as they are emitted.

terminal
vercel inspect https://example-app-6vd6bhoqt.vercel.app --logs --wait

Using the vercel inspect command with the --logs and --wait options, to view all build logs until the deployement is ready.

The following global options can be passed when using the vercel inspect command:

For more information on global options and their usage, refer to the options section.

Last updated on July 17, 2024