Skip to content
AdFuzAdFuz FAQ & Docs

How to Inspect & Export File Logs

AdFuz writes structured diagnostic logs to your server’s filesystem under wp-content/uploads/ad-fuz/log/. These logs record background cron operations, MaxMind GeoLite2 database synchronizations, API requests, and critical runtime errors.

You can inspect and filter these logs directly inside WordPress Admin > AdFuz > Tools > File Logs.

File Logs Overview Interface

Section titled “File Logs Overview Interface”

When you open File Logs, you have access to:

1. Summary Metrics Bar

Section titled “1. Summary Metrics Bar”

Displays quick diagnostic stats for the selected log file:

  • Total Lines: Overall lines logged in the active file.
  • Errors 0: Count of critical and fatal error entries.
  • Warnings 0: Deprecation notices and non-blocking warnings.
  • Debug 0: Verbose debug traces and payload dumps.

2. Log File Navigator (Left Panel)

Section titled “2. Log File Navigator (Left Panel)”

Lists all log files generated by date and category:

  • geolite__YYYYMMDD.log: Tracks GeoLite2 City database downloads, extraction, and IP geo-targeting database paths.
  • default__YYYYMMDD.log: General system operations, cron job execution, ad rotation status, and cache warming.

How to Search and Filter File Logs

Section titled “How to Search and Filter File Logs”
  1. Navigate to AdFuz > Tools > File Logs in your WordPress admin menu.
  2. Select the desired log file from the Log Files list on the left (e.g., geolite__20260826.log or default__20260828.log).
  3. Use the Log Level Dropdown to filter entries:
    • All levels
    • INFO (Routine operational milestones)
    • WARNING (Non-fatal discrepancies)
    • ERROR (Failed network requests or missing files)
    • DEBUG (Detailed payload inspects)
  4. Enter a search query in the Search logs… box (e.g., GeoLite2, error, timeout).

Sample Log Structure

Section titled “Sample Log Structure”

Here is an example of an operational GeoIP log entry:

[INFO] ==================== 26/08/2026 00:29:11 (INFO) START ====================
GeoLite2 database download started.
[INFO] ==================== 26/08/2026 00:29:11 (INFO) END ====================


[INFO] ==================== 26/08/2026 00:29:15 (INFO) START ====================
Array
(
    [message] => GeoLite2 database downloaded and extracted successfully.
    [mmdb_path] => D:\localserver\ad-fuz\wordpress\wp-content\uploads\ad-fuz\geolite-db\GeoLite2-City.mmdb
)
[INFO] ==================== 26/08/2026 00:29:15 (INFO) END ====================

Exporting Logs for Support

Section titled “Exporting Logs for Support”

If our support engineering team requests your system log file:

  1. Open the relevant file in the File Logs viewer.
  2. Click the green Export Log button in the top right corner.
  3. Your browser will download the raw .log text file. Attach this file to your support ticket.