---
title: Box
description: Monitor your Box Enterprise Users and Storage
breadcrumbs: Docs > Integrations > Box
---

# Box
Supported OS marketplaceIntegration version1.0.1         Box Integration Overview Dashboard - OverviewBox Integration Overview Dashboard - UsersBox Integration Overview Dashboard - StorageBox Integration Overview Dashboard - LogsExample of the Box UI
## Overview{% #overview %}

This integration reports metrics about user storage in your [Box Enterprise Account](https://box.com/) and collects Box Admin Logs using the `admin_logs_streaming` endpoint. The following triggers are submitted to Datadog as logs:

- [User Source Object](https://developer.box.com/guides/events/event-triggers/event-source/#user-source-object)
- [Shield Events](https://developer.box.com/guides/events/event-triggers/shield-alert-events/)
- [Sign Events](https://developer.box.com/guides/events/event-triggers/sign-events/)

### Metrics{% #metrics %}

|  |
|  |
| **rapdev.box.users.count**(gauge)        | Count of users in the enterprise. |
| **rapdev.box.users.storage.max**(gauge)  | Max storage capacity of a user.   |
| **rapdev.box.users.storage.used**(gauge) | Used storage capacity of a user.  |

### Logs{% #logs %}

This integration collects Box Admin Logs using the `admin_logs_streaming` endpoint. The following triggers are submitted to Datadog as logs:

- [User Source Object](https://developer.box.com/guides/events/event-triggers/event-source/#user-source-object)

```gdscript3
{
 "source": {
   "id": 11446498,
   "type": "user",
   "address": "900 Jefferson Ave, Redwood City, CA 94063",
   "avatar_url": "https://www.box.com/api/avatar/large/181216415",
   "created_at": "2012-12-12T10:53:43-08:00",
   "job_title": "CEO",
   "language": "en",
   "login": "ceo@example.com",
   "max_upload_size": 2147483648,
   "modified_at": "2012-12-12T10:53:43-08:00",
   "name": "Aaron Levie",
   "notification_email": {
     "email": "notifications@example.com",
     "is_confirmed": true
   },
   "phone": 6509241374,
   "space_amount": 11345156112,
   "space_used": 1237009912,
   "status": "active",
   "timezone": "Africa/Bujumbura"
 }
}
```

- [Shield Events](https://developer.box.com/guides/events/event-triggers/shield-alert-events/)

```
{
 "source":null,
 "created_by":{
   "type":"user",
   "id":"2",
   "name":"Unknown User",
   "login":""
 },
 "action_by":null,
 "created_at":"2019-12-20T11:38:56-08:00",
 "event_id":"97f1b31f-f143-4777-81f8-1b557b39ca33",
 "event_type":"SHIELD_ALERT",
 "ip_address":"10.1.2.3",
 "type":"event",
 "session_id":null,
 "additional_details":{
   "..."
 }
}
```

- [Sign Events](https://developer.box.com/guides/events/event-triggers/sign-events/)

```
"additional_details": {
   "sign_request": {
       "sign_request_id": "123e4567-e89b-12d3-a456-426614174000",
       "sign_request_short_id": "426614174000",
       "status": "sent",
       "signer_ip_address": null,
       "requestor_ip_address": "",
       "files": [
           {
               "id": "1234567890",
               "type": "file",
               "name": "example_doc.pdf",
               "parent": {
                   "id": "987654321",
                   "type": "folder"
               }
           }
       ],
       "requestor": {
           "id": "13579246",
           "type": "user",
           "name": "John Doe",
           "login": "johndoe@box.com"
       },
       "signer": null,
       "template": {
           "id": "987abC5423",
           "template_type": "Signing",
           "name": "Work Contact"
       },
       "batch_send": {
           "id": "W23YVL46"
       },
       "sender_message": {
           "subject": "Can you please sign this document?",
           "message": "This document shows the terms agreed to on the phone."
       },
       "forward": null
   }
}
```

### Dashboards{% #dashboards %}

This integration provides an out-of-the-box dashboard named **Box Integration Overview**. The dashboard populates as metrics and logs are collected.

In order for the Agent to collect logs, set `logs_enabled: true` in the main `datadog.yaml` file.

## Data Collected{% #data-collected %}

### Metrics{% #metrics-1 %}

### Service Checks{% #service-checks %}

**rapdev.box.can\_connect**

Returns `CRITICAL` if the Agent is unable to connect to the Box API endpoint, otherwise returns `OK`.

*Statuses: ok, critical*

**rapdev.box.got\_bearer**

Returns `CRITICAL` if the Agent is unable to connect to the Box API and get a bearer access token, otherwise returns `OK`.

*Statuses: ok, critical*

## Support{% #support %}

For support or feature requests, contact RapDev.io through the following channels:

- Support: [support@rapdev.io](mailto:support@rapdev.io)
- Sales: [sales@rapdev.io](mailto:sales@rapdev.io)
- Chat: [rapdev.io](https://www.rapdev.io/#Get-in-touch)
- Phone: 855-857-0222

This application is made available through the Marketplace and is supported by a Datadog Technology Partner. Click Here to purchase this application.