marketplaceVersión de la integración1.0.1
To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.
To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.
Box Integration Overview Dashboard - Overview
Box Integration Overview Dashboard - Users
Box Integration Overview Dashboard - Storage
Box Integration Overview Dashboard - Logs
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.
Data Collected
Metrics
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
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.
