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

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 Marketplace and is supported by a Datadog Technology Partner. Click Here to purchase this application.

PREVIEWING: may/unit-testing