Salesforce provides a customer relationship management service and a complementary suite of enterprise applications focused on customer service, marketing automation, analytics, and application development.
Integrate Salesforce with Datadog to:
- View and parse your Salesforce user activity, platform access activity, and security logs using Datadog Log Management.
- Set monitors on events from your Salesforce Platform.
- Leverage the Datadog Security Platform to monitor and detect threats across your Salesforce Platform.
- Monitor your Salesforce API usage to ensure you are operating under API limits.
No installation is required.
To configure Salesforce to send data to Datadog, you need to have access to Salesforce Event Monitoring, enable storage on your Salesforce events, and connect your Salesforce org to Datadog.
If you are using Salesforce Shield, you have the required permissions for all events. If you do not have Shield, you need the Event Monitoring add-on.
If you plan on using the platform or real-time events, you need to set this up in the Event Manager. This step is not required for event log file events.
- Log into your Salesforce account (using the Lightning interface).
- Search for Event Manager.
- On the Event Manager page, for each event you want to crawl, click the right arrow and select Enable Storage. You do not need to Enable Streaming. The list of supported
events can be found under the Platform Events section in the Configuration tab of the Salesforce Integration tile.
Create a unique system account in your Salesforce org.
Click New Production Org or New Sandbox Org in the Configuration tab of the Salesforce Integration tile.
Set any custom tags you want to attach to these events as a comma-separated list. You can choose which events to enable.
Click Save. This prompts you to log into your Salesforce account and grant Datadog access permissions.
Once you have completed the login flow, return to the Salesforce Integration tile in Datadog. Your org includes out-of-the-box default tags.
Select the tags you want to use and click Connect.
Repeat these steps to connect your remaining organizations. You must have access to the organizations you are trying to add.
Note: A default tag is added with your Salesforce org ID, but you can edit the tags with something more meaningful to your company.
Salesforce Custom Objects can be ingested into Datadog:
- On the Salesforce integration tile, open the Custom Objects section.
- Add one or more Custom Objects, in the Salesforce API format (
CustomObject__c), separated by commas (CustomObject1__c, CustomObject2__c). - Enable or disable these Custom Objects as you would other Salesforce events.
Custom Objects are ingested as logs, based on modification date. All Custom Object logs are automatically tagged with salesforce_custom_object:true.
After some time, logs appear under the salesforce source. Salesforce writes the event log files infrequently, so it may take an hour or more for event log file-based events to appear in Datadog.
salesforce.limits.max
(gauge) | The maximum limit for this resource |
salesforce.limits.remaining
(gauge) | The remaining limit for this resource |
This integration will allow you to view logs generated from Salesforce user activity, platform access activity, and security using Datadog Log Management. For the full list of supported activity, see Real-Time Event Monitoring Data Storage and EventLogFile Events." This information can also be found on the Data Collected tab of your Salesforce Integration Tile.
The Salesforce integration does not include any service checks.
This integration does not include any events.
If you encounter an The authenticated connection does not have access error in the Configuration tab, you may be missing permissions to access requested events. You can temporarily enable admin permissions for the Datadog role in Salesforce to confirm any missing access permissions.
At a minimum, the user must have the following permissions:
- API Enabled
- View Setup and Configuration
- View Real-Time Event Monitoring Events
- View Event Log Files
- View Threat Detection Events
The user must also have read permission on any underlying event objects that are selected in the configuration.
Need help? Contact Datadog support.
Additional helpful documentation, links, and articles:
