Skip to main content

cirron logs

View and follow logs for your Cirron project environments (development, staging, production, etc.).

Usage

Options

OptionDescriptionDefault
--env, -eTarget environment (dev, staging, prod, etc.)production
--lines, -nNumber of log lines to show (string)“100”
--follow, -fFollow logs in real time (like tail -f)false

Examples

Show Recent Logs

Follow Logs in Real Time

Output

  • Logs are timestamped and color-coded by level (INFO, WARN, ERROR, DEBUG)
  • When following logs, new entries are fetched every 2 seconds
  • Press Ctrl+C to stop following logs

Example Output

How It Works

Standard Mode

  • Fetches the specified number of log lines (default: 100)
  • Displays logs with timestamps and color-coded levels
  • Exits after displaying logs

Follow Mode

  • Initially fetches recent logs
  • Polls for new logs every 2 seconds
  • Fetches up to 50 new log entries per poll
  • Continues until interrupted with Ctrl+C
  • Shows a spinner while fetching logs

Troubleshooting

  • No cirron.yaml: Run cirron init to create a project config.
  • Not Authenticated: Run cirron auth login to authenticate.
  • No Logs Found: Check that your project has been built and deployed.
  • API Errors: Check your network connection and API credentials.

Best Practices

  • Use --follow during deployments or debugging
  • Use --lines to limit output for large logs
  • Always check logs after failed builds or deploys
  • The follow mode is ideal for monitoring real-time application behavior