Debugging Guide

Tools and techniques for debugging Pixashot issues, including diagnostic tools, logging configuration, and troubleshooting procedures.

Diagnostic Tool

Pixashot includes a built-in diagnostic tool for troubleshooting:

# Basic usage
python diagnostic.py https://example.com

# Output includes:
# - Network requests
# - JavaScript errors
# - Resource timing
# - Memory usage
# - Screenshot result

Logging Configuration

Enable debug logging for detailed output:

# Docker deployment
docker run -e LOG_LEVEL=debug pixashot

# Environment variable
export LOG_LEVEL=debug

Browser Context Debugging

Monitor browser context status:

# Get context metrics
curl http://your-instance/health | jq '.checks.browser_context'

# Memory usage per page
curl http://your-instance/health | jq '.checks.memory_per_page_mb'

Network Analysis

Debug network-related issues:

# Watch network activity
python diagnostic.py --network-trace https://example.com

# Check proxy configuration
curl -v --proxy $PROXY_SERVER:$PROXY_PORT https://example.com

Performance Profiling

Profile performance issues:

# CPU profiling
python diagnostic.py --profile cpu https://example.com

# Memory profiling
python diagnostic.py --profile memory https://example.com

Common Debug Scenarios

Screenshot Timing

{
    "url": "https://example.com",
    "custom_js": "
        console.time('loadTime');
        await new Promise(resolve => {
            const observer = new MutationObserver(() => {
                if (document.readyState === 'complete') {
                    console.timeEnd('loadTime');
                    resolve();
                }
            });
            observer.observe(document, {subtree: true, childList: true});
        });
    "
}

Memory Leaks

# Monitor memory over time
watch -n 5 'curl -s http://your-instance/health | jq .checks.memory_usage_mb'

# Check worker recycling
curl http://your-instance/health | jq '.checks.worker_stats'

Debug Tools Reference

Next Steps

1. Review Common Issues
2. Check FAQ
3. Contact support with debug output
4. Review system metrics