This powerpack enables seamless integration of Redpeaks/Pro.Monitor
monitoring solution for SAP with SL1 using the REST toolkit.

• This powerpack facilitates the discovery and monitoring of SAP environments within SL1.
• It utilizes SL1's REST toolkit framework.
• It establishes a connection to Redpeaks/Pro.Monitor API, providing access to monitoring data.
• Automatic creation and grouping of SAP devices occur seamlessly.
• System metadata, metrics, and alerts are automatically associated with their respective devices for streamlined organization.
• A set of dynamic applications will provide visibility on generated alerts and metrics and can be used to build custom dashboards and automation

The powerpack specifically focuses on system monitoring across these categories:

• SAP S/4HANA and NetWeaver (starting from version 4.6)
• SAP HANA Database
• SAP BusinessObjects

You will find in the Monitored environments section below an exhaustive list of the monitored components.

• V1.3.2 (2024-02-15)
  • Important: Use the “Rest snippet framework 101” credentials when aligning with the root level discovery application
  • Documentation update.

• V1.3 (2024-02-13)
  • Uses a copy of the REST toolkit V101 as execution environment.

• V1.2 (2024-01-26)
  • Uses the updated REST toolkit environment.
  • Important: Make sure to use the “Universal” credentials when aligning with the root level discovery application.

• V1.1 (2023/12)
  • Remove the use of cache to fix data collection issue
  • Use JMSEPath instead of JSONPath to improve performance

• V1.0 (2023/11) - First version of this powerpack
  • Support of S/4HANA, NetWeaver, HANA, BusinessObjects
  • Reports all alerts
  • Collects alerts and metrics for ABAP, J2EE, HANA stack sysems.
  • Collects alerts for BusinessObjects systems.

• A Pro.Monitor collector remotely monitors accessible systems.
• An SL1 collector usually connects to one Pro.Monitor collector within the same network security zone.
• Due to network and resiliency concerns, a 1-to-1 relationship is typical.
• However, it can collect data from multiple Pro.Monitor instances when needed.
• By example, for monitoring 2 separate SAP landscapes, it is possible to deploy 1 Pro.Monitor instance for each landscape, both linked to a single SL1 collector.

This is the most typical architecture:

1. Monitored SAP systems
2. Redpeaks/Pro.Monitor collector: Remotely connecting to the systems via standard API
3. SL1 collector: Performing REST API calls to collect monitoring data
4. SL1 instance

Defines the types of devices that the powerpack will create and manage.

Those applications will collect metrics and health information for the discovered devices.

Those policies define how Redpeaks/Pro.Monitor events are being converted in to SL1 alerts.

• This powerpack works with SL1 V11.3.0 or later
• It requires the REST toolkit powerpack V101
• It needs Redpeaks/Pro.Monitor collector version 6.8.5 or above.
• Ensure the Redpeaks collector is both installed and configured.
• Open network routes between the SL1 collector and Redpeaks collector on HTTP/HTTPS ports to allow HTTP REST requests from the SL1 collector to the Redpeaks collector.

Those are the main steps to complete for configuring the SAP integration in SL1:

1. Get SAP monitoring with REST toolkit powerpack from SL1 download center or from redpeaks (support@redpeaks.io)
2. Upload and install the SAP powerpack
3. Register Pro.Monitor REST API credentials
4. Create a root virtual device for SAP systems discovery
5. Assign the discovery dynamic applications to the root device

After having completed those few steps, the SAP infrastructure will be discovered and you will be able to see events and metrics within your SL1 instance.

• Navigate to the Powerpack section of SL1 settings
• Select Action→Import powerpack and upload the powerpack file
• Once upload is complete, the powerpack installer screen will popup: Press Install
• You should see the new powerpack in the table

• Navigate to Manage→ credentials

• Create a REST snippet framework 101 credential
• Set the Pro.Monitor collector URL and authentication parameters
• Use /api/v1/sl1 as API endpoint

Note:

• If you didn't install you own trusted certificate on Pro.Monitor instance, you MUST set SSL peer verify to False

• Navigate to Device manager

• Create a virtual device

• Edit the created device and go to collectors tab
• Assign dynamic applications:

• You need to assign two applications:
  • SAP_RP: SAP alerts
  • SAP_RP: SAP groups discovery
• Select the applications within the list.
• Once clicked on the application name, this will list the available credentials
• Select the credentials that you created and save
• 

• Once done, you should see two applications aligned with the device.
• From now on, your SAP architecture will be automatically discovered

• This is a description of the discovered devices by environement and associated monitored components

• For support or feature requests please use our Jira system : https://agentil.atlassian.net/servicedesk/customer/portal/9
• If you don't have an account yet, contact AGENTIL Software at support@agentil-software.com