Extend the platform,
empower your team.
Monitor your SAP Application Server's user transactions, RFC and jobs.
ExtensionOur SAP ABAP platform monitoring solution is based on a remote monitoring approach implemented as a Dynatrace ActiveGate extension. The extension queries SAP servers for key performance counters. Collected metrics are analyzed in Dynatrace, using the SAP expert community’s established best-practice advice on ABAP platform health indicators, including response time breakdowns of the response times between ABAP-specific application server activities, tasks, and database interaction.
Simply activate the extension in your environment using the in-product Hub, provide the necessary configuration and you’re all set up.
SAP NetWeaver ABAP release 7.31+
Environment ActiveGate with Dedicated Performance Profile
A monitoring configuration 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 configurations which poll from a single ActiveGate.
NOTE : When setting up the dedicated profile, by default the RUM Beacon Forwarder is disabled. In order to ingest RUM Sessions, it must be turned back on in the ActiveGate's custom.properties
file :
[beacon_forwarder]
beacon_forwarder_enabled = true
SAP Java Connector present on the ActiveGate host (see configuration instructions below)
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:
S_RFC
16
/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)FUNC
/SDF/E2E
03
S_RZL_ADM
03
S_TOOLS_EX
S_TOOLS_EX_A
S_TCODE
SM51
Configure the SAP Java Connector on the ActiveGate host
sapjco3.jar
file into the JCo
folder, as configured below when adding a new monitoring endpoint (step 7 in extension installation).sapjco3.dll
(Windows) or libsapjco3.so
(Linux) into the JCo
directory.JCo
folder.Setting | Details |
---|---|
Connect to SAP via | Connect directly to an SAP application server or 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. |
Message server port number | The port that the message server is listening on. Only used when connecting via a message server. |
Group/server | The group/server configured on the message server. Only used when connecting via a message server. |
Keystore path | Path to keystores if required for the connection, defined as SECUDIR. |
Username | The username for the account connecting to the SAP application server. |
Password | The password for the account. |
Client Number | The client number to use for the connection. |
Poll all Clustered SAP Instances | Instead of creating one endpoint per SAP instance, this option polls all clustered SAP instances at once. |
Use 'SAP Application Server Address' as the Application Server Name | Instead of the entity using the name returned by the application server instance, use the value entered in SAP application server address. Not possible when Poll all Clustered SAP Instances is enabled. |
Path to a JCo Destination File | optional If a specific destination file is required to connect to the SAP server, enter the path here. This will override all of the above settings except for the keystore path. |
SAP JCo folder | The folder containing the sapjco3.jar and the native Java Connector file. |
Task types to report on | List of task types to report on, the rest will be combined. The possible task types are: NONE, DIALOG, UPDATE, SPOOL, BCKGRD, ENQUEUE, BUF.SYN, AUTOABA, UPDATE2, NATIVE_RFC, PLUGIN, AUTOTH, RPCTH, RFCVMC, DDLOGCLEANUP, DEL.THCALL, AUTOJAVA, LICENCESRV, AUTOCCMS, MSADM, SYS_STARTUP, BGRFCSDL, BGRFC, APC, OTHERS, DINOGUI, B.INPUT, HTTP, HTTPS, NNTP, SMTP, FTP, LCOM, HTTP/JSP, HTTPS/JSP, AUTO_RFC, WS-RFC, WS-HTTP, ESI, ALE, RFC and CPIC |
Report User SEssions | Select this to create user sessions and user actions based on the customer-executed Tcodes. This functionality requires a custom application to be created. |
The Application ID of the custom application | To create user sessions, fill in the Application ID you are prompted with after creating the custom application. |
Inactivity time out (in minutes) when capturing user sessions | Enter a number between 5 and 25, default is 25. |
Capture Usernames as part of the User Sessions | Select to capture usernames. |
Use Terminal Name for End User Location | When capturing user sessions, use the IP resolved from the first 20 characters of the terminal name instead of the SAP returned user IP. This is useful when the application server does not know the client IP, for example when the users connect via SAP Router. |
Report on RFC Client/Server Metrics | Select whether to only report on the servers communicating to/from the SAP Application server, or to additionally split up the metrics on individual function names. |
Capture Usernames as part of the Per Function Call RFC Metrics | Include Usernames as a dimension when capturing RFC Metrics Per Function Call |
Poll Less Often | Reduces overhead on SAP application server, but lowers the granularity in charts and delays data retrieval. During heavy load on the SAP application server this might cause the SAP server to not send all user actions to Dynatrace. |
Enable Debug Logging | Select this only if a Dynatrace product expert requests it to investigate an issue. |
A: The formula for consumption of the extension is:
By Feature Set Enabled :
- default -> (2 * <# of App Servers>)
- Threshold Metrics -> (3 * <# of App Servers>)
- Application Server Instance Metrics -> (21 * <# of App Servers>)
- Tasks Metrics -> (((8 * <# of Tasks configured>) + 8) * <# of App Servers> )
- Dialog Metrics -> (4 * <# of App Servers>)
- Jobs Metrics-> (6 * < # of Jobs>)
- RFC Metrics - choose 1 depending on configuration :
- `Per Remote Destination` -> (10 * < # of Remote Destinations > * <# of App Servers> )
- `Per Function Call` -> (10 * < # of Remote Destinations > * <# of Program Names> * <# of Location Destinations> * <# of client numbers> * <# of user ids> * <# of function names> * <# of App Servers> )
Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.
Metric name | Metric key | Description | Unit |
---|---|---|---|
Job Count | sap.job.count.gauge | - | Count |
Job Status Count | sap.job.status_count.gauge | - | Count |
Job Avg Duration | sap.job.avg_duration | - | MilliSecond |
Job Max Duration | sap.job.max_duration | - | MilliSecond |
Job Avg Delay | sap.job.avg_delay | - | MilliSecond |
Job Max Delay | sap.job.max_delay | - | MilliSecond |
Metric name | Metric key | Description | Unit |
---|---|---|---|
RFC Incoming Execution Time | sap.rfcIncomingExecutionTime | - | MilliSecond |
RFC Incoming Call Time | sap.rfcIncomingCallTime | - | MilliSecond |
RFC Incoming Receive Bytes | sap.rfcIncomingReceive | - | Byte |
RFC Incoming Send Bytes | sap.rfcIncomingSend | - | Byte |
RFC Incoming Requests | sap.rfcIncomingRequests | - | Count |
RFC Outgoing Execution Time | sap.rfcOutgoingExecutionTime | - | MilliSecond |
RFC Outgoing Call Time | sap.rfcOutgoingCallTime | - | MilliSecond |
RFC Outgoing Receive Bytes | sap.rfcOutgoingReceive | - | Byte |
RFC Outgoing Send Bytes | sap.rfcOutgoingSend | - | Byte |
RFC Outgoing Requests | sap.rfcOutgoingRequests | - | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
50% boundary | sap.fiftyline | - | Percent |
10% boundary | sap.tenline | - | Percent |
2% boundary | sap.twoline | - | Percent |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Runtime errors | sap.runtimeErrorsByCat | - | Count |
Connected users | sap.sessions | - | Count |
CPU time/Response time ratio | sap.cpuratio | - | Percent |
Wait time/Response time ratio | sap.waittimeratio | - | Percent |
Load time/Response time ratio | sap.loadtimeratio | - | Percent |
Database time/Response time ratio | sap.dbtimeratio | - | Percent |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Availability | sap.avail | - | Percent |
Metric name | Metric key | Description | Unit |
---|---|---|---|
GUI User count | sap.guiusercount | - | Count |
Dialog response time | sap.guiresponsetime | - | MilliSecond |
Dialog steps | sap.guidialogsteps | - | PerSecond |
Dialog network time | sap.guinetworktime | - | MilliSecond |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Average task time | sap.Task.avgtottime | - | MilliSecond |
Average time | sap.avgtime | - | MilliSecond |
Dialog steps | sap.Task.dialogsteps | - | PerSecond |
CPU time | sap.Task.cputime | - | MilliSecond |
Database time | sap.Task.dbtime | - | MilliSecond |
Roll in time | sap.Task.rollintime | - | MilliSecond |
Roll wait time | sap.Task.rollwaittime | - | MilliSecond |
Load + generation time | sap.Task.loadgentime | - | MilliSecond |
Database calls | sap.Task.dbcalls | - | Count |
User count | sap.Task.usercount | - | Count |
SAP Business Technology Platform (SAP BTP) is the technological foundation for the intelligent enterprise.
SAP Cloud Platform integrates data and business processes.
Easily understand the health and performance of your SAP HANA databases.
Monitor SAP systems performance with SoftwareOne PowerConnect for Dynatrace.
Correct issue with how dimensions are escaped/sanitized for Job/RFC metrics
Move Job Metrics to System Details Screen to give better overview of which jobs are running on which App Servers
Fix issue where results fix wasn't completely in UTF-8
Update how metric values are timestamped to be more accurate
Update relationships to CHILD_OF between System and App Server
Update OpenKit to support long
values for reported bytes sent and received
Initial Release based on EF1.0 Version