EventTracker v8.x and above Publication Date: March 27, 2019
Abstract This guide provides instructions to configure Salesforce, to report its logs to EventTracker Enterprise. Scope The configurations detailed in this guide are consistent with EventTracker Enterprise version 9.X and later, and Salesforce Lightning Platform. Audience Administrators, who wish to monitor Salesforce using EventTracker Enterprise. The information contained in this document represents the current view of Netsurion. on the issues discussed as of the date of publication. Because Netsurion must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Netsurion, and Netsurion cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. Netsurion MAKES NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE INFORMATION IN THIS DOCUMENT. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, this paper may be freely distributed without permission from Netsurion, if its content is unaltered, nothing is added to the content and credit to Netsurion is provided. Netsurion may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Netsurion, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. The example companies, organizations, products, people and events depicted herein are fictitious. No association with any real company, organization, product, person or event is intended or should be inferred. 1
2019 Netsurion. All rights reserved. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. Table of Contents Abstract... 1 Scope... 1 Audience... 1 Overview... 4 Prerequisites... 4 Configure Salesforce to forward logs to EventTracker... 4 To configure the Salesforce to forward logs to a syslog server... 4 Creating Connected Apps... 4 To obtain a security token... 7 To configure Salesforce EventTracker Integrator... 8 EventTracker Knowledge Pack... 10 Flex Reports... 10 Alerts... 11 Knowledge Objects... 11 Import Salesforce knowledge pack into EventTracker... 11 Alerts... 12 Knowledge Objects... 13 Flex Reports... 14 Dashlets... 15 Verify Salesforce knowledge pack in EventTracker... 18 Alerts... 18 Knowledge Objects... 18 Flex Reports... 19 Dashlets... 19 Sample Dashboards... 20 2
3
Overview The Salesforce Lightning Platform delivers tools and services to automate your business processes, integrate with external applications, provide responsive layouts and more. From no-code builders to pro-code tools, the Lightning Platform's enterprise services and metadata-driven, multi-tenant cloud architecture means that you can focus on what makes your business better from the competition. EventTracker integrate and examines logs generated by Salesforce to help an administration to monitor Salesforce events. Prerequisites Administrative access to Salesforce Lightning Platform. PowerShell version 5.0 is required. Configure Salesforce to forward logs to EventTracker To configure the Salesforce to forward logs to a syslog server Creating Connected Apps In Lightning Experience, 1. Log into Salesforce. Click Settings > Setup in the upper right, next to your account name. Figure 1 4
2. Navigate to Platform Tools > Apps. Under App Manager, click New Connected App: Figure 2 3. While using Salesforce Classic, from Setup, enter Apps in the Quick Find box, then select Build > Create > Apps. Under Connected Apps, click New. 4. Enter the required basic information (Connected App Name, API Name and Contact Email). Connected App Name: Eventtracker Logger API Name: Eventtracker Logger Contact Email: (your email id) 5
Figure 3 5. Select Enable OAuth Settings under API (Enable OAuth Settings). 6. Enter your callback URL: (https://your_domain/login/callback) Example: (https://localhost/login/callback) 7. Access and manage your data (api) - Allows access to the logged-in user s account using APIs, such as REST API and Bulk API. This value also includes chatter api, which allows access to Chatter REST API resources. 8. When you are finished entering the information, click Save. You can now publish your app 9. Once your app is registered, the page will display your Consumer Key and Consumer Secret: Consumer Key: A value used by the consumer to identify itself to Salesforce, referred to as client_id 6
Consumer Secret: A secret used by the consumer to establish ownership of the consumer key, referred to as client_secret To obtain a security token Figure 4 1. In Lighting Experience. Go to Settings > My Personal Information > Reset My Security Token. Figure 5 2. Click Reset Security Token. The new security token is sent to the email address in your Salesforce personal settings. 7
Figure 6 NOTE: A new security token is emailed when password is reset, or the token can be reset separately. Once token is reset, old token cannot be used in API applications and desktop clients. To configure Salesforce EventTracker Integrator 1. Get salesforce integration from the EventTracker support. 2. Extract the salesforce_integration.zip in the folder. 3. Run SalesForce Integrator.exe with adminitrator privillage Figure 7 4. Select the location and click install to extract the files to system. 8
Figure 8 5. Fill the details in the Salesforce Integrator Form, which is shown below: Figure 9 5. Kindly fill the following details in integration form API Cliend ID is the Consumer Key we got from app creation API key is the Consumer Secret we got from app creation User name: user who privilege to view event Password: Password for the user Security code: we obtain from the previous methods 9
InstanceURL : example (https://example.my.salesforce.com) replace example.my.salesforce.com with your salesforce instance url System Name: Is the name of the system where salesforce logs will be collected under EventTracker. 6. Click OK button. 7. Once Salesforce is configured. You will get the message as shown in below image. EventTracker Knowledge Pack Figure 10 Once logs are received into EventTracker Categories, Alerts, Reports and Dashboards can be configured into EventTracker. The following Knowledge Packs are available in EventTracker to support Salesforce monitoring. Flex Reports Salesforce User Login Details This report provides information related to user login activities like (login success, failure and logout). Report Sample: Figure 11 10
Sample Log: Figure 12 Alerts Salesforce: User Login Failed - This alert is generated when user login failed events has been detected. Knowledge Objects Salesforce All Events - This knowledge object helps to analyze logs related to Salesforce Events which were generated. Import Salesforce knowledge pack into EventTracker NOTE: Import knowledge pack items in the following sequence: Alerts Knowledge Objects Flex Reports Dashboards 1. Launch EventTracker Control Panel. 11
2. Double click Export Import Utility. Figure 13 3. Click the Import tab. Alerts 1. Click Alert option, and then click the browse button. Figure 14 2. Locate Alert_ Salesforce.isalt file, and then click the Open button. 12
3. To import alerts, click the Import button. Figure 15 4. Click OK, and then click the Close button. Knowledge Objects 1. Click Knowledge objects under Admin option in the EventTracker manager page. 2. Locate the KO_ Salesforce.etko file. 3. Click the Upload option. 4. Now select all the check box and then click on Import option. Figure 16 5. Knowledge objects are now imported successfully. 13
Figure 17 6. Click OK, and then click the Close button. Flex Reports On EventTracker Control Panel, 1. Click Reports option, and select new (*.etcrx) from the option. Figure 18 2. Locate the Flex Report_ Salesforce.etcrx file and select all the check box. 14
Figure 19 3. Click the Import button to import the reports. EventTracker displays success message. 4. Click OK, and then click the Close button. Dashlets Figure 20 In EventTracker 9.0, we have added a new feature which will help to import/export of dashlet. Following is the procedure for the same: 1. Login into EventTracker Enterprise Web console. 15
Figure 21 2. Go to My Dashboard option. Figure 22 3. Click import button and select.etwd File. Figure 23 16
Figure 24 4. Click upload and select Dashboard which you want to import. Figure 25 5. Click Import button. It will upload all selected dashboards. 17
Verify Salesforce knowledge pack in EventTracker Alerts 1. In the EventTracker Enterprise web interface, click the Admin dropdown, and then click Alerts. 2. In search box, enter Salesforce and then click the Search button. EventTracker displays alert of Salesforce. Knowledge Objects Figure 26 1. In the EventTracker Enterprise web interface, click the Admin dropdown, and then click Knowledge Objects. 2. In the Knowledge Object tree, expand Salesforce group folder to view the imported Knowledge objects. Figure 27 18
Flex Reports 1. In the EventTracker Enterprise web interface, click the Reports menu, and then select Report Configuration. Figure 28 2. In Reports Configuration pane, select Defined option. 3. Click Salesforce group folder to view the imported Salesforce reports. Dashlets Figure 29 1. Logon to EventTracker Enterprise. 2. Click the Dashboard menu, and then My Dashboard. 3. Then click Customize Dashlet button and search for Salesforce 19
Figure 30 Sample Dashboards Title: Salesforce Event Details Figure 31 20
Title : Salesforce All Event Details Figure 32 Title : Salesforce User Login Details By Status Figure 33 21
Title: Salesforce User Login Details By URI Title : Salesforce User Login Details By Geo Location Figure 34 Figure 35 22