The following video demonstrates the setup steps to set up Integration & Exception Monitoring for SAP Fieldglass.

A textual step by step description for all setup steps is provided in the sections below the videos.

To connect to Fieldglass via the API you need two pieces of information to process data: an application key and an active web service (username/password).

1. Prerequisites: You need a user with Fieldglass Configuration Manager access to perform the following configuration. Please contact the Fieldglass administrator in your organization for details.
2. Follow the SAP Help documentation to create a new API Application Key and the corresponding web service

• The API Application Key itself
• The Web Service information:
  • The Virtual Person Name used as the Client ID in SAP Cloud ALM
  • The License Key used as the Client Secret phrase in SAP Cloud ALM

Please do not use the Client ID and the Client Secret provided in the API Application Key application. They are not applicable for SAP Cloud ALM end-points.

If you already have an API Application Key for SAP Cloud ALM follow the SAP documentation to retrieve existing API Application Key information. 

Remark: In rare cases no user on customer side has access to the API Application Key application. In these cases please open an incident with SAP on component BNS-FG-FAS.

1. Open the Landscape Management application from the launchpad
2. Select your SAP Fieldglass service
3. Press the > button at the end of the line
4. On the tab "Endpoints" press the Add button to create a new end-point
5. Enter a description
6. Choose the use-case "Integration Monitoring"
7. Enter the Connection Test Path:
   • /api/vc/IntegrationMonitoringPullAPI
8. Choose OAUTH authentication enter the OAuth credentials retrieved from SAP Fieldglass:
   • Client ID: Enter the Virtual Person Name
   • Client Secret: Enter the License Key
   • Token Service URL: Extend your  Fieldglass  URL with '/api/oauth2/v2.0/token?grant_type=client_credentials&response_type=token'
   • API Key: Enter the API Application Key

In SAP Cloud ALM you can easily activate the standard monitoring content without any additional setup effort. 

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. Change the drop-down for Display Service to "All"
4. Select your cloud service in the scope
5. Click the rack-wheel icon in the upper right corner to access the configuration
6. Expand the Configuration panel
7. Change the toggle button next to the cloud service from OFF to ON

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 Fieldglass

• Erroneous Fieldglass Message Detected: Creates an alert for each failed message in SAP Fieldglass
• Erroneous Fieldglass Messages Detected: Creates an alert if one or more failed messages on SAP Fieldglass were detected since the last data collection

Available Filter Fields for SAP Fieldglass

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.

Fieldglass Messages

• Direction: Inbound or Outbound
• Category Type: Subscription Audit trail, Integration Audit trail or Event Driven Audit trail

• Name: Message name (see Application Data tab for collected messages)
  

• Status: Status of the message
• Status Group: Successful, Warning, Error, In Process, Canceled, Others
• Status Details: Filter on the Status Text