SAP Marketing Cloud

Available Monitoring Content

The following monitoring content is available for SAP Marketing Cloud:

CategoryTypeDescription
AIF MessagesMessagesMonitors messages sent in the SAP Application Interface Framework
Marketing Data Import (asynchronous)ExceptionsExceptions during the marketing data import
ABAP Gateway ErrorsExceptionsExceptions in the ABAP gateway

Setup Steps in SAP Marketing Cloud

Enable Monitoring Data PUSH to SAP Cloud ALM

Perform the following steps to enable SAP Marketing Cloud to send monitoring data to SAP Cloud ALM.

Prerequisites:

  • You need an user with administrator authorizations in SAP Marketing Cloud
  • You need to obtain the SAP Cloud ALM Service Key to connect to the SAP Cloud ALM system
    • Endpoint: the host part of the parameter "Api", e.g. eu10.alm.cloud.sap
    • OAuth URL: Service Key parameter "url" + /oauth/token, e.g. calm-tenant.authentication.eu10.hana.ondemand.com/oauth/token
    • Client ID: Service key parameter "clientid"
    • Client secret: Service key parameter "clientsecret"
  1. Log on to SAP Marketing Cloud
  2. Navigate back to the 'Communication Management' view and select 'Communication Arrangements'
  3. Click the New button to create a new Communication Arrangement
  4. Scenario: Select SAP_COM_0527 'Application Monitoring Push Integration'
  5. Click the New button next to 'Communication System' to create a new communication system
    1. Enter a System ID and description and click the Create button
    2. Enter the Cloud ALM endpoint URL in the 'Host Name' field
    3. Make sure the 'Port' is set to 443
    4. Under 'OAuth 2.0 Settings' enter the Cloud ALM OAuth URL in the field 'Token Endpoint'
    5. Under 'Users for Outbound Communication' click the + button to create a new user
      1. Authentication Method: Choose OAuth 2.0
      2. OAuth 2.0 Client ID: Enter Cloud ALM client ID
      3. Client Secret: Enter Cloud ALM client secret
    6. Save the communication system. The UI will take you back to the communication arrangement
  6. Enter an 'X' in 'Collect Integration Monitoring' if the field is empty. Do not change any of the other fields.
  7. The 'Outbound Communication' fields are automatically propagated from the communication system
  8. Under 'Outbound Services' enter a '/' in the field 'Path'. This will trigger the propagation of the fields below when you save the communication arrangement
  9. Adjust the Job Execution Details to schedule the job to Run Every 01 Minute(s)
  10. Save

Setup Steps in SAP Cloud ALM

Activate Monitoring (Standard)

For managed services using PUSH data collection the standard monitoring content is automatically activated during the setup of the PUSH monitoring in the managed service. No further setup steps are necessary. You can check the successful activation in the Integration & Exception Monitoring application.

  1. Open the Integration & Exception Monitoring application from the launchpad
  2. Open the scope selection via the target icon in the upper right corner
  3. Select your cloud service in the scope
  4. Click the rack-wheel icon in the upper right corner to access the configuration
  5. Expand the Configuration panel
  6. The activation status for your SAP Marketing Cloud service should already be set to ON

For SAP Marketing Cloud the exception categories are turned OFF in the standard content. You can activate them in the expert setup (see below)

Adjust Monitoring and Alerting (Expert)

You can change which parts of the standard content are activated for each cloud service, activate and deactivate alerts or create own alerts with specific filters. 

  1. In the configuration panel, click on the name of the cloud service
  2. The "Configuration of Services" screen opens
  3. In the "Configuration for Services" screen, click the > button at the end of the line for the cloud service you want to change

Adjust Monitoring Categories

  1. Use the toggle button in the column Active to turn a monitoring category ON or OFF

Adjust Alerting

  1. Use the toggle button in the column Active to turn a standard alert ON or OFF
  2. Press the > button at the end of the line to access the detail setup for an existing alert or use the + button to create a new alert
  3. Adjust the display name if desired
  4. Expand the Filter Configuration tray
  5. Enter a filter name
  6. Select the filter category
  7. Maintain the available filter fields (see details below)

Available Alerts for SAP Marketing Cloud

  • Erroneous Message(AIF) Detected: Creates an alert for each failed message in the category AIF Messages
  • Erroneous Messages(AIF) Detected: Creates an alert if one or more failed messages in the category AIF Messages were detected since the last data collection

Available Filter Fields for SAP Marketing Cloud

The filter fields depend on the monitoring category the alert is created for and additional on the filter category, if there is more than one available.

For AIF message alerts different filter categories are available. 

  1. Select the filter category from the drop-down 'Categories'
  2. Maintain the filter parameters

The following AIF-related filter parameters are always available:

  • Direction: Choose INBOUND or OUTBOUND
  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Version: AIF interface version
  • Status: The last status of the message, e.g. TECHNICAL ERROR
  • Status Group: The status group of the message, please select a value from the input help

Additional filter parameters are available depending on the selected alert category:

AIF Messages - bgRFC(queue)

  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF Messages - bgRFC(trans)

  • RFC Destination: RFC destination name
  • Transaction Code: The name of the SAP transaction code with which the unit was created
  • Program: Tcode/program with which the unit was created
  • User: The name of the user under which the unit is recorded

AIF Messages - IDOC

  • Sender port: Partner port (relevant for inbound IDocs)
  • Receiver port: Partner port (relevant for outbound IDocs)
  • Message Type: IDoc Message type, e.g. ORDERS

AIF Messages - XI-runtime

  • Sender namespace: The namespace of the source of the message
  • Sender interface: The interface of the source of the message
  • Sender party: The communication party of the source of the message
  • Sender component: The component of the source of the message
  • Receiver namespace: The namespace of the target of the message
  • Receiver interface: The interface of the target of the message
  • Receiver party: The communication party of the target of the message
  • Receiver component: The component of the target of the message

AIF Messages - qRFC

  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF Messages - tRFC

  • RFC Destination: The name of the RFC destination the tRFC is sent over
  • Function Module: The name on the called function module
  • User: The user in the RFC destination

AIF Messages - WS-runtime

  • Adapter Type: The adapter used for the WS. Please use the input help to select an adapter.
  • Sender Party: Sender Communication party
  • Sender Interface Name: Sender Interface
  • Receiver Party: Receiver Communication party
  • Receiver Interface Name: Receiver Interface

AIF Messages - XML

  • No additional filters

AIF Messages - Sync Log

  • No additional filters