Box

Supported OS Linux Windows Mac OS

marketplace
Integration version1.0.1

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

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

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:


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

PREVIEWING: may/embedded-workflows