Generate Reports

You can generate custom reports about solved CAPTCHA events from the Customized Reports view. You can also export reports as CSV files or schedule them to send to specific emails so you can automate reports.

Prerequisites

To create new reports, you need at least an Analyst role in Bot Defender. See Role permissions for more information.

Reports Limitations

  • All BQ requests limit is 100K records.
  • Accounts can have up to 5 scheduled reports.
  • Of the scheduled reports, accounts can have up to 2 monthly reports.
  • If the first or second Group By field is anything other than Browser, Country, or Domain, the time period cannot be more than 24 hours. If you require a larger time period, you must set a scheduled report.

Create a report

  1. Navigate to Explore > Reports > Custom Reports.
  2. Click + Create new report.
  3. Complete the following fields:
    • Report Name: The name of your report.
    • Report Data Source: The applications you want to create the report from. You can select as many applications as you want.
    • Report Data: Event data that you want to include in the report.
    • Report Structure: The data type and order you want to sort the report by.
  4. Click Save changes.

Your report will appear in your Reports view.

Scheduled Reports

Reports can be generated and emailed periodically to specified recipients. All data generated within the configured time range is included in the report. Reports can include information from multiple applications.

960

To configure a new scheduled report:

  1. In Reports, click Schedule.
  2. Enter the following details into the Schedule Periodic Reports popup:
FieldDescription
Report NameThe logical name of the scheduled report. For example, Company’s Monthly Report.
Send ToThe email addresses that the scheduled report is sent to.
Report PeriodThe interval at which the scheduled report will be sent.
  • Daily - the report is generated daily at the Hour specified (UTC).
  • Weekly - the report is generated for the previous 7 days, up to Sunday at 23:59 UTC.
  • Monthly - the report is generated on the first day of each month up to 23:59 UTC of the previous month.
Hour (UTC)The hour that the report is generated.
ApplicationsThe applications for which the report is generated. Only relevant applications are displayed.
SourcesThe sources of the data generated in the report.
  • JS Sensor
  • Enforcer
ActionsThe activities received from the web sensor (JS Sensor or Enforcer).
  • Blocked
  • None
The actions selected are dependent on which Sources are selected. For example, selecting JS Sensor and Blocked returns an empty report, as the JS Sensor does not block traffic.
Group ByGroups the data according to the selected Field types. You must specify at least one Group By field.
Sort ByThe tag used to sort the report data. Select Ascending or Descending.
ScoreThe Min. Score.

A list of scheduled reports is displayed in Platform Settings > Accounts, under the list of applications for the selected account.

To edit or delete a report, click on the three dots (...) at the right of the row and select Edit or Delete.