16 Monitoring Business Applications

This section describes how you use Oracle Enterprise Manager to monitor Business Application performance.

A Business Application is an Enterprise Manager target that represents a logical application; for the user, it defines a unit of management. A Business Application is composed of RUEI applications. Using the Enterprise Manager Console, you view a Business Application to access RUEI and information about the application's supporting infrastructure: the hosts and servers where the application services are executing.

You cannot use Enterprise Manager to create RUEI applications. That work must be done using the RUEI products, which were introduced in previous chapters. You must complete the steps described in Setting up End-to-end Monitoring, to be able to set up Business Application monitoring. You must also complete the tasks described in Prerequisites and Considerations.

Note:

This chapter covers the following:

16.1 Introduction to Business Applications

By using Oracle Enterprise Manager to monitor your Business Applications, you can make sure that your applications are performing at their peak and that end users are satisfied with their performance.

The use of Business Applications offers a number of significant advantages over traditional IT-centric approaches that only focus on system health issues. In particular, Business Applications:

Allow you to manage your applications in their business context, measuring, and alerting on the basis of the end-users' experience.
Provide customizable dashboards with complete visibility across multi-tier composite applications.
Provide a visualization of all target relationships within a business service.

16.1.1 Systems, Services, and Business Applications

Within Oracle Enterprise Manager, there are two types of targets: systems and services. A Business Application is an aggregate service target that can be associated with a minimum of either a system target or a sub-service.

System Targets

Consider an example business application that contains an order entry application implemented by a collection of physical (system) resources. The application is deployed in a Web Logic domain modeled as a system target whose members are the individual managed servers. The Business Application could include transactions deployed in containers. Each of these containers is an application server, possibly within a single Web Logic domain. In this case, the Web Logic domain is a system target. (In the case that the transaction spans multiple domains, it is recommended that you create a composite application within Oracle Enterprise Manager.)

System monitoring provides insights into the behavior of the monitored application infrastructure. It collects metrics and reports on the health of all components from the hosts to the application servers and the deployed Java EE applications. It also provides deep-dive diagnostics tools for the application servers and the databases.

Sub-services

You can define a service by creating one or more tests that simulate common end-user functionality. You can also define services based on system targets, or on both system and service tests. You can then use these services as sub-services to define a Business Application. For more information on services, see the Enterprise Manager Cloud Control Administrator's Guide.

Business Applications

A business application can be associated with a mix of system targets and sub-services, monitoring them to determine the business application's availability.

For system targets, you can specify which key components within a system target should be monitored to determine the business application's availability. For instance, for a transaction, the key components will be the servers where the services that comprise the transaction are running.

16.1.2 MyBank: An Example Business Application

To illustrate the nature of a Business Application, consider the situation in which end users access a banking application (MyBank) that allows them to perform such tasks as the payment of bills. This business application is delivered through the infrastructure shown in Figure 16-1.

The end-user experience of the MyBank business application is monitored through RUEI, while Key Performance Indicators (KPIs) are used to monitor its key aspects, such as the availability and performance of the logon page, and the number of errors in transfer responses and online payments.

Figure 16-1 The MyBank Business Application

Description of "Figure 16-1 The MyBank Business Application"

Proactive application monitoring is achieved by defining business objectives that set acceptable levels of performance and availability. Within Oracle Enterprise Manager, these business objectives are referred to as Service Level Agreements (SLAs) and are composed of Service Level Objectives (SLOs) that measure specific metrics.

Insight into each of these key aspects of a business application's operation and delivery is available through a number of dedicated regions of the Oracle Enterprise Manager console.

16.2 Prerequisites and Considerations

This section describes the requirements that must be met and the issues that should be considered to use the Business Applications facility. It is strongly recommended that you carefully review this information before proceeding with the creation of business applications.

Note:

It is recommended that you review the My Oracle Support website to obtain up-to-date information about the supported RUEI as well as patches, configurations, known issues, and workarounds.

This section covers the following:

Requirements for Using RUEI

16.2.1 Requirements for Using RUEI

To use RUEI to monitor the performance of your Business Applications, you must ensure that the following requirements have been met:

RUEI version 12.1.0.7 (or higher) has been installed and configured to monitor the required applications, suites, and services. Information about deployment options and requirements is available from the Oracle Real User Experience Insight Installation Guide.
The Enterprise Manager for Oracle Fusion Middleware plug-in must be deployed to both Oracle Management Service (OMS) and to each Management Agent monitoring the business application targets.

For details on deploying the plug-in to OMS, see the "Deploying Plug-Ins to Oracle Management Service" chapter in the Enterprise Manager Cloud Control Administrator's Guide.

