Using 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 System-& Application Monitoring work center. You can determine the collector type of a metric in the System-& Application 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:

Start the Agent Framework. It is in the SAP Solution Manager Administration work center, under Infrastructure Framework Agent Framework .
Go to the Configuration tab.
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.

Activities

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:

Pushbutton	Meaning
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 This function is also in the Agent Management, in the Applications Configuration tab. The file is under Agent Applications, Configuration com.sap.smd.agent.application.e2emai Application Resources MAI/MetricCollectionDefinition.xml . 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 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.