Logs

The sentry-cli tool can be used to view and stream logs from your Sentry projects. This allows you to monitor your application logs directly from the command line.

Requirements

To use the logs command, you need to:

• Install the Sentry CLI
• Authenticate with Sentry using an auth token
• Have logs enabled for your project

Configuration

The logs command uses your Sentry auth token for authentication. You can configure this using:

sentry-cli login

Or by setting the SENTRY_AUTH_TOKEN environment variable:

export SENTRY_AUTH_TOKEN=sntrys_YOUR_TOKEN_HERE

Learn more about the CLI's configuration file.

Basic Usage

The logs command supports two main operations: listing logs and streaming logs in real-time.

List Logs

To fetch and display logs:

sentry-cli logs list --project=my-project --org=my-org

Stream Logs

To continuously stream logs in real-time:

sentry-cli logs list --project=my-project --org=my-org --live

The live streaming mode will continuously poll for new logs and display them as they arrive.

Command Options

Project and Organization

Specify the project and organization explicitly:

sentry-cli logs list --project=my-project --org=my-org

Or use the default values from your configuration file.

Examples

Monitor Application Logs

Stream logs from your production application:

sentry-cli logs list --project=my-app --org=my-org --live

View Recent Logs

Fetch and display logs from your project:

sentry-cli logs list --project=my-app --org=my-org

Output Format

The logs command displays log entries with the following information:

• Timestamp
• Log level
• Message
• Trace ID (if present)

Log entries are displayed in a readable format, making it easy to monitor your application's logging output directly from the command line.