For details on deploying the plug-in to a Management Agent, see the "Deploying Plug-Ins on Oracle Management Agent" chapter in the Enterprise Manager Cloud Control Administrator's Guide.
The Reporter system must be accessible to Oracle Enterprise Manager via an HTTPS connection on port 443. Other component host systems (such as Collector, Processing Engine, and database servers) do not need to be accessible to Oracle Enterprise Manager unless you intend to make them managed targets. For more information, see Registering RUEI Systems.
The statistics data retention setting (which governs the availability of statistical information such as violation counters) has been configured to be consistent with your business application reporting requirements. The procedure to do this is described in the Oracle Real User Experience Insight User's Guide.
If you intend to export session information from the Session Diagnostics facility, you should ensure that the exported session is not older than the period specified for the Full Session Replay (FSR) data retention setting. In addition, the URL prefix masking setting should be specified as "Complete logging". For more information, see the Oracle Real User Experience Insight User's Guide.

16.2.1.1 Registering RUEI Installations with Self-Signed Certificates

A RUEI installation can use a self-signed certificate. This is explained in the Oracle Real User Experience Insight Installation Guide. However, Oracle Enterprise Manager only accepts SSL certificates issued by a trusted Certificate Authority (CA), and that contain a valid Common Name (CN). Therefore, in order to be able to register a RUEI installation with Oracle Enterprise Manager, you need to do the following:

Note:

All instructions on the Oracle Enterprise Manager system need to be carried out as the user running the oms and agent.

Verify that the certificate is valid. One way to do this is to attempt to access the Oracle Real User Experience Insight system through a browser via HTTPS and view the certificate details. You should ensure the certificate' s date validity. If the certificate's date range does not include the period your Oracle Real User Experience system is running, you will not be able to use it.
Download the certificate to your Oracle Enterprise Manager system. Many browsers provide an option when creating a security exception for a self-signed certificate to also save the certificate to a file. If you have already approved the security exception in your browser, the following example works in Mozilla Firefox:
1. Click the security icon to the left of the hostname.
2. Click More information, then click View certificate.
3. Select the Details tab and click Export.
The exported file should be copied to your system running Enterprise Manager. The examples below assume that you stored the file containing the certificate in ~/ruei.cert.

A more direct way to download the certificate to your Oracle Enterprise Manager system can be carried out on the system itself. Issue the following commands on the Oracle Enterprise Manager system:
```
     openssl s_client -showcerts -connect <RUEI_REPORTER_HOST>:443 </dev/null \
        | openssl x509 -inform PEM  > ~/ruei.cert
```

Add the certificate to the keystore. Within Oracle Enterprise Manager, two components are used to communicate with a RUEI system via SSL: one for polling the status of RUEI, and one for the communication with RUEI. Both keystores need to contain the same certificate. Issue the following commands on the Oracle Enterprise Manager system:

Agent:

cd <agent instance home>/bin
./emctl secure add_trust_cert_to_jks \
[-password <keystore password, default "welcome">] \
-trust_certs_loc ~/ruei.cert -alias <unique alias>

OMS

<path_to_Oracle_WT>/jdk/bin/keytool -import \ 
-keystore <path_to_wlserver_10.3>/server/lib/DemoTrust.jks \
-file ~/ruei.cert -alias <unique alias> -storepass DemoTrustKeyStorePassPhrase

In order for Oracle Enterprise Manager to work with the new certificate, perform a bounce of the OMS and the AGENT. Issue the following commands:

<OMS oracle home>/bin/emctl stop oms -all
<OMS oracle home>/bin/emctl start oms
<AGENT oracle home>/bin/emctl stop agent
<AGENT oracle home>/bin/emctl start agent

16.3 Registering RUEI Systems

Before you can create Business Applications based on RUEI-monitored applications and services, you must first register the appropriate RUEI with Oracle Enterprise Manager.

Note:

You must have Super Administrator privileges in order to access the Middleware Management Setup page.

With Enterprise Manager 13c, there is a new service level target, called an End User Service (EUS) corresponding to each RUEI Application, Suite or web service. The EUS has the same name as the RUEI Application, Suite or web service, and is used to create a business application. A synchronization job is automatically created to maintain End User Services (EUS) entry details corresponding to each RUEI Application/Suite. For more information on jobs, see the Enterprise Manager Cloud Control Administrator's Guide. If you later create a new RUEI Application, Suite or web service, you may need to run the job manually as described in Troubleshooting an End User Service.

Note:

To successfully register a RUEI system, make sure that the Enterprise Management Repository database instance target is properly registered as described below, and that the database instance target has associated monitoring credentials with the SYSDBA role. These credentials are required so that KPIs from RUEI can be monitored by Oracle Enterprise Manager.

