How Can I Monitor My Project Using Salesforce? (Magic xpi 4.6)

The Magic xpi Force.com monitoring utility gives you a high level view of the health of your Magic xpi clusters.

You can monitor your Magic xpi environments, view running projects, receive alerts, and get chatter notification about various events. This topic explains how to set up and use the monitoring utility.

To set up the Salesforce monitoring utility:

1. Install the Magic xpi app from the Salesforce AppExchange. For information about how to do this, click here.

2. In the Magic xpi installation folder, open the SFDC_Monitor_Utility folder and double-click the SFDC_MonitorSetup.exe file. The Salesforce Monitor Configuration dialog box opens. This dialog box contains the following properties:

3. Once you have entered the required parameters, you need to complete the OAuth authorization flow. To do this, click the OAuth2 button.

4. In the OAuth2View window, enter your Salesforce credentials. Once your credentials are accepted, a green check mark will appear next to the Salesforce Monitor Configuration dialog box’s OAuth Refresh Token Status field.

5. Click the Validate button to verify the connection to Salesforce.

To use the Salesforce monitoring utility:

1. Run your Magic xpi project.

2. In the Magic xpi installation folder, open the SFDC_Monitor_Utility folder and double-click the start.bat file. This starts the runtime utility that pushes Magic xpi project data to Salesforce. If you want to run the utility as a Windows OS service, you first need to run the SFDCserviceInstall.bat file, located in the <Magic xpi installation>\SFDC_Monitor_Utility\OS_Service folder. This will create an MgcxpiSFDCUtil service that you can then set to run either manually or automatically.

3. Log in to https://login.salesforce.com with your credentials.

4. Click the Environments tab. If this tab is not available, you can add it. To do this, go to the App Setup area, click on Create, and then select Tabs.

5. In the Recent Environments area, under Environment Name, you should see the name of the environment that you created in the setup procedure (above).

6. Click on the environment name link to see the monitoring information.

7. The Environment Detail screen displays information such as the environment’s name and status, and also shows the following data in dedicated sections:

8. In the Projects section of the Environment Detail screen, you can click on a specific project name to get the following information:

You can change the refresh rate of the Salesforce monitoring utility as follows:

1. Click the Magic xpi Settings tab.

2. In the Magic xpi Configuration screen, click Edit.

3. Set the Interval (minutes) property to the required refresh rate.

4. Click Save.