SAP ABAP platform monitoring

Deprecation notice

This extension documentation is now deprecated and will no longer be updated. We recommend using the new SAP GUI and ABAP Platform extension for improved functionality and support.

Learn how to monitor your SAP ABAP platform using the SAP ABAP ActiveGate extension.

Prerequisites

SAP NetWeaver ABAP release 7.31+
Environment ActiveGate
- For Environment ActiveGate installation instructions, see Dynatrace ActiveGate.
SAP Java Connector present on the ActiveGate host (see configuration instructions below)
An endpoint to an SAP application server with production load can consume up to 0.5 CPU cores and 1.5 GB RAM on the ActiveGate. Make sure to size the ActiveGate accordingly, especially if you configure several endpoints which poll from a single ActiveGate.
The ActiveGate requires remote access to the SAP application server (AS ABAP) over RFC protocol
If the endpoint is configured to poll all clustered instances, the ActiveGate requires remote access to all the SAP AS instances
A user account that has permission to execute the following monitoring functions:
- Authorization Object: S_RFC
  - Activity: 16
  - RFC Name: /SDF/GET_DUMP_LOG, GET_SYSTEM_TIME_REMOTE, SWNC_GET_WORKLOAD_SNAPSHOT, TH_SERVER_LIST, TH_USER_LIST, RFC_METADATA_GET, RFCPING, RFC_GET_FUNCTION_INTERFACE, DDIF_FIELDINFO_GET, RFC_READ_TABLE (Querying the TBTCO table when reporting on jobs)
  - RFC Type: FUNC
- Authorization Object: /SDF/E2E
  - Activity: 03
- Authorization Object: S_RZL_ADM
  - Activity: 03
- Authorization Object: S_TOOLS_EX
  - AUTH: S_TOOLS_EX_A
- Authorization Object: S_TCODE
  - TCD: SM51

SAP Java Connector configuration

Configure the SAP Java Connector on the ActiveGate host

Download the 64-bit version of the SAP Java Connector to the ActiveGate.
Place the sapjco3.jar file into the JCo folder, as configured below when adding a new monitoring endpoint (step 7 in extension installation).
Depending on the OS running on the ActiveGate host, place sapjco3.dll (Windows) or libsapjco3.so (Linux) into the JCo directory.
Make sure that the user account executing the plugin is permitted to read from the JCo folder.
Windows only Make sure that the Windows-based ActiveGate host has the Visual C++ Redistributable Packages for Visual Studio 2013 installed. The SAP Java Connector depends on it.

Extension installation

In Dynatrace Hub, select SAP GUI and ABAP platform.
Select Download to get the extension ZIP file. Don't rename the file.
Unzip the ZIP file to the plugin_deployment directory of your ActiveGate host. If the resulting directory structure isn't
```
.\plugin_deployment\<EXTENSION-SPECIFIC-DIRECTORY>\
```
where <EXTENSION-SPECIFIC-DIRECTORY> is the name of the directory containing the files for this extension, make the necessary changes.
If you're planning to monitor user activity, create a new custom application.
1. In Dynatrace Hub, select Generic frontend.
2. Select Set up > Monitor custom application.
3. Give your application a descriptive name, choose an icon, then select Monitor custom application.
4. Select Instrumentation wizard and keep a note of the Application ID that is generated for your custom application. The Beacon URL is not used, as the extension sends the data back via the ActiveGate where the extension runs.
In Dynatrace, go to Settings > Monitoring > Monitored technologies and select Add new technology monitoring > Add ActiveGate extension.
Select Upload extension and upload the ZIP file.
Enter the following information to connect to your SAP host:

Setting
Details
Endpoint name
Enter a meaningful endpoint name. The name will only be visible on the configuration page.
Connect via message server
Connect to the SAP application server via a message server. Once the list of SAP application servers is collected, the extension connects directly to the servers. If the message server is down, the availability of the SAP application servers behind the message server will not be collected. To detect and configure alerting for such a state, set up a missing data alert custom event that alerts on the condition if data is missing.
SAP application server address
The IP or host name of the SAP application server. Not used when connecting via a message server.
Instance ID
The instance ID to connect to (this is a numeric, two digit value). Not used when connecting via a message server.
System ID
The system ID to connect to. Only used when connecting via a message server.
Message server host name or address
The IP or host name of the message server. Only used when connecting via a message server.

Troubleshoot ActiveGate extensions

See Troubleshoot ActiveGate extensions.

Metrics

Application server instance

Availability
Runtime errors (split by error category)
Number of user sessions
CPU time/Response time ratio
Database time/Response time ratio
Wait time/Response time ratio
Load time/Response time ratio

Tasks (split by task)

Response time
Dialog steps
CPU time
Database time
Database calls
Roll in time
Roll wait time
Load + generation time
Active user count

Dialog

Dialog steps
Dialog response time
Dialog network time
GUI active user count

RFC metrics available in Data Explorer

sap.rfcIncomingExecutionTime (milliseconds)
sap.rfcIncomingCallTime (milliseconds)
sap.rfcIncomingReceive (bytes)
sap.rfcIncomingSend (bytes)
sap.rfcIncomingRequests (count)
sap.rfcOutgoingExecutionTime (milliseconds)
sap.rfcOutgoingCallTime (milliseconds)
sap.rfcOutgoingReceive (bytes)
sap.rfcOutgoingSend (bytes)
sap.rfcOutgoingRequests (count)

Job metrics available in Data Explorer

SAP.job.status_count (count)
SAP.job.avg_duration (milliseconds)
SAP.job.avg_delay (milliseconds)
SAP.job.max_delay (milliseconds)

Additional notes

ABAP runtime errors are created as events in Dynatrace and, if possible, mapped to the responsible user session or user action.
Infrastructure and dependency monitoring requires OneAgent installation on the AS ABAP servers and other servers in the SAP landscape. Typically, this includes database servers and RFC client servers that communicate with SAP application servers.