During a typical installation of Enterprise Manager, the database instance target for the management repository is not fully registered automatically. The database is auto-discovered by Enterprise Manager but must be promoted as described in the Discovering and Adding Database Targets chapter of the Enterprise Manager Administrator's guide. Use the appropriate section instructions for your database setup, for example, Discovering and Adding Single Instance Database Targets or Discovering and Adding Cluster Database Targets.

From the Setup menu, select Middleware Management, then select Setup. The Setup page shown in Figure 16-2 appears. The currently registered systems are listed.

Figure 16-2 Middleware Management Setup

Description of "Figure 16-2 Middleware Management Setup"
Select Real User Experience Insight System from the Add drop down. A page similar to the one shown in Figure 16-3 appears.

Figure 16-3 Discover RUEI System Page

Description of "Figure 16-3 Discover RUEI System Page"

Note:

You can register more than one RUEI system.
Specify the host system where the Reporter system is located. Click Select Target. A new window opens that allows you to view the available systems. You can use the Target Type menu to search for specific target types.
Specify the port number for communication with the RUEI Reporter, for example 443.
Specify a secure connection for communication with the RUEI Reporter. Only use an insecure connection for testing purposes.
Specify a valid user name and password combination. For a RUEI system, the specified user must have Oracle Enterprise Manager access permissions. Note that Oracle SSO authentication for this user is not supported. The Security Officer privilege is also recommended to allow downloading of sessions and the showing of replay details in the Enterprise Manager UI. With this in place, Enterprise Manager will be able to retrieve this data. Moreover, additional (per-end-user) Enterprise Manager roles will be applied to reveal session-zip download and content-download buttons.
Optionally, specify a string to be attached to the RUEI system name.
Specify the host and port of the Management Agent to be used to collect metric information about the system. If it is managed by Oracle Enterprise Manager, you can click Select to specify it.
Click Test Connection to verify whether a working connection to the RUEI system can be made.

Note:

A secure connection to a RUEI installation fails if you have not completed the process described in Registering RUEI Installations with Self-Signed Certificates.
Click Discover. An overview of the components and End User Services associated with the selected system is displayed. An example is shown in Figure 16-4.

Figure 16-4 Discover RUEI Instance: View Targets Page

Description of "Figure 16-4 Discover RUEI Instance: View Targets Page"

For RUEI systems, you also need to enter credentials to enable incident communication from RUEI in a section of the screen labelled Edit Incident Alert Credential.

In the Oracle RUEI Wallet Credentials section, enter the RUEI Wallet password. Click Test to make sure you have entered the password correctly.
Click Add Targets to have each of the system's components become a managed target within Oracle Enterprise Manager. Note that if you do so, each system must be accessible to a Management Agent. Further information about managed targets is available from the Oracle Enterprise Manager Cloud Control Administrator's Guide. If you need to edit any of the credentials you specified above, you can select the target and click the Configure button to display a screen that will allow you edit the values.

16.3.1 Setting Up a Connection Between RUEI and the Oracle Enterprise Manager Repository

The following procedure describes setting up a connection so that KPIs from RUEI can be monitored by one or more Oracle Enterprise Manager instances. This procedure can be used for the following situations:

After changing Enterprise Manager hostname
After changing the sysman user credentials
After changing the TNS settings of the Enterprise Manager database
Correcting issues with initial KPI setup

From the Setup menu, select Middleware Management, then select Setup. The page shown in Figure 16-2 appears. The currently registered systems are listed.
Select the RUEI system you would like to set up and click Configure. The RUEI Setup Page appears.
Select the Edit credential tab and click Edit. The RUEI Setup page shown in Figure 16-5 appears. Enter the appropriate RUEI wallet password, this is typically specified while setting up the RUEI repository.

Figure 16-5 RUEI Credentials

Description of "Figure 16-5 RUEI Credentials"

Note:

If you change the RUEI wallet password, you must edit the Enterprise Manager RUEI credential on this screen to maintain the RUEI connection. Do not edit using Enterprise Manager named credential feature for EUS_ENGINE_USER.
On the RUEI host, configure RUEI to use the mkstore utility:
1. Determine the location of the mkstore utility. This utility is included with the Oracle Database and Oracle Client runtime. In both cases, it is located in $ORACLE_HOME/bin/mkstore.
2. Edit the /etc/ruei.conf file and add the following line, where mkstore_location is the path determined in the step above:
```
export MKSTORE_BIN=mkstore_location
```
3. Restart RUEI by selecting System, then Maintenance, and then System reset. Select Reapply latest configuration option and click Next to apply the changes you have made.

16.4 Creating Business Applications

To create a Business Application, you need to specify the RUEI-monitored applications, suites, and services, upon which it is based. You are not required to include both RUEI applications in a Business Application.

Do the following:

