Skip to main content
Stream function logs from your Convex deployment. By default, this streams from your project’s dev deployment.

Usage

npx convex logs [options]

Options

--history
number
Show n most recent logs. Defaults to showing all available logs.
npx convex logs --history 50
--success
boolean
Print a log line for every successful function execution. By default, only errors and console logs are shown.
npx convex logs --success
--jsonl
boolean
Output raw log events as JSONL (JSON Lines) format for parsing with other tools.
npx convex logs --jsonl > logs.jsonl
--prod
boolean
Watch logs from this project’s production deployment instead of dev.
npx convex logs --prod
--env-file
string
Path to a custom file of environment variables for choosing the deployment. Same format as .env.local or .env files, and overrides them.
npx convex logs --env-file .env.staging

Examples

Stream dev deployment logs

Watch logs from your development deployment:
npx convex logs

View recent production logs

See the last 100 logs from production:
npx convex logs --prod --history 100

Monitor all executions including successes

Watch all function executions, including successful ones:
npx convex logs --success

Export logs for analysis

Output logs in JSONL format for processing:
npx convex logs --jsonl > app-logs.jsonl

Debug production issues

View recent production logs with full execution details:
npx convex logs --prod --history 200 --success

Log output format

By default, logs are displayed in a human-readable format showing:
  • Timestamp
  • Function name and type (query/mutation/action)
  • Execution status (success/error)
  • Console output from your functions
  • Error messages and stack traces
With --jsonl, each log line is a JSON object containing structured data about the execution.

Common use cases

Development debugging

Leave logs running while developing to see real-time feedback:
npx convex logs --success

Production monitoring

Monitor production errors in real-time:
npx convex logs --prod

Log aggregation

Collect logs for external analysis tools:
npx convex logs --jsonl --prod | your-log-processor

Build docs developers (and LLMs) love