Box

Supported OS Linux Windows Mac OS

marketplace
Box Integration Overview Dashboard - Overview
Box Integration Overview Dashboard - Users
Box Integration Overview Dashboard - Storage
Box Integration Overview Dashboard - Logs
Example of the Box UI
This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Overview

This integration reports metrics about user storage in your Box Enterprise Account and collects Box Admin Logs using the admin_logs_streaming endpoint. The following triggers are submitted to Datadog as logs:

Metrics

This integration collects storage metrics about users in your Box enterprise account. The following metrics are submitted:

rapdev.box.users.count
rapdev.box.users.storage.max
rapdev.box.users.storage.used

Logs

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

{
 "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"
 }
}

{
 "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":{
   "..."
 }
}

"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

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.

Support

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

Made with ❤️ in Boston This isn’t the integration you’re looking for? Missing a critical feature for your organization? Drop RapDev a note, and we’ll build it!!

This application is made available through the Datadog Marketplace and is supported by a Datadog Technology Partner. To use it, purchase this application in the Marketplace.