From the Targets menu, select Business Applications. The currently defined Business Applications are displayed. The page (partially) shown in Figure 16-6 appears.

Figure 16-6 Business Application Page

Description of "Figure 16-6 Business Application Page"
Click Create. The page shown in Figure 16-7 appears.

Figure 16-7 Create Business Application (Name) Page

Description of "Figure 16-7 Create Business Application (Name) Page"
Specify a unique name for the new business application. It is recommended that you include an indication of the purpose and scope of the business application as part of the name. Do not accept the default name, which is invalid if it contains either of the < or > characters. Note that business applications cannot be renamed later. When ready, click Next. The page shown in Figure 16-8 appears.

Figure 16-8 Create Business Application (End User Service Associations) Page

Description of "Figure 16-8 Create Business Application (End User Service Associations) Page"
Click Add. A new window opens that allows you to select one or more End User Services upon which the business application should be based. There is an End User Service item corresponding to each RUEI application/suite. You can multi-select from the list. When ready, click Next. The page shown in Figure 16-9 appears.

Figure 16-9 Create Business Application Page

Description of "Figure 16-9 Create Business Application Page"
Click Add. When ready, click Next. The page shown in Figure 16-10 appears.

Figure 16-10 Create Business Application (System) Page

Description of "Figure 16-10 Create Business Application (System) Page"
Click Select System and select the system that hosts the business application. This should be a system that encompasses the infrastructure that the business application runs on.

When ready, click Next. The page shown in Figure 16-11 appears.

Figure 16-11 Create Business Application (Service Association) Page

Description of "Figure 16-11 Create Business Application (Service Association) Page"
Click Add. A new window opens that allows you to select the service upon which the business application should be based. When ready, click Next. The page shown in Figure 16-12 appears.

Figure 16-12 Create Business Application (Review) Page

Description of "Figure 16-12 Create Business Application (Review) Page"
Review the new business application's properties before creating it. If necessary, use the Back and Next buttons to amend its properties. When ready, click Create Business Application. The newly created Business Application home page (Figure 16-13) appears in personalization mode, allowing you to rearrange the regions or add new regions.

16.5 Monitoring Business Applications

Once a Business Application has been created, you can use the Business Application home page to monitor its performance and availability, as well as the status of the systems (hosts, databases, and middleware components) that support it.

It is also from the Business Application home page that you can access more detailed information about RUEI components:

To get more information about RUEI components, select one of the End User Service related views from the Business Application drop down menu. See Monitoring End User Experience.

Note:

If there are timeout issues associated with monitoring the Business Application, you can set the APM_WEBSERVICE_CREATE_TIMEOUT system property in the Enterprise Manager WebLogic configuration to a value appropriate to your network configuration, for example 60 seconds.

To view the Business Application home page, do the following:

From the Targets menu, select Business Applications. The currently defined business applications are listed. An example is shown in Figure 16-6.

In addition to the names of existing Business Applications, this page also provides summary information about status, system, RUEI metrics, and RUEI KPIs. Use the View > Columns menu option to add or delete columns to this display.

You can also click across to view information about system targets by clicking on one of the names listed in the System pane.
Click the Business Application of interest. The home page for the selected Business Application is displayed. An example is shown in Figure 16-13.

Figure 16-13 Business Application Home Page

Description of "Figure 16-13 Business Application Home Page"

Each region provides specific information on the various operational aspects of the selected business application. By default, the following regions are available:

General: indicates its status, availability and health.
Incidents and Problems Overview: Count of incidents and problems across different categories such as severities or target types.
Component Status: indicates the availability of the components that deliver the business application and the history of the current status. Expand the displayed tree to show status for systems, services and service tests. Click an item for further detail.
SLA Status: indicates the status of the Service Level Agreement if an SLA is configured.
RUEI - Geographic Location Overview: displays RUEI metrics on a geographic map. You can select which metric you would like to view and restrict the data to a region.
RUEI - Key Performance Indicators (KPI): indicates the status of the KPIs defined for the applications, suites, and services associated with the business application.
RUEI - Usage and Violations Overview: displays a chart of issues to help you isolate issues by page.
Weblogic - Most Requested: displays the most requested services over the last 24 hours. Click a tab to view the services of a particular type, for example RESTful Services.

In addition to the default regions, more regions can be added by clicking the Personalize Page icon, including regions relating to JVM, RUEI and SLA activities. In this mode, you can also rearrange the regions.

Note:

A Business Application is an aggregate service as explained in the Configuring and Using Services chapter of the Enterprise Manager Cloud Control Administrator's Guide.

16.6 Monitoring End User Experience

The Business Application drop down menu, accessible from the Business Application home page, includes the following options for the End User Experience item:

