Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cirron.com/llms.txt

Use this file to discover all available pages before exploring further.

​
cirron logs

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

​
Usage

cirron logs [options]

​
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

# Show last 100 lines (default)
cirron logs

# Show last 200 lines
cirron logs --lines 200

# Show logs for staging environment
cirron logs --env staging

​
Follow Logs in Real Time

cirron logs --follow

# Follow logs for development environment
cirron logs --env development --follow

​
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

12:34:56 INFO  Project started successfully
12:34:57 WARN  Using default configuration
12:34:58 ERROR Failed to connect to database

​
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