Patch overview
Patch files
v3.0 SP1 has one patch file for ABAP:
K-250SP03NEWR.SAR
The patch also includes a new role file:
_NEWR_DATA_PROVIDER V3.1.SAP
Updates in this patch
New data providers
SAP Workload monitoring data providers
The main feature enhancement for SP1 is data providers from SAP Workload Monitoring (Transaction ST03N). SAP Workload Monitor uses the SAP performance database to analyze the ABAP kernel's workload and performance. It has many views, such as Workload Overview, Task Profile, Top Long Running Dialog Programs, etc.
Standard SAP function SWNC_GET_WORKLOAD_SNAPSHOT is called every 5 minutes to take performance database snapshots by two main data providers:
NR_SAP_WORKLOAD_COMPLETE(Event)NR.SAP.WORKLOAD.COMPLETE(Metric)
These retrieve snapshot data and transmit to New Relic with sub-events and sub-metrics.
Data providers and ST03 analytics views:
Data provider name | ST03 analytics view | Data provider type | Internal table name |
|---|---|---|---|
| Workload Overview | sub-metric | TASKTYPE |
| Workload Overview | sub-event | TASKTYPE |
| Transaction Profile, Standard | sub-event | TIMES |
| Time Profile | sub-metric | TASKTIMES |
| Time Profile | sub-event | TASKTIMES |
| Ranked Top 25 Program Dialog Response Time | sub-event | HITLIST_RESPTIME |
| Ranked Top 25 Database Access Response Time | sub-event | HITLIST_DATABASE |
| User Statistics: User Profile | sub-event | USERWORKLOAD |
| User Statistics | sub-event | USERTCODE |
| Frontend Statistics | sub-event | FRONTEND |
| Memory Use Statistics | sub-event | MEMORY |
| Spool Statistics | sub-event | SPOOLACT |
| Web Client Statistics | sub-event | WEBC |
| Web Client Destination Statistics | sub-event | WEBCD |
| Web Server Statistics | sub-event | WEBS |
| Web Server Destination Statistics | sub-event | WEBSD |
| RFC Client Profile | sub-event | RFCCLNT |
| RFC Client Destination Profile | sub-event | RFCCLNTDEST |
| RFC Server Profile | sub-event | RFCSRVR |
| RFC Server Destination Profile | sub-event | RFCSRVRDEST |
External outbound email data provider
This data provider (NR_SAP_EXTERNAL_OUTBOUND_EMAIL) extracts emails sent from SAP application server instance to an external address.
Bug fixes
This service pack fixes the following issues:
- Trace sending incorrect span timestamps
- The user who runs the collection job has to use the system time zone
- The collection manager dumps when HANA expensive statement data provider is not configured
- The RFC check program does not check New Relic endpoint HTTP destinations when the only monitored system is the monitoring system and RFC destination is set to 'NONE'
Manual configuration steps
There are a few data provider configuration changes that need to be manually done. Configuration changes can be performed using SAP transaction /n/NEWR/REGISTRY. Select the data provider in question and click on the "Configure" button to make the change.
Workload complete data providers configuration
The NR_SAP_WORKFLOW_COMPLETE and NR.SAP.WORKLOAD.COMPLETE data providers are shipped with SETTING_SWITCH parameters empty, therefore default values are used during execution. However, they can be adjusted for optimal performance:
SETTING_SWITCH parameter
This parameter allows a precise tuning of system settings to strike a balance of performance and system resource demands. If this parameter is not set, the default values are in force. There are multiple configuration options, which are combined and separated by semicolon:
Parameter | Description | Default value |
|---|---|---|
| Minimum percentage of free work processes over total work processes. | 25(%) |
| Minimum number of free WP, nn is 01 to 99. Between | 5 |
| Maximum waiting time (in seconds). If the data provider cannot secure enough free dialog work processes within the maximum waiting time, the collection RFC call is skipped. This might lead to a data gap. | 20 |
| Maximum IDOC header to be retrieved in each RFC call to | 10000 |
| Maximum number of events sent to New Relic Cloud in each batch. | 5000 |
| Maximum data provider work processes per user. When work process and memory limitations exist on the monitoring system ABAP servers, this parameter limits the maximum dialog work processes occupied by New Relic Monitoring for SAP. Run the New Relic Monitoring Collection Manager with a specific user ID to implement this limit. The total work processes used equals the number of WPs occupied by that user ID. If the data provider attempts to start work processes beyond this limit, it waits 1 second and retries until work processes become available or the maximum wait time is reached. | Not enforced if empty or missing |
| The user ID that runs Collection Manager. If this parameter is empty or missing, the maximum data provider work process is not enforced. | Not enforced if empty or missing |
External outbound email configuration
The NR_SAP_EXTERNAL_OUTBOUND_EMAIL data provider is normally shipped as suspended and runs wide open. However, we recommend setting filters before running. Possible filter parameters are:
EMAIL_SENDS
Specific email sender for monitoring can be enumerated here, separated by semicolon. Wildcard is not supported for this parameter.
EMAIL_STATUS
Enumerated statuses to be monitored, separated by semicolon. Leaving this parameter empty will monitor all email statuses. By default, these statuses are monitored: WAIT;TRANSIT;OK;ERROR;INCONS;FUTURE;RETRY;DIRECT;ACTIVE.
EMAIL_TITLE
Filter on emails' subject line. Wildcard * is supported for this parameter.
Security role update
Upload the new role file _NEWR_DATA_PROVIDER.SAP to the monitored systems for the new authorization required for the new data provider.
The following RFC functions are added to the RFC security object:
SX_SNDREC_SELECT