End User Experience data, whose contents are described in Monitoring End User Experience Data.
Session Diagnostics, whose contents are described in Monitoring End User Experience Data.
Metrics, whose contents are described in Monitoring End User Experience Metrics.

As discussed in Creating Business Applications, a business application can consist of an End User Service which corresponds to the application or suite being monitored by RUEI. If you monitor a End User Service directly, as described in Monitoring an End User Service the End User Service drop down menu, accessible from the End User Service home page, includes the following options for the End User Experience item:

Session Diagnostics, whose contents are described in Working With Session Diagnostics.
Metrics, whose contents are described in Monitoring End User Experience Metrics.
User Flows, whose contents are described in Monitoring User Flows.

16.6.1 Monitoring End User Experience Data

Selecting the End User Experience Data option from the Business Application > End User Experience menu, displays a page that includes Key Performance Indicators, Usage Data and Violations Data tabs.

16.6.1.1 Key Performance Indicators

When displayed, the page shows the KPIs and Users Flows data from RUEI.

Note:

In order to view KPI alerts within Incident Manager, you will need to set up a connection between RUEI and the Oracle Enterprise Manager Repository. The procedure to do this is described in Setting Up a Connection Between RUEI and the Oracle Enterprise Manager Repository.

16.6.1.2 Usage Data

When displayed, the page shows the most active users and most executed user requests data from RUEI.

The Top Users region enables you to monitor the most active users of the targets associated with the business application. This includes session and page view information, as well as user and application violation indicators. An example is shown in Figure 16-14.

Use this region to verify the performance of the most popular user requests associated with a business application (such as downloads or payment handlings).

Figure 16-14 Top Users

Description of "Figure 16-14 Top Users"

Selecting a user opens the RUEI Session Diagnostics facility and displays detailed information about the selected user. For more information, see Working With Session Diagnostics.

16.6.1.3 Violations Data

When displayed, the page shows a sunburst chart to illustrate the violations data from RUEI. An example is shown in Figure 16-15.

Figure 16-15 Usage and Violations Overview

Description of "Figure 16-15 Usage and Violations Overview"

The color of a segment indicates the number of violations that are associated with that page. Hover your mouse pointer over a segment to display the exact number or violations associated with the page. Click on the page to use the session diagnostics facility, see Working With Session Diagnostics, Double click on a page to explore the next level of detail available.

16.6.2 Working With Session Diagnostics

The Session Diagnostics facility allows you to perform root-cause analysis of operational problems. It supports session performance breakdown, including the impact of failing pages and hits on sessions, the full content of each failed page, and the relationship between objects, page views, and sessions. Moreover, it offers the opportunity to track exactly what error messages visitors to the monitored website receive, and when. With this ability to recreate application failures, you can identify and eliminate annoying or problematic parts of your web pages.

This section explains the use of the Sessions Diagnostics facility. It covers the following topics:

16.6.2.1 Creating an Enterprise Manager User for Session Diagnostics

With Oracle Enterprise Manager 13c, a new role called EM_EUS_DIAGNOSTICS exists to allow users access session diagnostics data. To create a user with this role:

From the Setup menu, select Security, then select Administrators.
Click Create to create a new user.
On the Properties page, enter a username and password.
On the Roles page, add the EM_EUS_DIAGNOSTICS role to the new user definition.
On the Target privileges, first add the RUEI Reporter engine target, then grant the configure_target privilege.
Review and complete creating the new user.
Log out of Enterprise Manager and log in as the new user you have just created.
To test the user access, use session diagnostics as described below and review the payload message for session activity (camera icon).

16.6.2.2 Getting Started with Session Diagnostics

To locate the diagnostics information you require, do the following:

This item is available on both the Business Application home page and the End User Service home page. Select End User Experience and then Session Diagnostics.
Use the View Data menu to select the required period. Note that the availability of session diagnostics information is determined by the Statistics and Session Diagnostics data retention policy settings specified for the associated RUEI instance. For more information, see the Oracle Real User Experience Insight User's Guide.

Figure 16-16 Session Diagnostics

Description of "Figure 16-16 Session Diagnostics"
Specify the appropriate search criteria to locate the required user record(s). The available default search criteria are controlled by the RUEI instance configuration (described in Customizing Session Diagnostics Reporting). You can click Add Fields to make additional search criteria available. Be aware that while the use of wildcard characters (*) is supported, all other search characters are treated as literals. Also, all criteria specified for the search must be met for matched user records to be reported.

You can specify multiple values for a single dimension by clicking Add Fields, and selecting the required dimension. In this case, only one of the specified values needs to be found in order for a match to be made.

