Show TOC

Function documentationUsing the E2E-MAI Support Servlet Program


The E2E MAI Support Servlet program determines the current status, configuration settings and measured values passed for diagnostics agents and their metrics. To use the program, you need detailed knowledge of the technical details and architecture of Diagnostics Agent and Monitoring and Alerting Infrastructure (MAI) data transfer; so you normally use the program in collaboration with SAP Support.

Diagnostics Agents are a type of extractor in the Extractor Framework (the central SAP Solution Manager data collection and distribution infrastructure). The Collector Type specifies the technical realization to get the measured values of metrics. The most important collector types include PULL_RFC, in which the Extraktor Framework regularly queries the values of the managed object via an RFC connection, and PUSH_GENERIC, in which an agent passes the data to the SAP Solution Manager system. This program checks collectors of type PUSH_GENERIC.

Note Note

Check collectors of type PULL_RFC with the tool Data Provider Check for PULL_RFC Metrics.

End of the note.

You usually use the program in one of the following situations:

  • Metrics of a managed object are not passed completely or correctly to MAI. You have determined the Diagnostics Agent responsible for providing the data for this object, as described below, in Agent Framework.

  • Some metrics, whose data is provided by a collector of type PUSH_GENERIC, are regularly updated. They are displayed in gray in the Technical Monitoring work center. You can determine the collector type of a metric in the Technical Monitoring Directory Browser. It also shows the metric type ID, which you need for troubleshooting in the E2E-MAI servlet.

To determine which Diagnostics Agent provides the data of a specified managed object, proceed as follows:

  1. Start the Agent Framework. It is in the SAP Solution Manager Administration work center, under Start of the navigation path Infrastructure Next navigation step Framework Next navigation step Agent Framework End of the navigation path.

  2. Go to the Configuration tab.

  3. The agent is in the table Role Assignment. The technical name of the managed object is in the column Role (e.g. <sys ID>~ABAP~<instance name> for the technical instance of an ABAP system), the agent is in the column Diagnostics Agent. There can be more than one agent per role, but only one is assigned at a time (column Current Assignment).

Note Note

To be able to call the E2E-MAI servlet, you need the roles SAP_RCA_AGT_ADM and SAP_RCA_DISP.

End of the note.


Call Program

To call the E2E MAI Support Servlet program, call the transaction MAI_TOOLS. In the Analysis tab, choose (E2E MAI Support Servlet).

Display Results

The program displays data about the runtime environment of one Diagnostics Agent. Select an agent in the drop-down list. This is usually an agent with data collection errors which you determined for a metric or managed object (see above).

Display the following data for the selected agent by choosing the associated pushbutton:



Show Pending Simple Events

This pushbuttons are of limited significance for troubleshooting and problem analysis. Display the relevant part of the worklist for the agent.

Show Pending SELFMON Events

Show Current Configuration

Each Diagnostics Agent has configuration settings in an XML file. The file contains information about which metrics with which collection parameters, gets data from which data provider, and passes it to SAP Solution Mananger via the agent. This pushbutton displays the contents of this file. The metrics displayed are technically grouped in metric groups.

You typically search in the configuration XML for the metric type ID which you determined in initial troubleshooting. Ther data for this metric is displayed, for example the category, the collection parameters, the data provider, etc. Check that these values match those in the directory browser.

Download Current Configuration

You can download this XML file and examine it locally. Select this pushbutton:

Note Note

This function is also in the Agent Management, in the Applications Configuration tab. The file is under Agent Applications, Start of the navigation path Configuration Next navigation step Next navigation step Application Resources Next navigation step MAI/MetricCollectionDefinition.xml End of the navigation path.

End of the note.

Show Collection Statistics

You can display the collection statistics for the last 25 runs of the agent. This tells you which metrics were collected, with which values. The information is sorted by metric groups. If data was collected for a metric group, it is output with the metric type ID.

Note Note

A metric type ID will not appear in the collection statistics even if values are collected for it according to the settings in the configuration XML, if the collection could not be performed for the metric group to which the metric belongs.

End of the note.

Show Last Collection Errors

You can display the messages for errors which occurred in the last agent runs.

Show Log Files

Choose this pushbutton to display the latest log messages in the Agent Management for the selected agent.