Skip to main content

​
sentry log list

List and stream logs from Sentry projects. Supports real-time streaming with the --follow flag and filtering by trace ID with the --trace flag.

​
Usage

sentry log list [<org>/<project>]

​
Target Patterns

sentry log list                   # auto-detect from DSN or config
sentry log list <org>/<proj>      # explicit org and project
sentry log list <project>         # find project across all orgs

​
Trace Filtering

When --trace is provided, only organization resolution is needed (the trace-logs endpoint is org-scoped). The positional target is treated as an org slug, not an org/project pair. 
sentry log list --trace <trace-id>         # auto-detect org
sentry log list <org> --trace <trace-id>   # explicit org

​
Flags

​
--limit
number
default:"100"
Number of log entries to retrieve (1-1000)Alias: -nExample:
sentry log list --limit 50
​
--query
string
Filter query using Sentry search syntaxAlias: -qExample:
sentry log list -q 'level:error'
​
--follow
number
Stream logs in real-time. Optionally specify poll interval in seconds (default: 2s).When enabled, continuously polls for new logs. Press Ctrl+C to stop.Alias: -fExample:
# Stream with default 2s interval
sentry log list -f

# Stream with 5s interval
sentry log list -f 5
​
--trace
string
Filter logs by trace ID (32-character hex string)When provided, switches to org-scoped trace-logs endpoint.Example:
sentry log list --trace abc123def456abc123def456abc123de
​
--json
boolean
default:"false"
Output as JSON (one log entry per line in single-fetch mode, or array in streaming mode)Example:
sentry log list --json

​
Examples

​
Basic Usage

# List last 100 logs (default)
sentry log list

# List from specific project
sentry log list my-org/my-project

# Show last 50 logs
sentry log list --limit 50

​
Streaming Mode

# Stream logs with default 2s poll interval
sentry log list -f

# Stream logs with 5s poll interval
sentry log list -f 5

# Stream logs from specific project
sentry log list my-org/my-project -f

​
Filtering

# Filter to errors only
sentry log list -q 'level:error'

# Filter by trace ID
sentry log list --trace abc123def456abc123def456abc123de

# Stream logs for a specific trace
sentry log list --trace abc123def456abc123def456abc123de -f

​
JSON Output

# Export logs to JSON
sentry log list --json > logs.json

# Stream logs as JSON
sentry log list -f --json

​
Sample Output

​
Human-Readable Format

┌─────────────────────────┬──────────┬────────────────────────────────────────────────────┬────────────┐
│ TIMESTAMP               │ SEVERITY │ MESSAGE                                            │ TRACE      │
├─────────────────────────┼──────────┼────────────────────────────────────────────────────┼────────────┤
│ 2024-03-05 14:23:45 UTC │ error    │ Database connection timeout                        │ abc123...  │
│ 2024-03-05 14:23:46 UTC │ warning  │ Slow query detected: SELECT * FROM users           │ abc123...  │
│ 2024-03-05 14:23:47 UTC │ info     │ Request completed in 234ms                         │ def456...  │
└─────────────────────────┴──────────┴────────────────────────────────────────────────────┴────────────┘

Showing 100 logs. Use --limit to show more, or -f to follow.

​
Streaming Mode

Streaming logs... (poll interval: 2s)
Press Ctrl+C to stop.

┌─────────────────────────┬──────────┬────────────────────────────────────────────────────┬────────────┐
│ TIMESTAMP               │ SEVERITY │ MESSAGE                                            │ TRACE      │
├─────────────────────────┼──────────┼────────────────────────────────────────────────────┼────────────┤
│ 2024-03-05 14:30:01 UTC │ info     │ New user registration                              │ ghi789...  │
│ 2024-03-05 14:30:03 UTC │ error    │ Payment processing failed                          │ jkl012...  │

​
JSON Format

[
  {
    "timestamp": "2024-03-05T14:23:45Z",
    "timestamp_precise": 1709649825000000000,
    "severity": "error",
    "message": "Database connection timeout",
    "trace": "abc123def456abc123def456abc123de"
  },
  {
    "timestamp": "2024-03-05T14:23:46Z",
    "timestamp_precise": 1709649826000000000,
    "severity": "warning",
    "message": "Slow query detected: SELECT * FROM users",
    "trace": "abc123def456abc123def456abc123de"
  }
]

​
Notes

  • By default, logs are displayed in chronological order (oldest first) with the most recent 100 entries
  • The API returns logs newest-first; the CLI automatically reverses them for tail-like behavior
  • In streaming mode, the command polls every 2 seconds by default (configurable with -f <seconds>)
  • Press Ctrl+C to stop streaming mode cleanly
  • When using --trace, the endpoint searches logs from the last 14 days across all projects in the org
  • Standard (project-scoped) mode shows logs from the last 90 days by default
  • The trace column shows a short suffix of the trace ID; use --trace to filter to a specific trace

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us