After updating the appropriate search filters, you can save the search combination by clicking Save. Note that changes to saved searches can influence the available fields within the Add Fields facility. In addition, the predefined list of available dimensions is based on the business application definition. For example, only oracle Fusion-specific dimensions are available if the business application is defined as a Oracle Fusion suite.

When ready, click Search. The results of the search are shown in the lower part of the page.

If you specify an ECID as the search criteria and the ECID value refers to a spurious hit then no results are displayed if you also specify a filter relating to a page property, because there is not a page associated with the spurious hit.
Click the user record of interest from the displayed list. Information like the one shown in Figure 16-17 is displayed.

Figure 16-17 Example Session Activity Listing

Description of "Figure 16-17 Example Session Activity Listing"
The overview shows the pages and actions recorded within the selected user record. You can hover your mouse over an icon to see a tooltip. Icons indicate slow or failed objects, page-loading satisfaction, whether replay content is available, and whether clickout is available to JVM Diagnostics to provide activity information. (Clickout capability is shown by the Oracle icon.) The camera replay can show a pop-up with full contents of the hit. This allows access to the original html in full detail. The icons shown in the info column are described under Figure 16-23, for example icon 1 provides a link to associated logs to help debug an issue.
You can click a page or object within the selected user session to open a window with detailed technical information about it. An example is shown in Figure 16-18.

Figure 16-18 Page Properties Window

Description of "Figure 16-18 Page Properties Window"

When replay content is available an icon is displayed in the Session Activity Listing as shown in Figure 16-17. You can click on the icon to open a pop up showing the Replay Content that was recorded. An example is shown Figure 16-19.

Figure 16-19 Full Session Replay

Description of "Figure 16-19 Full Session Replay"

Click the Replay View link in the upper right corner of the screen to be redirected to the RUEI server, where you see the browser view of the Session Replay Content. You might be required to log in to the RUEI server.
The list of matched user sessions shown in Figure 16-16 is based upon the period selected in the View menu. For example, if the period "Last hour" is selected, the list of matched user sessions is based on sessions that were active during that period. However, they may have started or finished outside this period. For this reason, you can use the slider at the bottom of Figure 16-17 to restrict the displayed page views and actions to a more specific period.
Optionally, click Export as Zip to export the session's complete contents to external utilities for further analysis (described in Exporting Full Session Information) or Export as XLs to export a summary of the pages within the session (described in Exporting Session Pages to Microsoft Excel).

16.6.2.3 Customizing Session Diagnostics Reporting

You can control the specific dimensions reported in Session Activity part of the Session Diagnostics for applications, suites and services. To do so:

From the Setup menu, select Middleware Management, then select Setup. The currently registered RUEI instance is shown in the RUEI Systems row of the page shown in Figure 16-2.
Select the required RUEI system. Click Configure. The Edit Dimension Listing page shown in Figure 16-20 is displayed.

Figure 16-20 Edit Dimension Listing Page

Description of "Figure 16-20 Edit Dimension Listing Page"
Use the Application Type menu to select whether you want to modify the dimension listings for generic applications (that is, applications that are not suite-based), services, or suites. If the latter, you will need to specify the suite type.
Use Move and Remove to select the dimensions that should be listed. Once selected, you can control the order in which the item appears in the list. When ready, click Save.

16.6.2.4 Exporting Full Session Information

In addition to viewing session information, you can also export complete session contents to external utilities for further analysis or integration with other data. For example, you could use complete real-user sessions as the basis for test script generation. Test platforms, such as Oracle Application Testing Suite (ATS), can easily be configured to generate automated test scripts for an application's most common usage scenarios.

In addition, this facility can also be used to support root-cause analysis. Complete user session information can be provided to application or operations specialists to help identify unusual or difficult to isolate issues. Sensitive information within the exported data is masked according to the actions defined in the HTTP protocol item masking facility. This is described in the Oracle Real User Experience Insight User's Guide.

To export session information:

Locate the required session, and click Export as Zip.
Depending on how your browser is configured, you are either prompted to specify the location to which the zip file should be saved, or the session is immediately saved to the defined default location.

Important

In order for the session export files to be created correctly, you should do the following:

Ensure that the requirements for exporting session information described in Prerequisites and Considerations have been met.
Verify the exported content files (described in the following section) are present before attempting to import an exported RUEI session into an external utility.

Understanding the Structure of the Exported Data

The exported session zip file contains the following files:

data.tab: contains the direct (raw) hit information for the selected session extracted from the Collector log file.
page.tab: contains the direct (raw) page information for the selected session extracted from the Collector log file.
content_hitno.tab: contains the complete (raw) content information for the indicated hit. There is a file for each hit within the data.tab file that has content. For example, if the third and sixth hits had content available for them, two files would be created: content_3.tab and content_6.tab.

