The Platform Activity Report enables you to monitor on demand your organization’s consumption of platform resources. Using this report can help you:
- Verify resource consumption for yourself, saving you the time and hassle of reaching out for support from anyone at Box
- Figure out more precisely how your people are adopting Box and integrating it into their daily work routines
- Determine the growth or success of any applications your organization may have built on the Box platform
- Ascertain the overall value your Box investment is returning
- Identify your most highly-consumed integrations
- See how many custom apps are being built
The report aggregates resources from third-party integrations (such as Slack or Salesforce), and from any custom applications your organization may have developed. Providing this information increases transparency and enables you to understand how you’re using the Box ecosystem.
Understanding Platform Activity Report Data
The report displays your organization’s resource usage based on API calls. Each time someone uploads, downloads, modifies, or access a file, they generate an API call.
For technical details on how Box executes API calls, go to developer.box.com.
The report provides a range of data:
- API Calls measures the total number of API calls per day, including authorization requests and errors, for each app user or service account. This report does not include failed uploads or failed downloads. API Calls displays totals for the whole enterprise, per app.
- Monthly Active Users (MAU) provides a total of the number of active platform users (app users+service accounts) in your enterprise per calendar month. Box defines a "user" as any app user or service account who makes an API call within the reporting window.
MAU is an aggregate daily total, retroactive to the beginning of each month, and each month re-sets to 0. Here's an example: There are 100 active users on Monday, 100 on Tuesday, and 100 on Wednesday. If you generate the report on Tuesday, it reports on your Monday total, so MAU = 100. If you generate the report on Wednesday, it adds the Monday and Tuesday totals, and that sum is the value for both days, so MAU = 200 for Monday and 200 for Tuesday. If you generate the report on Thursday, it totals up your active users for all three days, so MAU = 300 for Monday, 300 for Tuesday, and 300 for Wednesday.
Finally, MAU is not broken out per individual application (Salesforce, Slack, a custom app, and so on).
- Storage measures content stored, in bytes, per app user or service account. Does not measure multiple versions of the same document; only counts the final version.
- Bandwidth measures the bandwidth, in bytes, used by the service account or user account associated with app.
- Chargeable indicates whether an application is chargeable. Chargeable apps typically are apps customers themselves have written to solve a problem unique to their installation. Customers pay specifically for these custom apps. Apps that are not chargeable are included in a customer's initial license of Box, along with a limited number of API calls.
Except for MAU, both reports also display usage broken out by application (Salesforce, Slack, Box Sync, any custom app, and so on). This helps you, for example, examine resource consumption to see how quickly your people are adopting a new Box service, or measure how many API calls a custom app is making.
Platform Activity Report Details and Data Columns
Each Platform Activity Report has the following characteristics:
- The report is generated as a comma-separated value (CSV) file.
- The file name follows this pattern:
platform_activity_run_on_yyyy-mm-dd-hh-mm-ss_Page_X.csv
- The report is paginated with each page listing 1M rows.
- A generated report in placed in the root Box Reports folder.
The reports include the following data columns:
Data Column | Description |
---|---|
Date | The date of the consumption of the Box platform resource. |
Metric |
The type of platform resource consumed. Values can be:
|
App ID | The unique identifier of the application that used the resource. |
App Name | The application that used the resource. |
Chargeable |
Whether the application is chargeable, that is, a customer application written to solve a problem unique to their installation. Such applications require additional payment by customers. Applications that are not chargeable are included in a customer's initial license of Box, along with a limited number of API calls. Values can be:
|
Value | If the value of Chargeable is Yes, the value of the consumption on the date. |