> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/get-convex/convex-backend/llms.txt
> Use this file to discover all available pages before exploring further.
# convex logs
> Stream function execution logs from your Convex deployment in real-time
Stream function logs from your Convex deployment. By default, this streams from your project's dev deployment.
## Usage
```bash theme={null}
npx convex logs [options]
```
## Options
Show `n` most recent logs. Defaults to showing all available logs.
```bash theme={null}
npx convex logs --history 50
```
Print a log line for every successful function execution. By default, only errors and console logs are shown.
```bash theme={null}
npx convex logs --success
```
Output raw log events as JSONL (JSON Lines) format for parsing with other tools.
```bash theme={null}
npx convex logs --jsonl > logs.jsonl
```
Watch logs from this project's production deployment instead of dev.
```bash theme={null}
npx convex logs --prod
```
Path to a custom file of environment variables for choosing the deployment. Same format as `.env.local` or `.env` files, and overrides them.
```bash theme={null}
npx convex logs --env-file .env.staging
```
## Examples
### Stream dev deployment logs
Watch logs from your development deployment:
```bash theme={null}
npx convex logs
```
### View recent production logs
See the last 100 logs from production:
```bash theme={null}
npx convex logs --prod --history 100
```
### Monitor all executions including successes
Watch all function executions, including successful ones:
```bash theme={null}
npx convex logs --success
```
### Export logs for analysis
Output logs in JSONL format for processing:
```bash theme={null}
npx convex logs --jsonl > app-logs.jsonl
```
### Debug production issues
View recent production logs with full execution details:
```bash theme={null}
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:
```bash theme={null}
npx convex logs --success
```
### Production monitoring
Monitor production errors in real-time:
```bash theme={null}
npx convex logs --prod
```
### Log aggregation
Collect logs for external analysis tools:
```bash theme={null}
npx convex logs --jsonl --prod | your-log-processor
```