Viewable versions of the files cited in the hit file are also available under the content_viewer directory. This means that data transferred with chunked encoding can be immediately viewed. Note that the same hitno as in the data.tab file is used in their file naming.
index.html: allows developers and other interested parties outside RUEI to view and analyze session details as they would appear within the Session Diagnostics facility, with access to source, page and object details, and element identification.

Note:

The log files used as the basis for creating exported session files are also used internally by RUEI. The format and contents of these files is subject to change without notice.

16.6.2.5 Exporting Session Pages to Microsoft Excel

You can export a summary of the pages within the currently selected session to Microsoft Excel.

Locate the required session, and click Export as XLS. Depending on how your browser is configured, you are either prompted to specify the tool with which to open the file directly (by default, Microsoft Excel), or the session is immediately saved to the defined default location.
Within Microsoft Excel, you can view and edit the generated file. The exported page view history and session summary can be used to compile sets of real-user sessions that could be used as the basis for testing or performance analysis.

Controlling Row Creation and Ordering

Be aware that the rows that appear in the Microsoft Excel export are based on the currently specified RUEI configuration. This is described in Customizing Session Diagnostics Reporting.

16.6.3 Monitoring End User Experience Metrics

As part of Business Application and End User Service monitoring, the End User Experience Metrics page presents a useful overview of user-selectable metrics within a given timespan. These metrics can be counts (for example, page views) or aggregate values (such as, median page load time).

To view the Metrics page, select End User Experience and then Metrics from the Business Application or End User Service menu.

This page allows you to select performance metrics and view their associated average and median data graphically.

The time-period for the data can be set and search filters similar to those on the Session Diagnostics Page allow you to further refine the data returned. Filter settings can be saved for subsequent use. The metrics are displayed in two tabs, Aggregation shows the metric aggregated over time and Instances shows individual events.

Aggregation

On the Aggregation tab the selectable metrics are arranged in an hierarchical tree palette. The list displays a set of items that is appropriate for the configured business application type. This set can expand to include system metrics. For example, if the application associates to a WebLogic server, JVM metrics become available in addition to RUEI metrics. An example of a metrics palette is shown in Figure 16-21.

Figure 16-21 Metric Palette

Note that the individual metrics graphs can be combined into one chart using the graph toolbar. Also some of the listed graphs show data from different parts of the metric palette combined into one chart. In Figure 16-22, the top chart shows graphs for both Median Page Server Time and Median Page Network Time.

Figure 16-22 Sample Metrics Graph

Incident Manager allows you to navigate directly from a KPI event to the Metrics page. In this case, the Metrics page is populated with time and filter settings relevant to the context of the KPI event. Therefore, you can inspect relevant metrics around the offending event, be it in time-period or in filters broader than those that correspond to the original KPI event.

From the Metrics page there is a direct link to the session diagnostics facility. When you click this link, the search properties and time-span will be re-used to find sessions that match the active criteria.

Note:

Selecting median values over a large timespan can impact performance.

Instances

The instances tab displays events filtered using the criteria you set, for example Client Browser = Chrome. If you specify an ECID as the criteria and the ECID value refers to a spurious hit then no results are displayed, because there is not a page associated with the spurious hit. For each item in the results, you can:

Review the Session Activity, timing and user information (if available). Where applicable, you can expand and collapse items to display further detail, for example specific URLs associated with the session activity, or page attributes.
Display session information for the event, see Working With Session Diagnostics.
Review the icons (numbered 1 to 5) for each item where:

Icon 1 provides a link to the log viewer, showing logs associated with the current item.

Icon 2 provides a link to Request Instance Diagnostics, that is, JVM Diagnostics for the current item.

Icon 3 the indicates page loading satisfaction, a tooltip appears displaying the satisfaction level, for example Satisfied.

Icon 4 provides a link to replay content (for example, the original html if available).

Icon 5 provides a link to further session diagnostics, see Working With Session Diagnostics.

Some of the icons shown are the same as those for Session Diagnostics, see Figure 16-16.

Figure 16-23 Incident Icons

16.6.4 Monitoring User Flows

To view the User Flows page, select End User Experience and then User Flows from the End User Service menu.

This page allows you to view user flows defined for the associated RUEI suite/application. User flows indicate the time components when users were active, average page-load time within user flows, idle time, and when users were outside the user flow. For further information, see the Oracle Real User Experience Insight User's Guide.

16.6.5 Monitoring Logs

To view detailed logs, navigate to a session as described in "Working With Session Diagnostics." Then click the icon labelled 1 in Figure 16-23. This displays a screen similar to Figure 16-24.

This page allows you to view log details and search using criteria including ECID, time and session diagnosis ID.

Figure 16-24 Log Viewer

Description of "Figure 16-24 Log Viewer"

