From 5191652c9e4f3aaa3b7f559fcac0a61d8bd82e80 Mon Sep 17 00:00:00 2001
From: Kimberly <106996346+kimberlyand@users.noreply.github.com>
Date: Fri, 5 Jan 2024 11:52:23 -0500
Subject: [PATCH] Create README.md

Video demonstration on how to set up a Real User Monitoring for an APEX website in Application Performance Monitoring on Oracle Cloud.
---
 .../oracle-database/APEX/apm/README.md        | 60 +++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 knowlege-content/oracle-database/APEX/apm/README.md

diff --git a/knowlege-content/oracle-database/APEX/apm/README.md b/knowlege-content/oracle-database/APEX/apm/README.md
new file mode 100644
index 0000000..fa51813
--- /dev/null
+++ b/knowlege-content/oracle-database/APEX/apm/README.md
@@ -0,0 +1,60 @@
+# Real User Monitoring in Application Performance Monitoring on Oracle Cloud 
+
+OCI [Application Performance Monitoring (APM)](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/home.htm) provides [Real User Monitoring (RUM)](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/doc/configure-browser-agent-real-user-monitoring.html) for browser based applications. You can use this monitor to create alerts for performance and availability problems, to diagnose performance issues, and to analyze the end user's behavior. It works for internal or external facing apps deployed on Oracle Cloud or other cloud providers.
+
+Real User Monitoring tracks user sessions, page views, page load times and identifies ajax calls response times for all users, all the time. It uses a dedicated JavaScript agent that's OpenTelemetry compliant to collect out-of-the-box and customized metrics and dimensions, to provide a detailed analysis of any performance and availability issues. The monitoring collected data is available for alerts, analysis, and dynamic dashboards using a powerful query language with a rich set of widgets to present your real-time end user data.
+
+[Oracle APEX application](https://apex.oracle.com/en/learn/videos/) is a low-code platform that enables developers to build enterprise scalable, secure websites and mobile applications that can run on-premises and in Oracle Cloud.
+
+In this video, you will learn how to setup a Application Performance Real User Monitor for an APEX website. 
+
+<a href="https://www.youtube.com/embed/DrNP99t1Pfg?si=tiPiBDJzlWxYolVq"><img width="1035" alt="image" src="https://github.com/kimberlyand/test/assets/106996346/3b062831-3f1f-4177-abdb-373dceb3902d"></a>
+
+## Install the Browser Agent
+Add this JavaScript code to your APEX application's global page to collect real user data from your website developed on APEX. Using this code your dashboards you will display the APEX version, session ID, the page id, and the user name of each end user of your APEX application.
+```
+<script>
+    window.apmrum = (window.apmrum || {}); 
+    window.apmrum.serviceName='<APM Browser>';
+    window.apmrum.webApplication='<Web App Name>';
+    window.apmrum.ociDataUploadEndpoint='<ociDataUploadEndpoint>';
+    window.apmrum.OracleAPMPublicDataKey='<APM_Public_Datakey>';
+    window.apmrum.udfAttributes = [
+        { name: 'UserName', value: () => apex.env.APP_USER },
+        { name: 'APEXSessionId', value: () => apex.env.APP_SESSION },
+        { name: 'APEXPageId', value: () => apex.env.APP_PAGE_ID },
+        { name: 'APEXVersion', value: () => apex.env.APEX_VERSION },
+        { name: 'APEXPageName', value: () => document.location.pathname.split('/').pop()},
+        { name: 'APEXDBClientId', value: () => (apex.env.APP_USER + ':' + apex.env.APP_SESSION) }
+    ];   
+</script>
+<script async crossorigin="anonymous" src="<ociDataUploadEndpoint>/static/jslib/apmrum.min.js"></script>
+
+```
+## Create a Custom APEX Dashboard 
+Download this .json file to import this custom dashboard to your Oracle Cloud instance to monitor your APEX application. The video posted above demonstrates how to import your dashboard.
+
+![image](https://github.com/kimberlyand/test/assets/106996346/9b117d39-09a1-4f50-81b6-05954680ed38)
+
+## Integrate with the Database Management Service on Oracle Cloud
+
+If you have the Database Management service installed, then you can use this code to set up your Database Management Performance Hub in Application Performance Monitoring. The steps are demonstrated in the video. 
+
+```
+/dbmgmt-ui/perfhub?ocid=<DB OCID>&perfhubContext={"dateTime":{"startDate":<APMStartTimeMs>,"endDate":<APMEndTimeMs>},"selectedTab":{"name":"activityTab","filters": [{"key":"filter_list","value":"{\"client_id\":{\"value\":\"<UserName>:<APEXSessionId>\"}}"}]}}
+```
+For more information you can view the Application Performance Monitoring related documentation topics and videos: 
+
+* [Configure browser agent Real User Monitoring](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/doc/configure-browser-agent-real-user-monitoring.html)
+
+* [Configure open source tracing systems using Open Telemetry](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/doc/configure-open-source-tracing-systems.html)
+
+* [Configure Attributes for Real User Monitoring](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/doc/configure-attributes-real-user-monitoring.html) 
+
+* [Configure drilldown configurations](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/doc/configure-drilldown-configurations.html)
+
+* [Export and import dashboards](https://docs.oracle.com/en-us/iaas/Content/doc/export-and-import-dashboards.html)
+
+* [Database Management Documentation](https://docs.oracle.com/en-us/iaas/database-management/home.htm)
+
+* [Application Performance Monitoring Documentation](https://docs.oracle.com/en-us/iaas/application-performance-monitoring/home.htm)