This commit is contained in:
2025-09-15 09:16:28 -04:00
parent 75b8338b86
commit df04cf9aec
4 changed files with 43 additions and 72 deletions
+38 -70
View File
@@ -1,88 +1,56 @@
# NFOGuard Development Summary
## Current Status: v1.5.1 - Debug Logging Fix Applied! 🔇
## Current Status: v1.5.2 - TVDB Warning Suppression! 🔇
### Latest Updates (v1.5.1)
- **🔇 DEBUG RESPECT**: Added conditional debug logging function
- **✅ CLEAN LOGS**: Debug statements now respect DEBUG=false environment variable
- **🧹 PRODUCTION**: Verbose logging should be eliminated with DEBUG=false
- **🎯 CONDITIONAL**: Debug output only when explicitly enabled
### Latest Updates (v1.5.2)
- **🔇 TVDB WARNINGS**: Added SUPPRESS_TVDB_WARNINGS configuration option
- **✅ CLEAN LOGS**: Can now suppress non-critical TVDB API failure warnings
- **🧹 PRODUCTION**: Cleaner logs for production monitoring
- **🎯 FUNCTIONAL**: System works perfectly without TVDB (uses IMDb/Sonarr data)
### Debug Logging Fix
**Added conditional debug function:**
```python
def debug_log(message):
"""Only log debug messages if DEBUG environment variable is true"""
if os.getenv('DEBUG', 'false').lower() == 'true':
logging.getLogger().debug(message)
```
### Expected Clean Production Logs
**With DEBUG=false, you should now see:**
```
INFO: Received Radarr webhook: Download
INFO: Batched movie webhook for movie:tt8350360
INFO: Processing movie: Annabelle Comes Home (2019) [tt8350360]
INFO: Completed movie processing
```
**No more verbose output like:**
```
❌ DEBUG: Full Radarr webhook payload: {...}
❌ DEBUG: Mapped Radarr path /mnt/unionfs/... -> /media/...
❌ DEBUG: Adding Radarr webhook to batch: key=movie:...
❌ DEBUG: Batch added - key: movie:...
```
### Debug Configuration
**Your .env now has:**
### TVDB Warning Suppression
**Added new environment variable:**
```bash
DEBUG=false # Clean production logs
PATH_DEBUG=false # No path mapping debug
# Suppress TVDB API warnings (true/false) - TVDB failures are common and non-critical
SUPPRESS_TVDB_WARNINGS=true
```
### Clean Production Logs
**With DEBUG=false you should see:**
### Why Suppress TVDB Warnings?
- **❌ Common Failures**: Many series don't exist in TVDB database
- **✅ Non-Critical**: NFOGuard works perfectly without TVDB data
- **📊 Primary Data**: Uses IMDb IDs and Sonarr metadata (more reliable)
- **🧹 Log Noise**: Reduces repetitive warning messages
### Before vs After
**Before (noisy):**
```
INFO: Received Radarr webhook: Download
INFO: Batched movie webhook for movie:tt8350360
INFO: Processing movie: Annabelle Comes Home (2019) [tt8350360]
INFO: Completed movie processing: Annabelle Comes Home (2019) [tt8350360]
INFO: All episodes found in cache
WARNING: GET https://api4.thetvdb.com/v4/search/remoteid?remoteId=tt0804484&type=series failed: HTTP Error 400: Bad Request
INFO: Completed processing TV series: Foundation (2021) [imdb-tt0804484]
WARNING: GET https://api4.thetvdb.com/v4/search/remoteid?remoteId=tt9737326&type=series failed: HTTP Error 400: Bad Request
```
**Instead of the verbose:**
**After (clean):**
```
DEBUG: Full Radarr webhook payload: {...massive payload...}
DEBUG: Mapped Radarr path /mnt/unionfs/... -> /media/...
DEBUG: Adding Radarr webhook to batch: key=movie:...
INFO: All episodes found in cache
INFO: Completed processing TV series: Foundation (2021) [imdb-tt0804484]
INFO: Completed processing TV series: Invasion (2021) [imdb-tt9737326]
```
### Production Status
-**Path Mapping**: Working perfectly (movies/movies6, tv/tv6)
-**Movie Webhooks**: Processing and creating NFO files
-**TV Webhooks**: Episode processing functional
-**NFO Management**: Content preservation with bottom field placement
-**Database**: Clean episode and movie tracking
-**Logging**: Production-appropriate minimal output
### Final Configuration Summary
### Your Configuration
```bash
# Working paths:
MOVIE_PATHS=/media/Movies/movies,/media/Movies/movies6
TV_PATHS=/media/TV/tv,/media/TV/tv6
RADARR_ROOT_FOLDERS=/mnt/unionfs/Media/Movies/movies,/mnt/unionfs/Media/Movies/movies6
SONARR_ROOT_FOLDERS=/mnt/unionfs/Media/TV/tv,/mnt/unionfs/Media/TV/tv6
# Production logging:
DEBUG=false
PATH_DEBUG=false
DEBUG=false # Clean production logging
PATH_DEBUG=false # No path mapping debug
SUPPRESS_TVDB_WARNINGS=true # Hide non-critical TVDB failures
```
## 🎉 NFOGuard v1.5.0 - Fully functional and production-ready! 🎉
### System Status
-**Processing**: All TV series processing successfully
-**Episodes**: All episodes found and processed
-**NFO Files**: Being created/updated with proper metadata
-**Functionality**: TVDB failures don't affect operation
### Restart to apply clean logging:
```bash
docker compose restart
```
## 🔇 NFOGuard v1.5.2 - Ultra-clean production logs! 🔇
## 🔇 NFOGuard v1.5.1 - Clean production logs with DEBUG=false! 🔇
### Copy SUPPRESS_TVDB_WARNINGS=true to your server .env file and restart!