16.7 Monitoring an End User Service

With Enterprise Manager 13c, there is a new service level target, called an End User Service (EUS) corresponding to each RUEI Application/Suite. The EUS has the same name as the RUEI Application/Suite, and can used to create a business application as described in Creating Business Applications. It is also possible to monitor an End User Service directly:

From the Targets menu, select Services. The currently defined services are listed. Filter for end user services. Alternatively, you can navigate to the End User Service from the Business Application home page by clicking on the Sub Services tab. The resulting list may include End User Services if the Business Application includes one.
If Fatal/Critical KPI is associated with an application defined in RUEI system, EUS status is also affected by status of associated Critical/Fatal KPI.

If KPI status is changed to down, EUS status will also be changed to down. If Staus is up in Key Components, but EUS staus is down, refer:

You can check the Fatcal/Critical KPI in Incident Manager page,
Click the End User Service of interest. The home page for the selected end user service is displayed. This is very similar to the Business Application home page shown in Figure 16-13.

The End User Service drop down menu, accessible from the End User Service home page, includes the following options for the End User Experience item:

Session Diagnostics, whose contents are described in Working With Session Diagnostics.
Metrics, whose contents are described in Monitoring End User Experience Metrics.
User Flows, whose contents are describe in Monitoring User Flows.

16.7.1 Troubleshooting an End User Service

If you encounter any issues with data from an end user service, consider the following list of checks to troubleshoot the issue:

Refresh the page. If the metrics displayed do not correspond to the metrics configured in RUEI, click refresh the refresh icon on the Enterprise Manager page.
Synchronize the RUEI system target. Navigate to the appropriate RUEI system home page and choose Synchronization from the Configuration menu item.

16.8 Monitoring KPI and SLA Alert Reporting

This section explains the KPI-related information that is available for both RUEI applications.

Note:

To monitor KPI and SLA alerts you must first complete all the steps described in "Setting Up a Connection Between RUEI and the Oracle Enterprise Manager Repository."

The alerts generated by KPIs defined for the applications, suites, and services, as well as for the SLAs for the transactions that comprise your business applications are reported as events in Incident Manager. To view these events:

From the Enterprise menu, select Monitoring, and then Incident Manager.
Open the Events Without Incidents predefined view.
Click the event of interest to view more information about it.

Event detail information varies depending on whether the event is based on a RUEI KPI. This is described in the following sections.

For RUEI related events, you can also access the Events Without Incidents view from the home page of a business application using the Business Application menu. Select Monitoring, then Incident Manager, and Events without Incident. This option shows events in the context of the selected Business Application.

RUEI Event Detail

After accessing the Events Without Incidents view, you will see events listed.

Figure 16-25 Incident Manager

When you click on the RUEI event, you'll see event details at the bottom of the screen in the Guided Resolution region.

Figure 16-26 Accessing RUEI Metrics from Incident Manager

Select RUEI metrics to drill down to the RUEI Metrics page in context of the filters that were set up for the KPI as well as in the time frame of the KPI violation. The RUEI Metrics page will also show the metric that is the basis for the KPI definition.

The status of the KPIs defined for the applications, suites, and services that comprise your business applications are reported in the RUEI - Key Performance Indicators (KPIs) tab.

This provides information about the Business Application associated with the KPI, as well as the metric upon which the KPI is based. Note that for ease of management, KPIs within RUEI are grouped into categories that can be customized to contain related performance indicators. For example, separate categories could be defined for business and IT-related issues, such as user flow completion, visitor traffic, website availability, and so on.

Note:

16.9 Upgrading End User Service

When upgrading from Enterprise Manager Cloud Control 13.2 to Enterprise Manager Cloud Control 13.3, you must perform the following steps:

Remove the RUEI target from Enterprise Manager 13.3c.
Re-register the RUEI target with Enterprise Manager 13.3c.
Verify same functionality as original End User Services in Monitoring an End User Service.

Note:

If you did not create Business Applications in your EM system before upgrade, you can Re-register RUEI target on EM side. But, if you have created Business applications before upgrade, refer to Upgrading Business Applications.

16.10 Upgrading Business Applications

Use the following procedure if you are upgrading Business Applications from Enterprise Manager 12c to Enterprise Manager 13c or Enterprise Manager 13.2c to Enterprise Manager 13.3c , and that Business Application has a RUEI connection:

Document the details of Enterprise Manager association information with RUEI (the Business Application) before upgrading to Enterprise Manager.
Remove the RUEI target from Enterprise Manager.
Re-register the RUEI target with Enterprise Manager to ensure the discovery of End User Services targets.
Create a new Business Application using the details from step 1.
Verify that the Business Application provides the same functionality as the original Business Application.
Delete the original Business Application before upgrade.