SAP AIF

With SAP Application Interface Framework (AIF) you can easily develop, run and monitor all the application interfaces your business needs. SAP AIF is an integral part of SAP S/4HANA and S/4HANA Cloud for interface development, error and monitoring handling. And it is also available as add-on for the SAP Business Suite.

While SAP AIF has a local monitoring tool integrated, the messages sent through SAP AIF can be monitored also with SAP Focused Run to provide a centralized monitoring for all interface types and all systems in the SAP landscape.

 

Technical Prerequisites

SAP Application Interface Framework is the standard monitoring and interface hub for SAP S/4HANA and SAP S/4HANA Cloud applications. AIF is now part of the S/4HANA core component and no longer needs to be installed as an add-on to the system.

To be able to monitor SAP AIF messages, you need:

  • SAP Focused Run 2.0 FP01

  • S/4HANA running on SAP Basis 7.54 and SAP_ABA 75E or higher 

The formerly used ABAP add-on for SAP AIF in SAP ABAP systems with SAP Basis < 7.50 is not supported by SAP Focused Run.

Integration Monitoring Setup

Available Monitoring Categories

The available monitoring categories are:

  • AIF-bgRFC(queue): AIF monitored queued bgRFC interfaces
  • AIF-bgRFC(trans): AIF monitored transactions bgRFC interfaces
  • AIF-IDoc: AIF monitored IDoc interfaces
  • AIF-PI-runtime: AIF monitored PI interfaces
  • AIF-qRFC: AIF monitored qRFC interfaces
  • AIF-tRFC: AIF monitored tRFC interfaces
  • AIF-SYNC_LOG: AIF monitored Sync Log interfaces
  • AIF-XML: AIF monitored XML interfaces
  • AIF-WS-runtime: AIF monitored web service interfaces

To monitor currently running interfaces and messages in the S/4 system please use transaction /n/AIF/ERR the setup of AIF is done in transaction /n/AIF/IFMON.

Available Filter Options

For AIF Monitoring you can always collect all messages collected by AIF for all categories. However, you can also use the following filter parameters, to restrict the data collection:

AIF-bgRFC(queue)

  • Direction: Choose I (Inbound) or O (Outbound)
  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF-bgRFC(trans)

  • Direction: Choose I (Inbound) or O (Outbound)
  • RFC Destination: RFC destination name
  • Transaction Code: The name of the SAP transaction code with which the unit was created
  • Program: Tcode/program with which the unit was created
  • User: The name of the user under which the unit is recorded

AIF-IDoc

  • Direction: 1 (Outbound) or 2 (Inbound)
  • Sender port: Partner port (relevant for inbound IDocs)
  • Receiver port: Partner port (relevant for outbound IDocs)
  • Message Type: IDoc Message type, e.g. ORDERS

AIF-PI-runtime

  • Sender namespace: The namespace of the source of the message
  • Sender interface: The interface of the source of the message
  • Sender party: The communication party of the source of the message
  • Sender component: The component of the source of the message
  • Receiver namespace: The namespace of the target of the message
  • Receiver interface: The interface of the target of the message
  • Receiver party: The communication party of the target of the message
  • Receiver component: The component of the target of the message

AIF-qRFC

  • Direction: Choose I (Inbound) or O (Outbound)
  • Queue Name: Name of qRFC Queue
  • RFC Destination: RFC destination name

AIF-tRFC

  • RFC Destination: The name of the RFC destination the tRFC is sent over
  • Function Module: The name on the called function module
  • User: The user in the RFC destination

AIF-SYNC_LOG

  • No filters are available for this category on data collection level. To filter the collected data and generate alerts please use the filters in the 'Alerting' step.

AIF-XML

  • No filters are available for this category on data collection level. To filter the collected data and generate alerts please use the filters in the 'Alerting' step.

AIF-WS-runtime

  • Adapter Type: The adapter used for the WS. Please use the input help to select an adapter.
  • Sender Party: Sender Communication party
  • Sender Interface Name: Sender Interface
  • Sender Interface Namespace: Sender Interface Namespace
  • Receiver Party: Receiver Communication party
  • Receiver Interface Name: Receiver Interface
  • Receiver Interface Namespace: Receiver Interface Namespace

To find useful filters for the categories, it makes sense to collect all messages first. The filter values will be in the collection context of the collected messages in Advanced Interface Monitoring

Available Metrics

For message retrieved from SAP AIF the following metrics are collected:

For all of the collected metrics you can filter by the following parameters additionally to the ones that are already available in the data collection for the respective message type:

  • Client: SAP client
  • Namespace: AIF interface namespace
  • Interface Name: AIF interface name
  • Interface Version: AIF interface version
  • Status: The last status of the message
  • Status Group: Please select a value from the input help
  • Status Text: Text in the status or parts thereof
  • Direction (if applicable): Message direction

AIF-IDoc

  • IDocs in status Error for longer than N minutes: Indicates new IDocs in the status group ERROR were collected during the collection interval
    • Metric parameters: 
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider IDocs older than [minutes] 

AIF-PI-runtime

  • PI Messages in status ERROR for longer than N minutes: Indicates new PI messages in the status Error were found during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider PI Messages older than [minutes]

AIF-WS-runtime

  • Number of erroneous AIF-WS messages: The metric specifies the number of erroneous Web Service messages within the collection interval.
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider WS Messages older than [minutes]

AIF-bgRFC(queue)

  • AIF-bgRFC(queue) messages in status Error for longer than N minutes: Indicates new bgRFC (queue) messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider bgRFC (queue) messages older than [minutes]

AIF-bgRFC(trans)

  • AIF-bgRFC(trans) messages in status Error for longer than N minutes: Indicates new bgRFC (trans) messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider bgRFC (trans) messages older than [minutes]

AIF-qRFC

  • AIF-qRFC messages in status Error for longer than N minutes: Indicates new qRFC messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider qRFC messages older than [minutes]

AIF-tRFC

  • AIF-tRFC messages in status Error for longer than N minutes: Indicates new tRFC messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider tRFC messages older than [minutes]

AIF-SYNC_LOG

  • Sync Log messages in status error for longer than N minutes: Indicates new Sync Log messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider Sync Log messages older than [minutes]

AIF-XML

  • XML messages in status error for longer than N minutes: Indicates new XML messages in the status group ERROR were collected during the collection interval
    • Metric parameters:
      • STATUS_GROUP (not changeable) = ERROR
      • OLDER_THAN_MINUTES = Only consider XML messages older than [minutes]