Configure inputs for the Splunk Add-on for Box
To configure inputs for the Splunk Add-on for Box, complete these steps:
- On Splunk Web, go to the Splunk Add-on for Box, either by clicking the name of this add-on on the left navigation banner or by going to Manage Apps, then clicking Launch App in the row for the Splunk Add-on for Box.
- Click the Inputs tab.
- Click Create new input.
- Fill in the required fields:
Field Description Name A name for the new input Box account The Box account with permissions for the input. Ensure you have set up the add-on to work with this Box account. Endpoint The Box API endpoint relevant for collecting data for a given metric. Do not alter this value. The Splunk Add-on for Box provides four Endpoints — events, folders, users, and groups — which correspond to the four endpoints of the Box REST API: Metric Description events Box enterprise events folders Metadata about files and folders, collaboration data for folders, file tasks and comments information. If you unchecked any of the boxes in the Box Data Collection Setup section when you set up the add-on, the corresponding data is excluded from collection. users User data groups User group data Collect since timestamp The date and time, after converting to UTC in
YYYY-MM-DDThh:mm:ssformat, after which to collect data. Default: last 90 days. Only compatible with the
Interval How often, in seconds, the Splunk platform calls the API to collect data for a metric. This value overrides the configuration of the default collection interval in the setup screen. Set to 120 seconds or above to avoid rate limiting errors. Delay (Optional) Delay (measured in seconds) to be subtracted while scanning events from Box. The value should be strictly less than Interval. This Delay will be deducted from
created_afterBox Event API parameters while fetching events from Box. Default is 0.
Set the value to non-zero if events are missed from your Box account.
Only valid for the events metric.
The delay will be deducted from "Collect since timestamp" due to product vendor behavior. See the ''Troubleshooting'' topic in this manual for more information.
Index The index in which the Splunk platform stores events from Box. The default is main.
When you enable the Events input for the first time, the add-on collects historical enterprise event data for the past 90 days by default, or starts collection at a different time based on what you configured on the setup page. The add-on collects this data at a maximum rate of 500 records at a time using a collection interval (defaults is 120 seconds) until it catches up to the present. All event timestamps reflect the local timezone of your data collection node, which may differ from the timezone applied in Box.
- Once you are satisfied with the configurations, click Enable next to the metrics you want to enable.
If the Splunk Add-on for Box finds an existing checkpoint for a given input name, a Use existing data input dialogue box appears. If you select Yes, then data is collected from that checkpoint. If you select No, then data collection resets. It begins from the query start date you provided, or from the default start date. This option will only appear when editing inputs containing the
Set up the Splunk Add-on for Box
Troubleshoot the Splunk Add-on for Box
This documentation applies to the following versions of Splunk® Supported Add-ons: released