Monitoring SAP with ABAP sensor (beta)

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 and later
• SAP Java Connector 3.1.8

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/3.1.8 directory.

3. Confirm that you set up a directory structure like /opt/instana/agent/system/com/sap/sapjco3/3.1.8.

4. Download and extract the SAP JCo 3.1.8 package, and follow the instructions in its enclosed 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.

5. 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.8/ directory.

6. In the /opt/instana/agent/system/com/sap/sapjco3/3.1.8/ directory, rename the sapjco3.jar file to sapjco3-3.1.8.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.

# 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](#add-the-sap-jco-library).
      poll_rate: 5 # 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](#add-the-sap-jco-library).
      poll_rate: 5 # 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](#add-the-sap-jco-library).
      poll_rate: 5 # 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
    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. This view lists the SAP systems, instances, and databases as separate tabs.
4. Click the Instances tab to see the SAP instance to which the ABAP sensor is connected. The sensor name is typically listed as HostName_SID_InstanceID.

Frequency of metric collection

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