57 lines
2.1 KiB
Markdown
57 lines
2.1 KiB
Markdown
# NFOGuard Development Summary
|
||
|
||
## Current Status: v1.4.6 - Flexible Debug Controls! �️
|
||
|
||
### Latest Updates (v1.4.6)
|
||
- **🎛️ FLEXIBLE DEBUGGING**: Added `PATH_DEBUG` environment variable for path mapping debug control
|
||
- **🧹 PRODUCTION READY**: Can now disable path debug while keeping general logging
|
||
- **⚙️ GRANULAR CONTROL**: Separate debug controls for different system components
|
||
- **✅ CONFIGURABLE**: Debug output now completely controllable via .env settings
|
||
|
||
### New Debug Control System
|
||
```bash
|
||
# General application debugging (webhooks, processing, etc.)
|
||
DEBUG=true
|
||
|
||
# Path mapping debugging (verbose path translation output)
|
||
PATH_DEBUG=false
|
||
```
|
||
|
||
### Debug Output Examples
|
||
|
||
**With PATH_DEBUG=false (Production):**
|
||
```
|
||
INFO: Received Radarr webhook: Download
|
||
INFO: Batched movie webhook for movie:tt3322940
|
||
INFO: Processing movie: Annabelle (2014) [tt3322940]
|
||
INFO: Completed processing movie: Annabelle (2014) [tt3322940]
|
||
```
|
||
|
||
**With PATH_DEBUG=true (Troubleshooting):**
|
||
```
|
||
PATH_DEBUG: PathMapper initialized with:
|
||
PATH_DEBUG: radarr_roots: ['/mnt/unionfs/Media/Movies/movies', '/mnt/unionfs/Media/Movies/movies6']
|
||
PATH_DEBUG: radarr_path_to_container_path input: /mnt/unionfs/Media/Movies/movies6/Annabelle...
|
||
PATH_DEBUG: Checking radarr_root[1]: /mnt/unionfs/Media/Movies/movies6
|
||
PATH_DEBUG: Match found! Index 1
|
||
PATH_DEBUG: Mapped to: /media/Movies/movies6/Annabelle (2014) [tt3322940]
|
||
```
|
||
|
||
### Recommended Production Settings
|
||
```bash
|
||
# Optimal for production monitoring:
|
||
DEBUG=true # Keep application logging for monitoring
|
||
PATH_DEBUG=false # Disable verbose path mapping output
|
||
|
||
# Minimal logging for high-performance:
|
||
DEBUG=false # Disable all debug output
|
||
PATH_DEBUG=false # Disable path mapping debug
|
||
```
|
||
|
||
### Debug Scenarios
|
||
- **✅ Production**: `DEBUG=true, PATH_DEBUG=false` - Monitor without noise
|
||
- **🔧 Troubleshooting**: `DEBUG=true, PATH_DEBUG=true` - Full diagnostics
|
||
- **🚀 High Performance**: `DEBUG=false, PATH_DEBUG=false` - Minimal logging
|
||
- **🎯 Path Issues**: `DEBUG=false, PATH_DEBUG=true` - Focus on path mapping only
|
||
|
||
## 🎛️ NFOGuard now offers complete control over debug output levels! 🎛️ |