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.
- You must be an administrator of an active Salesforce account.
- Install the Salesforce LogicModules.
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.
- In Salesforce, go to Setup > Apps > App Manager.
- Select New Connected App.
- 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)
- Select Save.
- Navigate to Apps > Connected Apps > Manage Connected Apps.
- Select Edit to open the new app for editing.
- From the Connected App Edit page, go to OAuth Policies > Permitted Users and select Admin approved users are pre-authorized.
- Select Save.
- On the Manage Connected Apps page, select Manage Consumer Details.
- Retrieve the Salesforce verification email and code. After you enter the verification code in Salesforce, the Consumer Key and Consumer Secret are displayed.
Important: Copy the Consumer Key and Consumer Secret and save them to a secure location. This information is not retrievable after you leave this page. The Consumer Key is required when Adding Salesforce to Monitoring.
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.
- In Salesforce, navigate to Setup > Users > Profiles.
- Click New.
- 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.
- On the Setup Profiles page, click Edit to activate the settings.
- Navigate to Connected App Access and select the LogicMonitor app that you’re connecting.
- Navigate to Administrative Permissions and enable Manage Users.
- Select Save.
Note: The Manage Users permission is required for monitoring storage limit usage. For more information, refer to the Salesforce REST API Developer Guide for Limits.
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.
- In Salesforce, go to Setup > Users > New.
- In the New User window enter the name and email details. Then select a user profile to apply to the new user.
- Select Save.
Note: To edit the user, navigate to Setup > Users, select the drop-down arrow, and then select Edit User.
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).
- In LogicMonitor, navigate to Resources and select Add [+].
- From the Add Resources window, select Cloud and SaaS.
- Navigate to the SaaS Monitoring section and select Salesforce > Add.
- 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.
- Enter a Parent Group to add this resource to an existing group. The default value is root.
- Enter Properties (key-value pair) by typing a Name and Value. You can also select from a list of existing properties. Select Next.
- 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.
- 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.
- In LogicMonitor, select Test Permissions to authenticate.
- Select Add Service to add the new resource to LogicMonitor.
|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:|
|Salesforce_License_Usage||DataSource||Usage of Salesforce Licenses Purchased.|