Salesforce Monitoring

You can monitor Salesforce usage by user type (Lightning Experience, Salesforce mobile) or by browser type. You can also gather information about organizational limits, instance event status, and license details.

Requirements

• You must be an administrator of an active Salesforce account.
• Install the Salesforce LogicModules.

Configuring Salesforce

Before adding a new Salesforce SaaS resource to LogicMonitor, you need to add a connected app, create a user profile, and create a user in your Salesforce account. By providing this information in Salesforce, you define which user is accessing the account, their permission level, and the connected app (LogicMonitor) that the user is associated with.

Adding a Connected App

Add a connected app in Salesforce to provide information about your LogicMonitor application, including API and OAuth settings. For more information, see Create a Connected App in the Salesforce documentation.

1. In Salesforce, go to Setup > Apps > App Manager.
2. Select New Connected App.
3. On the New Connected App page, enter the following:
   • Basic Information: Connected App Name, API Name, and Contact Email
   • API (Enable OAuth Settings)
     • Enable OAuth Settings
     • Callback URL: Can be any valid URL
     • Selected OAuth Scopes: Enable Manage user data via APIs (api) and Perform requests at any time (refresh_token, offline_access)
4. Select Save.
5. Navigate to Apps > Connected Apps > Manage Connected Apps.
6. Select Edit to open the new app for editing.
7. From the Connected App Edit page, go to OAuth Policies > Permitted Users and select Admin approved users are pre-authorized.
8. Select Save.
9. On the Manage Connected Apps page, select Manage Consumer Details. 
10. Retrieve the Salesforce verification email and code. After you enter the verification code in Salesforce, the Consumer Key and Consumer Secret are displayed.

Creating a User Profile

Create a new profile in Salesforce to set up user permissions and settings. When you create a new profile, you can clone an existing profile or create a new one from scratch. For more information, see Create or Clone Profiles in the Salesforce documentation.

1. In Salesforce, navigate to Setup > Users > Profiles. 
2. Click New. 
3. On the Clone Profile page, select an existing profile that’s most similar to the one that you want to create. Enter a profile name and then click Save.
4. On the Setup Profiles page, click Edit to activate the settings.
5. Navigate to Connected App Access and select the LogicMonitor app that you’re connecting.
6. Navigate to Administrative Permissions and enable Manage Users.
7. Select Save.

Creating a User

You must create a non-administrator user in Salesforce to connect to LogicMonitor. You can select an existing user or you can create a new one. For more information, see Add a Single User in the Salesforce documentation.

1. In Salesforce, go to Setup > Users > New.
2. In the New User window enter the name and email details. Then select a user profile to apply to the new user.
3. Select Save.

Adding Salesforce to LogicMonitor

Salesforce monitoring is added from the LogicMonitor Resources page. The SaaS Monitoring wizard guides you through the setup. You have the option to add new resource properties to your Salesforce instance, or to select existing properties. The wizard displays the certificate information, which can be copied and saved to a file (CRT or PEM).

1. In LogicMonitor, navigate to Resources and select Add [+].
2. From the Add Resources window, select Cloud and SaaS.
3. Navigate to the SaaS Monitoring section and select Salesforce > Add.
4. From the SaaS Monitoring wizard, enter a Name and Description for the Salesforce account. These fields determine how the resource is displayed throughout your LogicMonitor environment.
5. Enter a Parent Group to add this resource to an existing group. The default value is root.
6. Enter Properties (key-value pair) by typing a Name and Value. You can also select from a list of existing properties. Select Next.
7. On the Permissions page, enter the permissions that you collected while Adding a Connected App.
   • Username: Enter the Salesforce UserName that is associated with the administrator account.
   • Consumer Key: Enter the Salesforce Consumer Key that is associated with the connected app.
   • Certificate: Copy and paste the contents of the Certificate field into a text file, then save the file locally with a CRT (.crt) or PEM (.pem) extension.
8. Log on to your Salesforce account and navigate to the connected app that you set up while Configuring Salesforce.
   • On the Manage Connected Apps page, select Edit > API (OAuth Settings) > Use digital signatures. 
   • Select Browse to upload the CRT or PEM certificate that you created, and then save your changes.
9. In LogicMonitor, select Test Permissions to authenticate.
10. Select Add Service to add the new resource to LogicMonitor.

Salesforce LogicModules

The following modules are available for Salesforce SaaS integration. For more information, see Installing Modules and Packages.

Name	Type	Description
Salesforce_Lightning_Usage_By_App_Lightning	DataSource	Total number of Lightning Experience users. The data is calculated the next day. If there is no usage, the API doesn’t return any values.
Salesforce_Lightning_Usage_By_App_Mobile	DataSource	Total number of Lightning Experience and Salesforce Mobile users.
Salesforce_Lightning_Usage_By_Browser	DataSource	Lightning Experience usage results grouped by browser instance (Android, Chrome, Edge, Firefox, Internet Explorer, Safari, Salesforce, or Other). Metrics are available to breakdown page load times, by user, into quartiles.
Salesforce_Lightning_Usage_By_FlexiPage_Home	DataSource	Custom pages viewed most frequently in Lightning Experience.
Salesforce_Lightning_Usage_By_FlexiPage_Utility	DataSource	Custom Lightning Experience utility page metrics. The data is calculated the next day. If there is no usage, the API doesn’t return any values.
Salesforce_Lightning_Usage_By_Page_Home	DataSource	Lightning Experience usage results for home pages. Metrics are available to breakdown page load times by user into quartiles.
Salesforce_Lightning_Usage_By_Page_Setup	DataSource	Standard Lightning Experience setup page metrics. The data is calculated the next day. If there is no usage, the API doesn’t return any values.
Salesforce_Limits	DataSource	Information about organizational limits. For each limit, this resource returns the maximum allocation and the remaining allocation based on usage.
Salesforce_Status	DataSource	Overall status of Salesforce instance indicating the most severe ongoing event, and if it affects a core service: 0: "OK" 1: "INFORMATIONAL_NONCORE" 2: "INFORMATIONAL_CORE" 3: "MAINTENANCE_NONCORE" 4: "MAINTENANCE_CORE" 5: "MINOR_INCIDENT_NONCORE" 6: "MINOR_INCIDENT_CORE" 7: "MAJOR_INCIDENT_NONCORE" 8: "MAJOR_INCIDENT_CORE"
Salesforce_License_Usage	DataSource	Usage of Salesforce Licenses Purchased.