Show TOC

Procedure documentationIntegrating Cloud Services for Exception Monitoring

 

You can monitor exceptions that occur in supported cloud services in the context of an SAP-based hybrid monitoring scenario.

When you integrate a cloud service, the system automatically creates an LMDB object for the service, which allows it to be addressed as a technical system in SAP Solution Manager. SAP provides templates for integrating the following types of cloud services:

  • Dell Boomi

  • SAP Cloud for Customer

  • SAP HANA Cloud Integration

  • SAP SuccessFactors

  • SAP Sales and Operations Planning

You configure the connection between SAP Solution Manager and the cloud service in SAP Solution Manager Configuration, Managed Systems Configuration.

Cloud Service Endpoints

SAP Solution Manager can collect data from cloud services in different ways, depending on the cloud service type. For each cloud service, you define one or more endpoints for the data collection. There are three types of endpoints:

  • HTTP endpoints allow data collection through a direct connection between the SAP Solution Manager ABAP system and the cloud service URL.

    You can create HTTP endpoints for any supported cloud service.

  • E-mail endpoints allow collection of data from automated e-mails sent by the cloud service to a dedicated SAP Solution Manager inbox user. You might choose to create e-mail endpoints rather than HTTP endpoints, for example, if your Dell Boomi bandwidth cap has been exceeded and exceptions are no longer generated through direct monitoring, or if the cloud service URL cannot be accessed from your SAP Solution Manager system for some reason.

    You can create e-mail endpoints for Dell Boomi and SAP SuccessFactors cloud services.

  • (S)FTP endpoints allow collection of data from a remote SFTP server by a diagnostics agent running on the SAP Solution Manager host.

    You can create (S)FTP endpoints for SAP SuccessFactors cloud services.

Overview of Steps
  1. Define a monitoring concept and collect the technical information for the connection.

  2. For HTTP endpoints, import the SSL certificates into the SAP Solution Manager trust store.

  3. For e-mail endpoints, create dedicated SAP Solution Manager inbox users.

  4. In SAP Solution Manager Configuration, Managed Systems Configuration, create the connection to the cloud service.

  5. Configure the endpoints according to your concept.

  6. For HTTP and e-mail endpoints, configure the data collection in Exception Management.

  7. Configure an Interface and Connection Monitoring scenario that includes the cloud service.

Prerequisites

  • The cloud service provider has set up your test and production cloud services.

  • For e-mail endpoints, SAP Solution Manager must be set up to send and receive e-mail via SMTP. For more information, see SAP Note 455140Information published on SAP site.

  • For remote file monitoring via SFTP, the diagnostics agent must be connected to SAP Solution Manager and running. The network ports (firewall) must be open so that the agent can access the SFTP server located in the cloud.

  • You are authorized to perform the Managed Systems Configuration for cloud services, the Exception Management configuration, and the Interface and Connection monitoring configuration.

Procedure

Collecting Technical Information for the Connection

Collect technical information about the cloud service from the responsible people in your organization. Make sure that you collect data for both the test and production cloud services.

Determine which endpoints you have to create depending on your use case. Use the following check list to collect the required information to set up the connection:

Endpoint Type

Required Information

All

Root URL for the cloud service

Tenant or Account ID

HTTP endpoint

User

Password

If applicable: Proxy server URL, user and password

E-Mail endpoint

Inbox user name (See Creating Dedicated SAP Solution Manager Inbox Users for Cloud Service E-Mail below.)

Optional: Sender email address. If you plan to use a single SAP Solution Manager inbox for multiple cloud services, then you need to specify the cloud service provider's e-mail address. If you plan to create a dedicated SAP Solution Manager inbox for each cloud service (recommended), then the sender's e-mail address is not required.

(S)FTP endpoint

User

Password

Protocol (FTP or SFTP)

Host name and port of the cloud service's (S)FTP data exchange server

Time zone of the SFTP server (The person responsible for the cloud service can check a timestamp to identify the time zone.)

Importing SSL Certificates into the SAP Solution Manager Trust Store

Perform this activity if you plan to create HTTP endpoints.

  1. Enter the access URL for the service in your browser and log in.

  2. Export the SSL certificate.

    Example Example

    In Google Chrome, do the following:

    1. Right-click on the page and choose View page info.

    2. On the Connection tab page, choose the Certificate information link.

    3. On the Details tab page, choose Copy to File to start the export wizard.

    4. Choose Base-64 encoded x.509 (.CER) and export the certificate to a file.

    End of the example.
  3. Start transaction STRUST.

  4. Double-click SSL client SSL Client (Anonymous) and import the certificate.

Creating Dedicated SAP Solution Manager Inbox Users for Cloud Service E-Mail

