Business, Business Plus, and Enterprise admins can monitor activity and view data about their Box accounts and the content owned by their accounts by generating reports in the Admin Console. Reports can be generated on-demand for any specified time period and these reports can go back as far as 7 years, or as long as you have an account tariff with reporting access.
Both admins and co-admins can run and filter reports, depending on permission settings:
- The primary admin can run reports and filter by any group or user type (managed, unmanaged, admin, co-admin).
- Any co-admin who has permission to Run new reports and access existing reports (marked in orange below) can run the usage logs that are date bound (without selecting a user or group).
- A co-admin who has permission to Run new reports and access existing reports (marked in orange below) and permission to Manage groups (marked in green below) can run a usage log by groups.
- A co-admin who has reporting permissions can run a usage log by user.
Running a report involves configuring a report's settings and then running the report, which will be saved in your Box Reports folder. You can also:
- Schedule a report to run repeatedly on a cadence you define
- Save a report configuration and run the configured report with just a couple of clicks
- Subscribe managed users in your enterprise to reports
See Report Configuration Capabilities for details.
From the Create Report tab you can run the following reports:
- Box Sign
- Classification
- Collaborations
- Folders & Files
- Legal Holds
- Platform Activity
- Outbound Collaboration
- Retention
- Security Logs
- Shared Links
- User Detail
- User Activity
- User Statistics
To run any report except Geographic Activity, Legal Holds, or Retention:
- Go to Admin Console > Reports.
- Click Create Report.
- Select any report type except Legal Holds or Retention.
- Click Next.
- In the Run [Report Name] dialog box or the report Step 2 page, configure the report and set a start and end date for the report data, if available. See the page for each report type (links above) for details about what you can configure for each report.
- In the Add Subscribers To Report field, optionally enter one or more user names (or managed users) or user groups. See Subscribing Users to Reports for details.
- Click Run.
To run a Geographic Activity report:
- Go to Admin Console > Insights.
- In the Geographic Activity section, click the down arrow (
) at the top-right of the map.
- Click Run.
To run a Legal Holds or Retention report:
- Go to Admin Console > Reports.
- Click Create Report.
- Select a egal Holds or Retention report type.
- Click Next. You will be taken to the page where your existing Legal Hold or Retention policies are listed.
- Hover your mouse cursor over the policy you want a report for and click Report.
- Click Generate.
To run a report that can be scheduled and its configuration saved:
Note
Legal Holds and Retention are not run from Reports and cannot currently be scheduled or have a configuration that can be saved.
- Go to Admin Console > Reports.
- Click Create Report.
- Select the type of report you want to run.
- Click Next.
- In the Run [Report Name] dialog box or the report Step 2 page, configure the report, and set a start and end date for the report data, if available. See the page for each report type (links above) for details about what you can configure for each report.
- Optionally save the report setting configuration or schedule the report.
- In the Add Subscribers To Report field, optionally enter one or more user names (or managed users) or user groups. See Subscribing Users to Reports for details.
- Click Run.
To run a saved report:
- Go to Admin Console > Reports.
- Click the Saved Reports tab.
- Hover the cursor over the saved report configuration, click the 3-dot button (
), and then click Run.
Notes:
- Reports can take several minutes to up to 12 hours to generate, depending on the size of the data set. However, for particularly large data sets, it can take longer.
- If the status of your report does not update in 24 hours, or has been in a Pending status for 24 hours, please contact Product Support.
- For most reports, data is available for up to 24 hours before the time that the report is run. For the User Details report, data is available for up to 1 hour before the time that the report is run.
- A single report file can contain up to 1 million rows of data. If a report generates more than a million rows of data, the report will be broken up into multiple files with the same name except for the
_Page_#at the end of the filename. Note that if a report is broken up into multiple files, the pagination in the filename determines the order of the data, not the order in which the files were completed and uploaded to the Reports folder. - Some reports include date and time data. Times in reports include a time zone, and the time zone in a report can be in either Universal Time (UTC) or local time, where "local" is defined at the time zone of the admin who ran the report or who set up the report schedule. See the topic about each report to see which time zone that report uses and see Dates and Times in Report Data for additional information.