Before you Begin

This tutorial guides you through deploying an Oracle Real User Experience Insight instance in Oracle Cloud Infrastructure (OCI) Marketplace as well as capturing ethernet traffic in OCI on a web server instance. The time to complete the RUEI deployment tasks is approximately 30 minutes.


Oracle Real User Experience Insight (RUEI) monitors real-user experience, set Key Performance Indicators (KPIs) and Service Level Agreements (SLAs), and sends alerts when the thresholds are reached.

Key Capabilities of RUEI

  • Determine which parts of your application are creating performance issues; analyze each page, object, and argument to see how different components contribute to the overall response time.
  • Allows you to review complete user sessions based on user-id or IP address for a specified timeframe. You can easily identify any user session and review all interaction the user had with your application.

On OCI Marketplace, RUEI is configured with a single Instance repository, deployed in a single VM instance, and the data is persisted in the block storage volume:

Description of the illustration ruei_on_oci_deployment.png

What Do You Need?

Perform Prerequisites

Before deploying Oracle Real User Experience Insight, review the following information and perform all prerequisite tasks described below.

  1. Review licensing requirements and ensure you have the appropriate licenses for the environment you are going to manage. The Oracle Real User Experience Insight licensing information is available in the Enterprise Manager Licensing Information User Manual.
  2. As a user with Oracle Cloud Administrator permissions, create a Virtual Cloud Network (VCN) with subnets.
    If using public subnets, you access your instance over the internet using its public IP address, so your route tables will direct traffic to an internet gateway. In this case, create your VCN with Public Subnet and Internet Gateway elements. For more information, see Creating Virtual Cloud Networks.

    If using private subnets, you need to complete a few extra tasks:
    •  Create a Service Gateway in your VCN. For information on creating service gateways, see Access to Oracle Services: Service Gateway.
    • Create a routing table with a Route Rule that has the Target Type the Service Gateway created above.
    • Add the Egress rules on the Default security list with the service you just created. 

For information on VCN's, see VCNs and Subnets.

  1. Update the default Security List of the VCN and add the following Stateful Ingress rules:
    Stateful Ingress Rules
    Destination Port Range Protocol Type Service
    22 TCP SSH
    80 TCP Web HTTP
    443 TCP Web HTTPS
      L2TP L2TP Tunnel

    For more information on  Security Lists for further details.

  2. Create the SSH public key that will be used to access the Enterprise Manager instance. See Creating a Key Pair for further details.

Deploy RUEI

You are now ready to deploy RUEI.

  1. Sign in to OCI and from the OCI main menu, navigate to Marketplace. From All Applications, search for Oracle Real User Experience Insight 13.4. Click on the returned search result.
    Description of the illustration ruei_deploy_step1.png
  2. Select the package version and compartment, accept the terms of use, and click Launch Stack.
  3. On the next page, optionally change the name and specify a description and then click Next.
    Description of the illustration ruei_deploy_step3.png
  4. In the General Settings section, select the Region, Target Compartment and The Availability Domain in Which to Create Resources.
    Description of the illustration ruei_deploy_step4.png
  5. In the RUEI reporter details section, enter the RUEI Password, select the RUEI Instance Shape, and enter the SSH Public Key. As mentioned in the Perform Prerequisites section, you will need the SSH key in order to access the RUEI instance. For more information on how to create SSH keys, see Creating a Key Pair.
    Description of the illustration ruei_deploy_step5.png
  6. In the Networking details for RUEI and Oracle Database section, select compartment, and the VCN and subnet you created above. Click Next.
    Description of the illustration ruei_deploy_step6.png
  7. Review the configuration and click Create. The Create job takes a few minutes to complete.
    Description of the illustration ruei_deploy_step7.png
  8. Once complete, you're ready to open RUEI. Click Stack Details from the breadcrumb path. The Application Information tab appears.
    Description of the illustration stack_details.png
  9. From the Application Information tab, click on the RUEI reporter system URL under Resources Access Information.
    Description of the illustration ruei_deploy_step9.png

Establish RUEI Web Connectivity

RUEI monitors web applications by analyzing in real time and non-intrusively the ethernet network traffic to and from web application servers using its Network Protocol Analyzer (NPA) Collector. To enable this analysis, you need to capture ethernet traffic in OCI on a web server instance and transport it to the instance with the RUEI NPA Collector using a Virtual Ethernet Network TAP and a Layer 2 Tunneling Protocol (L2TP) tunnel. 

For instructions on setting up RUEI traffic monitoring, see Setting Up Virtual Network TAP and a Layer 2 Tunneling Protocol (L2TP).

Want to Learn More?