-
Technical Assistance
Request product support from SAP
-
Non-Technical Assistance
Request non-product support or provide feedback on SAP Support Portal site
Technical Assistance
Request product support from SAP
Non-Technical Assistance
Request non-product support or provide feedback on SAP Support Portal site
Today's business processes are embedded in a global market with participants all over the world. Guaranteeing the highest availability and performance from almost every location is not just a challenge for huge companies anymore. SAP User Experience Monitoring (UXMon - formerly EEM) is an efficient toolbox for evaluating and reporting the availability and performance of your productive systems from a client-side perspective. As a result of the perfect integration into the E2E Diagnostics infrastructure, discovering, analysis, and resolution of occurring issues has been speeded up dramatically. Problems can often be solved before employees or customers even take notice about them, thereby yielding a lower TCO.
Scope
Benefits
The Recorder can be downloaded together with EEM Editor in next step and is included in the zip file.
JDK 5 or later is required to run the Editor. Only 32-bit JDKs can be used. You can install a 32-bit JDK without limitations on a 64-bit Windows system. Windows XP, Vista, and Windows 7 are supported.
If you require an updated or a special version of the EEM editor please check the download page:
Note: The EemEditor.zip also contains a user guide for the editor (PDF document) that explains the basic tasks for setting up EEM scripts.
Install Standalone Diagnostics Agent
Note the requirements for an agent to support the SAPGUI protocol:
You can skip the steps in this chapter if your are using an existing agent(s) from your E2E trace landscape. Note, however, the following limitation: If you use an existing agent for EEM that is also assigned to a managed system then every execution of the managed system configuration setup step "Introscope Host Adapter" will cancel all EEM script executions. A restart of the agent is recommended to recover from this.
Refer to Diagnostics Agent Platform Support for EEM Robots for platform support and installation guidance.
Configure SMD Agent
Follow the setup that is available via the sap note mentioned here; Diagnostics Agent Platform Support for EEM Robots.
The robot name can be set in SAP Solution Manager Configuration: Technical Monitoring - End-User Experience Step 2.6 'Configure EEM Robots'
Apply latest version of note EEM Correction Note
Please apply first the SNOTE corrections with note SAP Note 875986 and restart the transaction with /nSNOTE.
Correction notes relevant for each Support Package:
Support Package | SAP Note |
---|---|
SP03-SP06 |
2464104 - Corrections for UXMon 7.2 2604141 - Extractor for User Experience Monitoring (UXMon) creates too many log entries |
Perform Guided Setup Procedure
Start the workcenter SAP Solution Manager Configuration choose Technical Monitoring and select End-User Experience with user SOLMAN_ADMIN or a copy of this user.
Documentation
Documentation can be found at http://help.sap.com/solutionmanager
or directly for EEM via this link: UXMon Help for 7.20
When installing new Diagnostics Agents, always use the latest available Diagnostics Agent installer. For more information refer to following page Diagnostics Agents > General Information.
All server platforms for which Diagnostics Agent installations are supported, are also supported for installing EEM Robots.
Below information is valid for an upgrade from SAP Solution Manager 7.1 to 7.2 (up to SP06).
It's also valid for an upgrade from a 7.2 lower SP to an upper SP (up to SP06)
There are no UXMon specific steps that need to be executed before upgrading the system.
Before re-executing the UXMon Guided Procedure, please apply the following SAP Note onto the SAP Solution Manager system:
After the technical upgrade to 7.2 you need to execute the UXMon Setup Guided Procedure.
Please pay a special attention to the Step 2 and its sub-step 2.4. This contains all tasks that can be executed automatically.
With SAP Solution Manager 7.2, User Experience Monitoring proposes a Fiori version of its Monitoring UI.
Without providing the capability and the flexibility of the UXMon Monitoring UI, the Fiori version is more suited for small screens of the mobile devices.
This User Experience Monitoring - Mobile Optimized application allows you to monitor performance and availability of technical scenarios from multiple locations across your global IT landscape anywhere, anytime.
Refer to Configuration of SAP Fiori for SAP Solution Manager on the SAP Help Portal
Note: Do not miss the user guide for the UXMon Script editor. It is contained as PDF document in the Script Editor archive file (zip) and explains the basic tasks for setting up UXMon scripts.
Concepts
Use Cases, Tips and Tricks, and Advanced Topics
Protocol-specific Information
General
Root Cause Analysis Integration
Monitoring, Alerting and Reporting
Symptom
Your RFC content check fails even if you have correctly mapped the XML structure shown under tab Export Parameters in a Content Check path.
Export Parameters
<OUTPUT> <SCRIPTS> <item> <SCENARIO_ID>2</SCENARIO_ID> </item> </SCRIPTS> </OUTPUT>
|
The current implementation of EEM is not operating on the displayed XML structure which is only dumped out for the end-user in the EEM Editor. During runtime it is operating on predefined classes for RFC handling with a different hierarchy:
Be Careful
Wrong path, but what you would expect from XML: EXPORT.OUTPUT.SCRIPTS.item.Scenario_ID
Correct Path
To get a correct path, generally ignore OUTPUT and metatag item, which just represents an ABAP table unknown to java.:
Correct path: EXPORT.SCRIPTS.Scenario_ID
Symptom
The EEM Editor might crash with an EXCEPTION_ACCESS_VIOLATION when executing an RFC script.
Reason
The problem is located in the JCO native libraries.
Solution
Configure the EemEditor explicitly to launch with a specified 32bit JDK. For this purpose, add this parameter to EemEditor.ini:
-vm c:/full/path/to/javaw.exe
Symptom
When executing an http script in EEM Editor some requests fail with error message
Variable inplaceEditForm:reference:c0-e6, inplaceEditForm_accordionMenu_expanded_state:reference:c0-e7 is not defined, e.g., because a preceding request did not deliver the expected result.
Reason
The string is a JSON object but handled as a variable. This might happen for example when creating a script for SuccessFactors.
Solution
Create a variable with exactly the same name and value.
Example:
Name
inplaceEditForm:reference:c0-e6, inplaceEditForm_accordionMenu_expanded_state:reference:c0-e7 |
Value
{inplaceEditForm:reference:c0-e6, inplaceEditForm_accordionMenu_expanded_state:reference:c0-e7} |
Symptom
You are recording SAPGUI Script under usage of a F4 help dialog and action dumps with
"Runtime error MESSAGE_TYPE_X has occurred occurs"
Solution
Open the SAPGUI menu HELP => SETTINGS => tab F4 Help
Set Display radio button to "Dialog(modal)"
Symptom
Editor finished execution half way of a replay without any error information. Go to workspace\.metadata\.log,
there is some OOM identified.
Solution
Open EemEditor.ini file and add the following parameters to increase the Java heap size: -XX:MaxPermSize=64m, -Xmx128m
Symptom
You imported a SAPGUI recording into EEM Editor and provided correct logon credentials. A script execution in EEM Editor fails and you get error messages like: "The control could not be found by id. (SAP Frontend Server ):619: wnd1/usr/ctxt2.text"
Reason
There might be several reasons for this behaviour and a step by step analysis is required.
Procedure
Reason
The client plugin (EEM recorder) has a defect.
Solution
Manually eliminate the duplication as long as no official fix is available.
Example:
Recorded parameter
cmd=get_esidcmd=get_esid |
Corrected parameter
cmd=get_esid |
Symptom
In the SOLMAN_SETUP step 'Configure EEM Robots' terminates with the error Operation "getMatchingAgentInfo{urn:EemAdminWsd/EemAdminVi/document}" not supported (interface: "CO_EEM_EEM_ADMIN_VI_DOCUMENT" ...} when clicking on button 'Check Agents'.
Reason
The web service in Java has been enhanced to provide a filter option when searching for robot candidates.
Solution
Execute in SOLMAN_SETUP the activity Create Logical Ports in step Configure Automatically:
Symptom
When deploying or uploading a script that cannot be started on the robot because of missing properties or an error the deployment throws the exception
SOAP:1.001 CX_SY_CONVERSION_OVERFLOW:.An error occurred when deserializing in the simple transformation program /1SAI/....Overflow converting from <java timestamp>.
Reason
The long value of the java timestamp is mapped to an INT4 data element.
Solution
Check in transaction SRT_UTIL in the payload for the real error (e.g. property not found in SecureStore:...) correct it and deploy the script again. The mapping is corrected with 7.1 SP08.
Symptom
Error Message after trying to deploy scripts to robots:
Resolution
This is a known bug in the http service of the SAP J2EE server. SAP Note 1638655 lists the patch levels for J2EE software components that fix the problem.
Work-around: Point the consumer proxy directly to the J2EE dispatcher instead of pointing to the ICM. Procedure:
Symptom
The SOLMAN_SETUP task 'Create Endpoints for communication' fails with message Error during End Point creation.
Reason
The configuration For service definition AI_EEM_LIST_ALL_SCENARIOS could not be generated. There was a problem in after import method when applying the SP.
Solution
Execute the report REPAIR_AFTER_IMPORT to solve the issue and execute the task again.
The context menu in the monitoring UI can contain the following entries:
Symptom
You cannot see any system data in the Monitoring UI or jump-in to E2E Trace is not available.
Background
Executions (Timestamp and steps below) are written with bold letters if system data or a trace is available. If the execution is triggered with a trace level > 0 the text is written in italic letters.
Currently there are 3 types of scripts where system data or traces can be collected/displayed:
1. HTTP Script for SAP J2EE based applications.
System data/traces are only available if tracing has been enabled (Run Script with trace or Set temporary configuration). It is possible to configure so that HTTP log and DSR records are always written. See also Trace Enabling for EEM.
2. HTTP Script for ABAP based application.
System data/statistical records are always available. Detail traces (SQL, ABAP Trace,..) are only available when tracing has been enabled.
3. SAPGUI Script
System data/statistical records are not for all steps available. Detail traces (SQL, ABAP Trace,..) are not possible at the moment.
Solution
When system data/traces are missing (see description above) you can check the following steps:
1 . The parameter "Expire in seconds" of temporary configuration should have a value higher than 60 seconds (default 1800)
2. Is the script assigned to a technical scenario? In setup step 3.3. check that a technical scenario is filled in for the script.
3. Is the extractor running?
Go to work center SAP Solution Manager Administration, in Infrastructure launch the Extractor Framework view. For each technical scenario there is an extractor EEM system data of TechScen
4. Check the log of the extractor.
If there is an error message like
Current SMD Upgrade status does not allow trace collection
the SMD Upgrader must be executed after applying an LM-Service patch.
This can be done in SOLMAN_SETUP -> Basic Configuration -> Step 2.4 (SAP Solution Manager Internal Connectivity) -> Activity: Run Java Upgrader
If there is an error message like
Trace collection failed: 1/0 exceptions occurred during synchronous/asynchronous trace collection.
an error occurred during trace collection in SAP Solution Manager J2EE and you need to check the log viewer of the SAP Solution Manager Java Stack.
- Start the NWA log viewer ( /NWA -> Monitoring -> Logs and Traces -> Show Default trace.
- open the filter and enter: location contains com.sap.sup.admin.e2e.trace and click on 'Apply filter '
Manual Trace Collection
- Get the BusinessTransaction.xml from robot (click the link if you want to analyze the BusinessTransaction.xml within the EEM Editor)
- Open the E2E Trace application from the Root Cause Analysis work center for the Technical System(s)/Scenario you want to collect the trace and paste this id there
- Trigger the server-side trace collection and check the progress and in parallel the default.trc as mentioned above.
Known Problems
1. HTTP Script for SAP J2EE based applications
-HTTP log or DSR records could not be found.
2. HTTP Script for ABAP based application
-ICM HTTP log does not have the correct format.
3. SAPGUI Script
-ABAP Statistic records could not be found because the time difference of Robot and called system is too high.
Symptom
The Monitoring UI does not display any script executions. You just see the deployed scripts with grey icons and status 509 or 109.
Solution
The system does not get any notifications from the robots. There could be several reasons:
In general you should check the SMDAgentApplication.log of the robot if there is an error when sending the notification.
There might be several reasons why the monitoring UI does not start.
You get error messages like 'Cannot retrieve language bundle' or 'Cannot retrieve severity rules'.
When the WSDL has been loaded successfully but further WS calls are failing like in the screen shot then the following points could be the reason: Cannot Retrieve language bundle or severity rules information.
Symptom
Http script runs in error (Editor or Robot) because of an ssl handshake failure
Message in the Editor:
SSL handshake failed, probably due to timeout, please restart the script: Received fatal alert: handshake_failure
In the Log you will see:
handling exception: javax.net.ssl.SSLHandshakeException: Received fatal alert: handshake_failure
Solution
The SSL handshake failure is typically caused because client side (EEM) and web server could not agree on a common https protocol (e.g. SSL3, TLSV1, TLSV1.1, TLSV1.2) or on a cipher suite. There are multiple possible reasons for this:
Just try again ...
Please install Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files. Information on where to get these files can be found in SAP Note 1240081.
Java 6 has only limited support for crypto algorithms, whereas Java 8 comes with a more complete choice. Example: Java 6 does not support TLSV1.1 or TLSV1.2, while Java 8 does. So if the web server requires to use TLSV1.2, the EEM script will fail to execute running on Java 6. Since January 2018 Diagnostics Agents connecting against SAP Solution Manager 7.2 are also supported on SAP JVM 8.1.
As a cross check try if it makes a difference to run the EEM editor with Java 8. See Configure the Java VM for the Editor.
You can also activate a detailed SSL trace by setting the Java VM parameter -Djavax.net.debug=all (in EemEditor.ini). Output will be sent to the console. To make the console visible run the editor with java.exe (instead of the default javaw.exe). See again Configure the Java VM for the Editor.
For Diagnostics Agent communication issues having to do with TLS V1.2 please see the SAP Note 2463712.
Symptom
When executing a script the following exception is thrown:
EXCEPTION
com.sap.smd.eem.executor.MessageException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target[
LinkedList0:
Issuer: CN=Company CA 5, OU=Trust Center Company, O=Company Services GmbH, C=DE
Subject: CN=selfservice-test.portal.Company.de, C=DE, ST=NRW, L=Anywhere, Company GmbH
SerialNum: 8166
Expires: Thu Nov 25 08:25:04 CET 2010
....
Index: 1
LinkedList1:
Issuer: C=BE, O=GlobalSign nv-sa, OU=RootSign Partners CA, CN=GlobalSign RootSign Partners CA
Subject: CN=CompanyCA 5, OU=Trust Center Company, O=Company Services GmbH, C=DE
SerialNum: 40000000001094550f4da
Expires: Thu Feb 07 12:00:00 CET 2013
...
Exception: null
Index: 2
LinkedList2:
Issuer: CN=GlobalSign Root CA, OU=Root CA, O=GlobalSign nv-sa, C=BE
Subject: C=BE, O=GlobalSign nv-sa, OU=RootSign Partners CA, CN=GlobalSign RootSign Partners CA
Solution
At least one of the bold written certificates above must be entered to the truststore (either global truststore or script specific truststore).
Please check 'How to Import HTTP Trust Certificate' to import the certificate.
How to identify which truststores are used and what is contained?
To get information which certificates are already part of which truststores you have to increase the log level of SMDAgentApplication.log of an SMD Agent to Debug and then stop and start the script. This is an extract of the output:
Info com.sap.smd.eem.executor.http.CertificateContext - loadKeyStore: Return the cached key store for file <Agent_path>\exe\sapjvm_5\jre\lib\security/cacerts
Debug com.sap.smd.eem.executor.http.CertificateContext - dumpKeys: TrustedCertificateEntry Subject:CN=VeriSign Class 1 Public Primary Certification Authority ...
Debug com.sap.smd.eem.executor.http.CertificateContext - dumpKeys: TrustedCertificateEntry Subject:CN=Entrust.net...
Info com.sap.smd.eem.executor.http.CertificateContext - loadKeyStore: Return the cached key store for file <Agent_path>\SMDAgent\applications.config\com.sap.smd.agent.application.eem\scripts/<Script_Name>/trustStore.jks
Debug com.sap.smd.eem.executor.http.CertificateContext - dumpKeys: TrustedCertificateEntry Subject:CN=portal-qas.company.de,C=DE,ST=...
Info com.sap.smd.eem.executor.http.CertificateContext - loadKeyStore: Return the cached key store for file <Agent_path>\SMDAgent\applications.config\com.sap.smd.agent.application.eem/trustStore.jks
Debug com.sap.smd.eem.executor.http.CertificateContext - dumpKeys: TrustedCertificateEntry Subject:CN=portal-qas.company.de,C=DE,ST=...
Symptom
You are running a https script which aborts with "javax.net.ssl.SSLException: java.lang.UnsupportedOperationException"
Solution
Check if the script has a valid truststore or if the password for the global password is set.
When the password for the global truststore is not set you can add in eem_admin for the scope global the property
global.truststore.password and set it to eemstore.
Symptom
You are running a script which aborts with "java.net.ConnectException: Connection timed out: connect"
Solution
Check if a proxy is required to reach the url.
Set the properties http.proxy.host and http.proxy.port to the corresponding values and set http.proxy.enable to true.
Depending of the called system it might be required to set properties in different scopes:
Symptom
When executing a https script you get the exception"java.lang.NoClassDefFoundError: javax/crypto/SunJCE_b"
Background
Jce-policy file is not extracted to the lib\security folder of the SAP JVM during the installation of agent 7.11 (SAP Note 1234387), which makes the https doesn't work for EEM.
Solution
Symptom
You created a SAPGUI script which is running correctly in the editor and uploaded it to an EEM Robot where it fails. There might be different kind of errors like:
- RESULT_FAILED Message ... Current window id is wnd[0] while expected window id is wnd[1], please check for popups
Reason
SAPGUI scripts are executed in background on the robot with operating user SAPSERVICE<SID> which cannot interact with desktop. There might be several reasons for an error and a step by step analysis is required.
Procedure
You can change temporally the settings of the service to interact with desktop. Every SAPGUI script execution is then visible when you log on to the robot with the SAPService user.
After the analysis you should change the setting back to its original value.
Symptom
SAPGUI script aborts at step 3 with exception The control could not be found by id
Background
The issue is caused by the configuration of the backend ABAP system in respect to multiple user logons.
A SAPGUI script is recorded after the login procedure; the login procedure is not part of the recording. To handle the logon the EEM Editor automatically adds the necessary steps. During the import it inserts 4 specific steps bevor the “main” the script logic.
From those 4 the steps 1 and 2 handle the regular login. The step 3 and 4 are conditional steps which are automatically inserted by the EEM Editor to confirm the multi login pop-up. That is, to handle the situation, when an active user session already exists and the backend system prompts the user on which actions he wants to take: “terminate the current logon”, “terminate other logons” or the “continue with this logon, without ending any other logon”. The steps 3 and 4 will attempt to select the “continue with this logon” checkbox in the corresponding pop-up window and press the “login”.
However, in some systems multiple login is not allowed (setting profile parameter login/disable_multi_gui_login). In this case the step 3 will always fail. It will try to find that “continue with this logon” checkbox which simple won’t be presented in the backend system. If the system does not allow multiple logons this pop-up has only two checkboxes, and the login will not succeed. All further steps of the script will probably fail either. The error message “FAILED: control could not be found by id” means that the particular “third” checkbox could not be found.
The issue may not occur in the EEM editor and the SAPGUI script work fine. The situation is typically different in the SAP Solution Manager system, if multiple robots are login on the ABAP system with the same user credentials and if by chance two robots/executions happen to run in parallel or shortly one after another.
Solution
To get the script running successfully you have the following options:
Symptom
After upgrading to SAP Solution Manager 7.2 sending a notification fails with the following error message:
[Thread[EEM WsNotifyQueue,5,main]] Error
com.sap.smd.eem.executor.wsnotify.WsNotifierST.doNotification notification call failed for URL https://<solman_host>:<port>/sap/bc/srt/scs/sap/ai_eem_bulk_notification_st?sap-client=XXX (user: SM_EXTERN_WS)
[EXCEPTION]
com.sun.xml.internal.ws.model.RuntimeModelerException: runtime modeler error: Wrapper class com.sap.smd.eem.wsnotifyst.soapfunctions.mc_style.AiEemBulkNotificationSt is not found. Have you run APT to generate them?
Background
The JVM version of the SMD Agent might be too old.
Solution
Check the JVM version of the SMD Agents a version like 6.1.010 is too old. Apply a newer JVM version (e.g. 6.1.076 ) as described in note 1774669 (Diagnostics Agent - How To Switch or Update SAP JVM) or in the wiki page Diagnostics Agent Maintenance Procedures.
Symptom
After upgrading to SAP Solution Manager 7.2 sending a notification fails with the following error message:
[Thread[EEM WsNotifyQueue,5,main]] Error com.sap.smd.eem.executor.wsnotify.WsNotifierST.doNotification notification call failed for URL https://<solman_host>:<port>/sap/bc/srt/scs/sap/ai_eem_bulk_notification_st?sap-client=XXX (user: SM_EXTERN_WS)
[EXCEPTION]
javax.xml.ws.soap.SOAPFaultException: Web service processing error; more details in the web service error log on provider side (UTC timestamp XXX; Transaction ID ...)
at com.sun.xml.internal.ws.fault.SOAP12Fault.getProtocolException(SOAP12Fault.java:214)
at com.sun.xml.internal.ws.fault.SOAPFaultBuilder.createException(SOAPFaultBuilder.java:117)
at com.sun.xml.internal.ws.client.sei.SyncMethodHandler.invoke(SyncMethodHandler.java:108)
at com.sun.xml.internal.ws.client.sei.SyncMethodHandler.invoke(SyncMethodHandler.java:78)
at com.sun.xml.internal.ws.client.sei.SEIStub.invoke(SEIStub.java:135)
at com.sun.proxy.$Proxy39.aiEemBulkNotificationSt(Unknown Source)
Or
javax.xml.ws.soap.SOAPFaultException: SRT: Serialization / Deserialization failed
at com.sun.xml.internal.ws.fault.SOAP12Fault.getProtocolException(SOAP12Fault.java:210)
at com.sun.xml.internal.ws.fault.SOAPFaultBuilder.createException(SOAPFaultBuilder.java:125)
Background
With older versions of the EEM Editor it was possible to create scripts with step names longer than 40 characters. In 7.20 the SOAP runtime throws an exception if the step name is too long.
In SRT_UTIL you can find an error like:
Data loss occurred when converting Step with a very long name 123456789012345678901234567890
Solution
Import the script in a new EEM Editor and reduce the length of the step names.
Symptom
Sending a notification fails with the following error message:
com.sap.smd.eem.executor.wsnotify.WsNotifier - doNotification: notification call failed for URL http://../sap/bc/srt/scs/sap/ai_eem_bulk_notification?
EXCEPTION
javax.xml.rpc.soap.SOAPFaultException: Processing Error. More details in WS Error Log (transaction SRT_UTIL) by selection with UTC timestamp
at com.sap.engine.services.webservices.jaxrpc.wsdl2java.soapbinding.MimeHttpBinding.buildFaultException(MimeHttpBinding.java:747)
In SRT_UTIL you see this error message:
<EXCEPTION_INFO>
<TYPE>CX_INVALID_TRANSFORMATION</TYPE>
<ERROR_TEXT>The transformation /1BCDWB/WSSBED2302F1E3963004DA could not be executed</ERROR_TEXT>
<CX_SOAP_CORE>
<E_LOCATION>
<CLASS>CL_SXMLP_DATA_ST==============CP</CLASS>
<METHOD>CL_SXMLP_DATA_ST==============CM004</METHOD>
</E_LOCATION>
<E_TEXT>CX_INVALID_TRANSFORMATION:An exception with the type CX_INVALID_TRANSFORMATION occurred, but was neither handled locally, nor declared in a RAISING clause.The transformation /1BCDWB/WSS<...> could not be executed
</E_TEXT>
Background
It can happen that, e.g. after an upgrade, some transformations seem to have disappeared:
Meta data still exists (and the contents of the transformation can be displayed in Transaction STRANS) but the TRDIR entry is missing.
Solution
Apply note 1390832. The note contains report RS_RETRIEVE_XSLT which must be run afterwards in order to re-create some missing transformation programs.
Symptom
java.lang.RuntimeException: No implementation for SHA or MD5:
java.security.NoSuchProviderException: no such provider: IAIK
#at
com.sap.smd.eem.wsnotify.bulk.AI_EEM_BULK_NOTIFICATION_Stub
Solution
Follow the description to enable SSL for WSnotify.
Workaround
Revert to http.
Symptom
EEM Robot does not show sapgui as supported protocol
Solution
The EEM robot tries to access the SAPGUI scripting object as test whether SAPGUI scripts can be supported on the robot. Possible reasons for not supporting SAPGUI scripts:
Missing Data in Reporting
Even there are executions in the monitoring UI there are no entries available in reporting.
There might be several reasons for this behaviour.
As all other technical monitoring use cases EEM has three different kind of roles for configuration, first level support (L1) and second level support (L2). More details about these roles can be found in the Security Guide
This role is required for all configuration tasks of EEM in SOLMAN_SETUP as well as uploading roles from the EEM Editor to the EEM Repository.
The role can be assigned or a dedicated user with this role can be created in SOLMAN_SETUP -> Basic Configuration -> Create Configuration user (Step 8).
This role is required for using the EEM Monitoring UI or the Alert Inbox. With this role the user has just display authorizations. It is not possible to trigger any trace in the Monitoring UI or confirm an alert in the alert inbox.
The role can be assigned or a dedicated user can be created in SOLMAN_SETUP -> Technical Monitoring -> End-User Experience -> Standard Users (Step 7).
This role is required for using the EEM Monitoring UI or the Alert Inbox. With this role the user can trigger an extra execution (with trace) in the Monitoring UI or confirm an alert in the alert inbox.
The role can be assigned or a dedicated user can be created in SOLMAN_SETUP -> Technical Monitoring -> End-User Experience -> Standard Users (Step 7).
The network traffic depends on the type and number of scripts deployed to the robot and the frequency of script execution:
You can check the exact data volume in the EEM Editor looking at the replay. For each message bytes sent/received is reported.
Yes, to replay SAPgui-based EEM Scripts the scripting parameter has to be activated on the system. In some cases it is not possible to enable SAP GUI Scripting for lack of a dedicated application server. This implies that users who are allowed to use SAP GUI Scripting work on the same server as others, so the support cannot be enabled for the server. The problem can be solved by setting the rights to run SAP GUI Scripting per user. As in the previous chapter the profile parameter sapgui/user_scripting needs to be set to “TRUE”. The new profile parameter sapgui/user_scripting_per_user allows the administrator then to enable SAP GUI Scripting support for specific users. Unless the administrator explicitly changes the value, this parameter is set to “FALSE”. If the profile parameter is set to “TRUE” the following happens:
Basically you need two users in SAP Solution Manager 7.01:
A dialog user is used for WebDynpro application and for communication from EEM Editor to EEM Repository. The User needs the Role Z_EEM_ADMIN or Z_EEM_DISP or a copy of it.
A communication user is used by EEM Robots to send the notification about a performed EEM script execution to SAP Solution Manager. The communication user needs role SAP_BC_WEBSERVICE_SERVICE_USER. You can create the user before EEM Setup and assign the role via CUA.
Be Careful
You need to set the password during EEM Setup to be able to forward the logon credentials to EEM Robots
With SAP Solution Manager 7.1 all required users can be created out of guided procedure for EEM setup. If you need to build up own roles or use CUA please refer SP corresponding SAP Solution Manager Security Guide which will provide all information what's inside SM_EEM_CONF_COMP and L1 and L2 role.
DB space depends on number of executions and if system data or traces are collected. The required space for each script execution can be estimated as 250 bytes + #Steps * 300 bytes. A script with 10 steps needs in average 3 Kbytes.
When system time is collected you can double the size. Additionally in JAVA schema each execution needs approximately 20Kbytes per execution. When the script is executed with trace flags (e.g. by setting temporary configuration) the size can increase depending on trace level and persisted traces up to Mbytes.
Therefore it is really recommended to check that housekeeping jobs are running correctly. See also the chapter about Housekeeping.
The EEM/UXMon robots act in the system landscape like real users.
To get a realistic end-user experience the user's roles and profiles mustn't differ from real human users.
The only exception is the licensing aspect: As the users used by EEM/UXMon have a technical character they are free of charge in all cases (but for Cloud applications).
Flag them as "Test".
However if possible it is recommended to use service users to avoid regularly password changes. To ensure that script replay with a service user is working correctly it should be recorded already with a service user.
Important: Be aware that Dialog Users and Service Users have a different behavior. Sometimes scripts will not work properly if you use a Service User. SAP Note 1322944 could be interesting in case of issues with SSO ticket.
No, it is designed to monitor a landscape from end-user perspective with a minimized impact on the landscape itself.
As background please consider the image below: The end-user runs the Citrix client on his desktop. This client communicates via the TRDP protocol to the Citrix server / Windows Terminal Server. On this server the actual application like SAP Gui or the browser is executed. The communication protocol between the application running on the Citrix server (and being displayed in the Citrix/WTS client) is then typically http or the SAP Gui protocol.
EEM does not support the Citrix/RDP protocol and an EEM Script cannot execute actions that are accessed via the Citrix protocol. But you can put an EEM Robot close to the Citrix Farm to monitor if the farm is able to access the SAP backends with a good performance therefore regard Citrix as a "long monitor cable". On one hand a performance issue between the end user and the Citrix farm cannot be monitored with this setup. On the other hand it is helpful to know that the issue is neither between Citrix farm and SAP nor inside the SAP landscape.
A technical scenario of type End User Experience (END_USR_EX) is required for full integration of interactive reporting, Root Cause Analysis and Workmode management. See also Technical_Scenarios.
It is the other way round. SAP End-User Experience Monitoring benefits from the integration of the E2E trace Analysis and its SAP Passport Technology in the EEM work flow.
To point it out shortly: EEM uses the Root Cause Analysis but is much more than that due to the pro-active character of EEM.
Yes, a single Robot can execute several different EEM Scripts against different productive SAP Systems. Of course the network configuration and firewall settings have to allow the contact between EEMRobot and Server.
EEM Robots are a re-use of the well introduced SMD Agent technology. From a technical point of view a EEM Robot is an Application (Aglet) running on an ordinary SMD Agent. A difference maybe the location of the EEM Robot. While a SMD Agent used for "Diagnostics in SAP Solution Manager" is situated close to the back-end, the EEM Robot runs close to the client-side/end-user in a SAP landscape.
The SMD Agents in the use-case of a Diagnostics Agent for root cause analysis could do the job of a EEM Robot, too. This setup may only be useful for test purpose. For a productive End User Experience Monitoring Infrastructure it is recommended to install a standalone SMD Agent as EEM Robot close to the real end users to be able to get monitoring data from their perspective.
HTTP scripts can be created by recording from a browser session by using the "EEM recorder mode" of the SAP Client Plugin (called EEM Recorder in this mode). Only Microsoft Internet Explorer is supported for EEM recording. More details on the currently supported browser versions and operating systems are mentioned in SAP Note 1435190. Note that other clients supported by the SAP Client Plugin for E2E Trace are typically not supported for EEM recording.
RFC scripts can be recorded from the "Business Explorer" (BEx) via the EEM Recorder. See also HowTo section EEM_Scripts_for_RFC.
SAPGUI scripts are recorded using the built-in recording functionality of SAPGUI for Windows. See also HowTo section SAPGUI Scripting.
In addition all types of scripts can be created manually from scratch, e.g. using wizards in the EEM Editor.
Currently http/https, SAPGUI, RFC, and Webservice EEM Scripts are supported. A mixture of different protocol types in one script is not possible.
EEM supports HTTP basic authentication, certificate based authentications as well as NTLM authentication.
www-authenticate: Negotiate (SPNEGO) is supported for both Kerberos and NTLM as of SAP Solution Manager 7.2 SP03.
Direction EEM Robot -> SolMan
Direction SolMan -> EEM Robot
It is recommended to install one EEM Robot per important business hotspot.
The prerequisites are derived from the underlying Diagnostics Agent. Diagnostics Agent installation guidance is available in SAP Note 1365123.
Some special requirements for EEM are:
There a several possible reasons for this behavior:
In general it is not a good idea to compare manual tasks with EEM Robot activities. The good news is that EEM results are comparable under each other, showing extreme low deviations.
In general the prerequisites as mentioned above in What is required to get E2E Traces from EEM Monitoring UI? must be fulfilled.
For all scripts executed against a SAP J2EE engine tracing must be enabled for a given time frame. Either or with 'Run script with trace' or 'Set temporary Configuration'. The time frame itself can be maintained in the eem_admin application on tab 'UI configuration' (for SAP Solution Manager 7.01) or via the monitoring UI -> Button Administration -> Temporary Configuration. See also Troubleshooting: Missing System data or traces
There are two possibilities to get E2E Traces from the EEM Monitoring UI of a tuple of EEM Script and Robot as shown in the image below:
This option triggers an additional immediate execution with the trace level configured in the Admin UI under the tab UI configuration.
This option will set the trace level for the scheduled executions in the time frame that is configured in the Admin UI.
Both options will enable the trace if user has authority before executing the script.
To get the E2E Trace integration working you need:
Hint: The term Involved Systems is just a group of systems and starting with Solution Manager 7.10 it is named Technical Scenario.
Remark: For SAPGUI scripts you just get statistical data but no detailed traces like SQL Trace.
Other components that are writing Introscope transaction traces (like Tomcat, BOBJ, SMP,...) do not need a trace enabling. They react on flags in the SAP Passport. When flag/bit 7 is set (representing the decimal value 128) the transaction trace is send to the Introscope Enterprise Manager from where the E2E Trace application can collect them.
As a consequence if transaction traces should be collected permanently for the EEM script the property trace.e2etracelevel should have the value 128.
The style how script executions are displayed indicates whether detailed system data or traces are available. Bold written executions means system data has been collected. System data is read by E2E Trace application in form of statistic records. There is no overhead during script execution. Statistic records are written be default for each dialog step for ABAP systems. For SAP J2EE engine only if tracing has been enabled. See also What is required to get detailed times of system components in EEM Monitoring UI?
Italic written script executions means the script execution contains trace flags (>0) which might have an impact on response time. See also What is required to get E2E Traces from EEM Monitoring UI?
Bold Italic written script execution means script execution contains trace flags (>0) and Trace data has been collected.