Monitoring SAP with the ABAP sensor

Supported OS

Instana supports the following operating systems that are supported by SAP Java Connector for local and remote monitoring:

• For local monitoring (the Instana agent is installed on the same host as the ABAP server):

  • AIX
  • Linux (x86 and IBM PowerPC 64-bit LE)
  • Windows

• For remote monitoring (the Instana agent is installed on a different host and connects remotely to the ABAP server):

  • AIX
  • Linux (x86 and IBM PowerPC 64-bit LE)
  • Windows
  • IBM i (OS/400 PASE)
  • Apple macOS (64 bit - Intel and Apple silicon)

  For remote monitoring, the SAP can run on any platform, including IBM i, and be remotely monitored by installing the Instana agent on these platforms.

For more information about the operating systems supported by SAP Java Connector, see Supported OS.

Supported versions

The ABAP sensor supports the following SAP versions:

• SAP R/3 3.1
• S/4 HANA and later
• SAP Java Connector 3.1.9

Add the SAP JCo library

To add the SAP JCo library to a Linux-based system, complete the following steps:

1. Locate the installed Instana agent in the /opt/instana/agent directory.

2. In the Instana agent installation directory, create the system/com/sap/sapjco3/<Major>.<Minor>.<patch> directory

where in system/com/sap/sapjco3/3.1.9 the Major is 3, Minor is 1, and patch is 9.

Update these values based on the JAR version that you use.

The following steps consider SAP JCo 3.1.9 as an example; modify the version based on the JAR version file that you use:

1. Verify that you set up a directory structure, such as /opt/instana/agent/system/com/sap/sapjco3/3.1.9.

2. Download and extract the SAP JCo package, and follow the instructions that are mentioned in the Readme.txt file.

   The installation of JCo is platform-specific, and you must download the JCo version for the platform on which the Instana agent is run. The ABAP sensor gets deployed on the same computer as the Instana agent and communicates with the SAP system to fetch metrics.

3. After you download and extract the .zip file, copy the sapjco3.jar file from the extracted folder and paste it to the /opt/instana/agent/system/com/sap/sapjco3/3.1.9/ directory.

4. In the /opt/instana/agent/system/com/sap/sapjco3/3.1.9/ directory, rename the sapjco3.jar file to sapjco3-3.1.9.jar.Also, place the OS-specific library file in the /opt/instana/agent/system/com/sap/sapjco3/3.1.9/ directory. The file extension is .dll or .so.

After you place the files in the directory, your directory must appear as follows. The following example shows a Linux-based installation directory after you place the file in it:

ls /opt/instana/agent/system/com/sap/sapjco3/3.1.9/
libsapjco3.so  sapjco3-3.1.9.jar

You must not rename files with the extension .dll or .so.

General ABAP sensor configuration

Instana supports both local and remote monitoring for the SAP ABAP sensor.

Add all the local monitoring configurations under the local tag.

In the configuration.yaml file, add the configurations (local or remote) and enter the appropriate values for the host, sysnr (instance ID), client, user, password, and libpath parameters. The default polling interval for metric is set to 60 seconds.

# SAP ABAP
com.instana.plugin.sap.abap:
  # local monitoring configuration
  local : #multiple configurations supported
    - sysnr: '72'
      client: '100'
      user: 'User1'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds

# SAP ABAP
com.instana.plugin.sap.abap:
  # remote monitoring configuration
  remote : #multiple configurations supported
    - host: 'remote.host-1.com'
      sysnr: '72'
      client: '100'
      user: 'User1'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds
    - host: 'remote.host-2.com'
      sysnr: '01'
      client: '900'
      user: 'User2'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds

Verify user authorization to pull metrics

Make sure that the user specified in the ABAP sensor configuration in the YAML file is authorized to pull metrics from SAP JCo.

To pull metrics from SAP JCo, you need to provide the following Authorization Object parameters in the SAP user account:

Authorization Object: S_RFC
    RFC_TYPE: Function Module
    RFC_NAME: *
    Activity: Execute
 
Authorization Object: /SDF/E2E
    Activity: 03
 
Authorization Object: S_ADMI_FCD
    S_ADMI_FCD: ST0R
 
Authorization Object: S_RZL_ADM
    Activity: 03
 
Authorization Object: S_TABU_DIS
    DICBERCLS: &NC&,EDI0,SA,SC,SPWD
    Activity: 03

Infrastructure view

To view the metrics, complete the following steps:

1. In the sidebar of the Instana UI, select Infrastructure.
2. On the Map tab, click a tower specific to SAP.
3. Click Open Dashboard.

You can see the SAP dashboard with all the collected metrics.

Platform view

To view the metrics on Platform, complete the following steps:

1. Enable SAP platform dashboard, see, SAP.
2. Enable the SAP monitoring feature, see, SAP monitoring feature flag.
3. From the navigation menu in the Instana UI, select Platform > SAP. You can view lists the SAP systems, instances, and databases on separate tabs.
4. To view the SAP instance that is connected to the ABAP sensor, click the Instances tab. The sensor name is typically listed as AbapInstance@HostName_SID_InstanceID.

Frequency of metric collection

The following table outlines the frequency of metric collection by the ABAP sensor:

SAP ABAP sensor generates build-in events for various scenarios. For more information, see Built-in Events Reference.