Perform this activity if you plan to create e-mail endpoints for SAP SuccessFactors or Dell Boomi services. You will enter this inbox user name when defining the endpoint for the cloud service configuration.

The inbox will be assigned automatically to the extractor framework user (default: SM_EFWK), which allows SAP Solution Manager to parse the content of the e-mails and generate exceptions.

  1. In transaction SU01, create a dialog or system user.

    Example Example

    For SuccessFactors BizX, enter the user name BIZX. In the Last Name and First Name fields, enter BIZX and Cloud Product Integration to identify the user later.

    End of the example.
  2. Enter the e-mail address to which the cloud service error messages are to be sent. Use the domain of the SAP system client if possible. For more information, see SAP Note 455140Information published on SAP site.

    To receive e-mails, no authorizations are required.

  3. Tell the person responsible for the cloud service to dispatch error message e-mails from the cloud service to the SAP Solution Manager inboxes.

Recommendation Recommendation

Create separate inbox users to differentiate between the test and production cloud services. If you create just one inbox, make sure you know the sender's e-mail addresses for both the test and production cloud servers.

End of the recommendation.
Creating the Connection

Perform this activity for both the test and production cloud services.

  1. In SAP Solution Manager Configuration, Managed Systems Configuration, choose the Cloud Services tab page.

  2. Choose Start of the navigation path Cloud Service Operations Next navigation step Create Cloud Service End of the navigation path.

  3. Select the cloud service type, and follow the guided procedure to create the connection.

The system automatically creates a Landscape API ID based on the cloud system type and tenant or account ID (for example, SAP_SF~<tenant>). For the monitoring configuration, this ID allows the cloud service to be addressed as a technical system in the SAP Solution Manager system landscape.

Defining the Endpoint
  1. Select the cloud service, and then choose Configure Cloud Service.

    The Cloud Service Configuration guided procedure starts.

  2. Select the tab page for the type of endpoint you want to create, and choose Add.

  3. Enter the technical information you collected, and save.

Note Note

When you configure an e-mail endpoint, the extractor framework user (default: SM_EFWK) is assigned automatically to the cloud service inbox user as a substitute.

If you receive an error message saying that the extractor framework user could not access the cloud service user inbox, it means that this automatic process failed. The following steps describe how to define the substitution manually.

  1. Log on to the SAP Solution Manager system using the credentials of the cloud service inbox user.

  2. Start the Business Workplace (transaction SBWP).

  3. In the Settings menu, choose Office Settings.

  4. On the Substitute tab page, choose the Create icon on the left side.

  5. In the Create Substitute dialog box, enter SM_EFWK as the substitute. Define a substitution period and choose the Inbox and Outbox substitution authorizations. Confirm your entries.

  6. Log on to the SAP Solution Manager system using the credentials of the extractor framework user SM_EFWK.

  7. Start the Business Workplace (transaction SBWP).

  8. In the Settings menu, choose Start of the navigation path Workflow Settings Next navigation step Maintain Substitute End of the navigation path.

  9. Select the extractor framework user SM_EFWK and choose the Create substitute icon.

  10. Search for the cloud service inbox user you created (BIZX, for example), and confirm.

  11. Enter a validity period, choose the Substitution active check box, and confirm.

E-mails in the cloud service inbox will now be dispatched to the extractor framework user (SM_EFWK) inbox.

End of the note.
Configuring Monitoring in Exception Management

For HTTP and E-mail endpoints, perform this activity to configure and activate exception monitoring. This activity is not relevant for (S)FTP endpoints.

  1. Navigate to the Configure Monitoring step of the Cloud Service Configuration guided procedure.

  2. In edit mode, select the hyperlink in the Navigation column for the Exception Management Configuration.

  3. On the Exceptions Sources tab page, choose Configure Log Store.

    The available log stores for the service type are displayed.

  4. Choose a log store and select the corresponding endpoint.

  5. Save your entries.

    Recommendation Recommendation

    For HTTP endpoints, specify selection filters for each log store in order to limit data extraction to business-critical exceptions, to improve performance and avoid exceeding cloud service bandwidth caps.

    End of the recommendation.
  6. Add and configure additional log stores if desired.

  7. Save your entries.

  8. To verify that exceptions are being collected, check the Exception Management cockpit in the Root Cause Analysis work center.

Configuring an Interface and Connection Monitoring Scenario
  1. Navigate to the Configure Monitoring step of the Cloud Service Configuration guided procedure.

  2. In edit mode, select the hyperlink in the Navigation column for the Integration Monitoring Configuration.

    You jump to the Interfaces and Connections monitoring configuration in SAP Solution Manager Configuration.

  3. Configure monitoring as described in Configuring an Interface and Connection Monitoring Scenario.