Skip to content

Feature Logs and Cache

github-actions[bot] edited this page Mar 15, 2026 · 4 revisions

📋 Logs & Cache

Every operation in Music Tagger is transparent and auditable through the structured log viewer and cache browser.

Log Viewer

What is Logged

Event Type Examples
Scraping Job start/finish, source responses, failures
Metadata Writes Field changes, bulk updates, reverts
File Events Scans, missing file detections, path repairs
System Worker status, container health, config changes

Log Levels

DEBUGINFOWARNINGERROR — filterable in the UI.

Screenshots

Operation Logs Log Detail
Logs Log Detail

📸 [Log viewer screenshot — coming soon]

Cache Browser

The cache browser gives you full visibility into what has been fetched from external metadata sources.

Features

  • Browse entries by source, track, or fetch date.
  • Inspect raw responses for any cached result.
  • Invalidate individually — force a single track to be re-fetched next run.
  • Bulk clear — reset all cache for a specific source or time range.

Screenshots

Cache Browser

Cache Browser

📸 [Cache browser screenshot — coming soon]

Log Retention

Logs are stored in the database and pruned on a configurable schedule. Default retention is 30 days. Adjust via the LOG_RETENTION_DAYS environment variable.

Clone this wiki locally