Freedomification Plugins Log Viewer PRO — Documentation

7. Reports

Reports provide a broader view of log activity over time. They are most useful after PRO has collected activity for a while.

Reports overview

Figure 7A. Reports overview — choose a date range, review total events, peak days, unique signatures and the events-per-day chart.

Logs participating in the report

Figure 7B. Participating logs — switch between Cards, List and RAW views, filter by severity/custom hits, review per-log totals, trend badges and open Full info when needed.

You can review

• total events,
• peak days,
• activity trends,
• daily breakdowns,
• per-log summaries,
• critical, error, warning and custom activity,
• filtered views of report data.

Basic steps

1. Open Reports.
2. Choose a range such as today, yesterday, last 7 days or a custom range.
3. Apply filters if needed.
4. Click into a day or log for more detail.
5. Use Cards, List or RAW depending on how much detail you need.

Reports settings

Reports settings control collection, display defaults, retention and cleanup tools.

• Enable Reports collects and shows aggregated report data.
• CRON scan for Reports allows CRON scans to ingest report data independently of email/webhook alerts.
• Reports troubleshooting log writes extra diagnostics to wp-content/lv-alerts.log; disable it after troubleshooting.
• Include archived/removed/muted logs by default shows those logs in Reports unless filters hide them.
• Default filter: Has CUSTOM opens Reports focused on logs with custom phrase hits.
• Show full original log line keeps the full sample line in report details instead of a shortened label.
• Reports dedupe TTL prevents the same matches from being counted repeatedly on every CRON tick.
• Top items limit controls how many top logs or phrases are stored per day.
• Retention controls how long report data is kept before cleanup.
• Default range controls the initial number of days loaded when opening Reports.
• Per-log order can sort logs by event count or by the current Log Viewer order.
• Hide logs inactive for more than keeps inactive logs out of per-log lists while preserving charts and history.
• Trend calculation controls how the ▲/▼ trend badge is calculated.

Reports vs Log Hub visibility

Reports and Log Hub answer different questions:

• Log Hub shows the current live/tail analysis of selected logs. It can hide entries because of tail size, time window, filters, mute rules or ignore rules.
• Reports stores aggregated historical activity in database tables while Reports collection is enabled.
• Default range controls what range opens first in Reports; it does not delete data. In the current code it is clamped to 1–30 days.
• Retention controls how long historical report data is kept before cleanup removes old rows. The current default is 60 days unless changed in settings.
• Run retention cleanup now applies the retention setting immediately.

Reports cleanup tools

• Run retention cleanup now removes old report data according to the retention setting.
• Clear all report data removes all report data.
• Purge log history removes report rows for a single log_id.