Reports and statistics
Control how BotBlocker counts, dates, and keeps your traffic statistics.
The Dashboard and the Reports Dashboard tab show how much traffic arrived, how much was blocked, and where it came from. Those numbers are only useful when they read the way you expect: in your time zone, over a period that makes sense, and counted in a way you understand.
Statistics are only as long as the history behind them. A report cannot show a day that the daily cleanup has already deleted. So the report period and the retention period belong together.
BotBlocker sends a few emails of its own, for example two-factor codes and PRO license expiry warnings; those are always on. For a traffic summary in a chat app, use one of the messaging add-ons: Telegram Reports sends a weekly summary to a Telegram chat, and Pusher Digest sends it through Pusher Channels. For problems inside BotBlocker itself, such as a lost Cloud connection or a failed add-on update, watch the bell menu described in Alerts.
Reports look back over a fixed number of days
The Reports Dashboard tab on BotBlocker → Reports and the charts on the Dashboard use the Report Period:. With the default of 5 days, every total and chart covers today and the 4 days before it.
The report can only count records that still exist. The daily cleanup deletes traffic records older than the Log Retention Period: (7 days by default). If you set a report period of 30 days but keep only 7 days of records, the "30-day" report really shows 7 days. Always set the retention period to at least the report period.
Times follow your offset, not the WordPress time zone
BotBlocker uses its own time offset for reports and log times: GMT Offset for Reports:. It does not read the time zone from Settings → General in WordPress. Set it to the offset of the place where you read the reports, so "3 PM" in the log means 3 PM for you.
If your country moves the clock in summer, also turn on Adjust for Daylight Saving Time. BotBlocker then adds one hour automatically while summer time is active for your offset.
Settings
The report settings are on BotBlocker → Settings → System → UI Settings, in the Reports and Statistics group. The retention and daylight saving settings are on BotBlocker → Settings → Data → Data Log & Processing.
Reports and Statistics
Report Period:
Default: 5 days
How many days the Dashboard and the Reports Dashboard tab cover. You can choose 3, 5, 7, 10, 14, or 30 days.
- Shorter: recent activity stands out, and the charts load faster.
- Longer: you see trends, such as a slow rise in bot traffic. Raise the Log Retention Period: first, or the extra days are empty.
GMT Offset for Reports:
Default: GMT
The time offset for dates and times in reports, charts, and the log. You can choose any offset from GMT−12 to GMT+14, including half-hour and 45-minute offsets. It changes only how times are shown and how days are split in the charts. It does not move any event.
Statistics Display Mode
Default: Unique Visitors (by IP)
How the "top" lists in the reports count traffic, for example the top countries or browsers.
- Unique Visitors (by IP): each IP address counts once per item. Good for "how many different visitors came from Germany?"
- All hits: every request counts. Good for "how much load came from Germany?"
The same traffic gives very different numbers in the two modes. Pick one before you compare two periods.
Data Log and Processing
Adjust for Daylight Saving Time
Default: Off
Adds one hour to your GMT Offset for Reports: while summer time is active for that offset. BotBlocker detects this by itself, so you do not have to change the offset twice a year. Turn it on only if your region uses summer time. For example, with GMT+1 and this switch on, times show as GMT+2 in summer.
Log Retention Period:
Default: 7 days
How long raw traffic records stay before the daily cleanup deletes them. You can choose 3, 5, 7, 10, 14, or 30 days. This is the limit of what any search or report can show.
- Shorter: a smaller database and less stored visitor data.
- Longer: more history for investigations and longer reports, but a larger database. Values above 7 days create a heavy load on shared hosting.
Before the cleanup deletes records that BotBlocker judged suspicious, it copies them to a separate table for Cloud reporting. See Privacy and data for what that means for stored data.
Common problems
- The report looks shorter than the period I chose. The retention period is shorter than the report period. Raise Log Retention Period:; the extra days fill up over time.
- Times are one hour off. Check Adjust for Daylight Saving Time. If it is on and your region has no summer time, turn it off.
- Times are several hours off. Set GMT Offset for Reports:. BotBlocker does not use the WordPress time zone setting.
- The totals changed but the traffic did not. Someone changed Statistics Display Mode.