Logs — Understanding What Your Application is Doing

Pytigon uses Django's logging framework with sensible defaults for development and production. Logs track HTTP requests, database queries, background tasks, and application-specific events.

Log Configuration

Configure logging in settings_app.py:

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'DEBUG',
            'class': 'logging.FileHandler',
            'filename': '/var/log/pytigon/app.log',
        },
        'console': {
            'level': 'INFO',
            'class': 'logging.StreamHandler',
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file', 'console'],
            'level': 'INFO',
        },
        'pytigon': {
            'handlers': ['file'],
            'level': 'DEBUG',
        },
    },
}

Log Categories

Logger	Content
`django`	HTTP requests, ORM queries, template rendering
`django.db.backends`	SQL queries (DEBUG level)
`pytigon`	Pytigon-specific events
`pytigon.tasks`	Background task execution
`pytigon.schfs`	Virtual filesystem operations
`pytigon.channels`	WebSocket connections

Viewing Logs

In the Developer Tools

scheditor includes a log viewer at /scheditor/logs/ showing recent log entries with filtering by level and category.

Command Line

tail -f /var/log/pytigon/app.log

In the Browser (Admin)

The schmanage application includes a log viewer under the Monitoring section.

Error Tracking

Pytigon integrates with Django's error reporting:

Admin emails — Critical errors are emailed to ADMINS in settings
Sentry integration — Configure Sentry DSN for centralized error tracking
Custom error handlers — Define handlers in commands/errors/

Log Rotation

For production deployments, configure log rotation:

# /etc/logrotate.d/pytigon
/var/log/pytigon/*.log {
    daily
    rotate 30
    compress
    delaycompress
    missingok
    notifempty
}