Table of Contents On-Premises/SaaS Security/Passwords Selecting Elements Snapshots Supported Features Troubleshooting See also Synthetic Scripts FAQ (Part I). On-Premises/SaaS What are the supported on-premises/SaaS/hybrid configurations? Controller Web Mobile/RUM Synthetic SaaS SaaS SaaS On-premises (v4.5.4+) On-premises (v4.5.4+) On-premises (v4.5.4+) Back to the top Security/Passwords Do you have an encrypted store for passwords? Yes. The Synthetic Credential Vault securely stores credentials used for synthetic jobs. When you create a synthetic job with a synthetic script, you can retrieve a stored key/value credential pair, like a username and password, and inject the credential into the synthetic script. Then, when the synthetic job runs, the synthetic script executes and retrieves the credentials stored in the Synthetic Credential Vault. See our documentation to learn more about the Synthetic Credential Vault. Are scripts and test results transferred securely? The short answer is that scripts and their results always go over encrypted channels. The scripts and results are stored in clear text in various databases, so a database breach could compromise the information, but, of course, we try very hard to prevent database breaches. For the long answer, see the summary of the data path of a script and its results below. (Foo) denotes data at rest. Script -> UI -> Controller -> EUM SaaS services -> (EUM SaaS database) -> Test driver service. Test driver service connects to PoP machine with an encrypted channel and sends WebDriver commands to the PoP, driving the browser. The browser connects to a website and imitates a user. Instrumentation hook gathers data from the browser and sends it to an EUM SaaS service. Now we have a test result. Test result -> EUM SaaS service -> (metric store, event store, and EUM SaaS database) -> controller -> UI. Each of the -> links uses HTTPS, with two possible exceptions which are determined by the user: If you use an on-premises controller, security between the browser and controller is your responsibility. In other words, don't allow non-HTTPS connections to your controller. Security between the test browser and your website is your responsibility. Consequently, your script should connect to your site over HTTPS. How can I retrieve passwords from a secure server, not hard-code them in the script? If you can write Python code to do something using the standard libraries, you can do that in your script. For example, you can use Python's requests library to make REST calls to fetch a password. Back to the top Selecting Elements How do I click on an element in an iFrame (for instance to handle a pop-up)? You can wait for the iFrame element to be clickable as shown in the snippet below. from selenium.common.exceptions import TimeoutException # Cancel an advert pop-up in an iframe # Find the right iframe frame = wait.until(EC.element_to_be_clickable((By.XPATH,'//xpath-to-your-iframe]'))) # Move into the iframe driver.switch_to_frame(frame) # Close the pop-up wait.until(EC.element_to_be_clickable((By.XPATH,'/xpath-to-element/i'))).click() # Move to the default content driver.switch_to_default_content() Back to the top Snapshots What is the retention period of snapshots? Snapshots are retained for two weeks. Can the retention period of a snapshot be extended beyond the default? No, the snapshot retention period cannot currently be extended on SaaS. Back to the top Supported Features Can Synthetics be used for API testing/monitoring? Though synthetic web monitoring can be used to monitor APIs, it is not officially supported. Synthetic API monitoring is part of our roadmap: watch this space for updates.  If the customer's use case involves monitoring the API from inside their network, then Service Availability is the preferred solution.  Monitoring from outside their network is not an option at this time. Is virtual page naming (for single-page apps) supported in Synthetics? Virtual pages are not yet supported in Synthetic (possible future feature), so virtual page naming is not supported. Are JavaScript popups such as those created with window.alert or window.prompt supported? Yes, JavaScript popups created with window.alert or window.prompt are fully supported. Are multiple windows, as in multiple HTML documents loading either in different tabs or windows, supported? Multiple windows or tabs with loaded HTML documents are only partially supported. You can create scripts to handle multiple windows, but the session results will combine the waterfall metrics and the resources from all of the windows into one page. Thus, you will not be able to view the individual results for each browser window. Back to the top Troubleshooting How do I debug my script? We recommend doing your initial debugging locally: that’s always the easiest place to debug. We capture the stdout and stderr streams from your script, so you can debug that way. And we show partial sessions for scripts that failed part-way through, so you can see what the browser did up until the script failed. How do you prevent timeouts in scripts? Timeouts in scripts can be prevented by explicitly waiting for specific element states (e.g., clickable). See also the paragraph Expected Conditions discussed in Explicit Waits. If something breaks, how can I tell if it’s my site, my job, or your infrastructure? If your script has an assertion failure, the session status is “Failed”, which indicates a problem with your site. If your script crashes, the session status is “Broken”, which indicates a problem with your script. If we can’t run your script, the session status is “Internal Error”. We hope you’ll never see that. For single-URL measurements, a 5xx is “Failed,” and a 4xx is “Broken”. Why are visual metrics (Visually Complete, Speed Index) not always present? There are currently two known issues regarding visual metrics: In some cases, Chrome sessions may not display visual metrics because of a bug. This typically happens on pages with JS redirects but may happen elsewhere as well. This is a Chrome-specific problem, and we are working on a solution. A Windows issue will sometimes prevent these metrics from being computed for all browsers. When this happens, the agent needs to be rebooted. This is infrequent because we get alerts and react as fast as possible. Back to the top ... View more

Recommended Sizing for Extra Large Profiles of the On Premises EUM Server and the Events Service This article recommends hardware specifications for an extra-large profile for the on-premises EUM Server with the Events Service and then shows you the performance for different use cases that use EUM products. You can use the information to better understand the expected performance and make adjustments accordingly. Table of Contents Before You Begin Hardware Specifications JVM Options for the EUM Server Use Cases and Load Profiles Mobile Load Profiles Browser RUM Load Profiles Performance Results for Use Cases Benchmarks for General EUM Events Benchmarks for Mobile Events Benchmarks for Browser Events Resources Before You Begin Review the following: On-Premises EUM Server Sizing Guide to: Understanding EUM and Events Service Concepts to understand the basic concepts of EUM  On premises EUM Server Sizing Guide  to confirm that your on-premises EUM Server has traffic that exceeds the small, medium, and large T-Shirt sizes.  Hardware Specifications You are recommended to use an: EUM Server:  one machine with 32 vCPU and 256 GB of memory or AWS EC2 instances of type r5n.8xlarge for the EUM Server  Events Service: refer to XL Profile sizing in the How do I size the Events Service? (i.e., Events Service T-shirt Sizing Guide) JVM Options for the EUM Server The following JVM Options were used in testing and are recommended for the extra-large profile. DEFAULT_JVM_OPTS="\ \"-server\" \ \"-XX:+UseConcMarkSweepGC\" \ \"-XX:CMSInitiatingOccupancyFraction=50\" \ \"-XX:+HeapDumpOnOutOfMemoryError\" \ \"-XX:NewRatio=1\" \ \"-Xms178603m\" \"-Xmx178603m\" \ \"-javaagent:/home/ubuntu/javaagent/javaagent.jar\" \ \"-DEUM_COMPONENT=processor\" \ \"-Dlogback.configurationFile=bin/logback.xml\" \ \"-Dcom.mchange.v2.c3p0.cfg.xml=bin/c3p0.xml\"" Use Cases and Load Profiles To help you better understand the performance expected of the extra-large profile, tests were run for different EUM products with distinct load profiles. The table below lists the EUM products used and their load profiles. For more details, see the load profiles in the following sections. EUM Products Load Profile Browser RUM 100% Browser RUM: High Ajax Load  Browser RUM 100% Browser RUM: High Base Page Load Mobile/Browser RUM 2:1 Ratio (See Mobile Load Profile and Browser RUM Load Profiles.) Mobile RUM 100% Mobile RUM (See Mobile Load Profile.) Mobile RUM  100% Screenshot Load Mobile Load Profile Of the events listed in the table below, 40% of the beacons for these events were sent by the Android platform, and 60% of the beacons for the events were sent by the iOS platform. Event/Data Percentage of Beacon Network Request 70% UI  17% Screenshots 0.32% Touch Points 0.35% Breadcrumbs 6% ANRs 0.015% Errors 0.07% Crash Report 0.005% Timer Events 1.2% Custom Metric Event 2.3% System Event 3% Method Call 0.07% Browser RUM Load Profiles The tables below describe the percentage of events per beacon. High Ajax Load Event/Data Percentage of Beacon Base Page  2% IFrame  1% Ajax 93% Virtual Page 4%   Distributed Load Event/Data Percentage of Beacon Base Page  40% IFrame  13% Ajax 41% Virtual Page 6% Performance Results for Use Cases Benchmarks for Mobile Events Events  EUM Product Use Cases Mobile/Browser (2:1) Mobile (100%) Mobile (100% Screenshot) Active Users 42000 74000 45000 New Mobile Sessions 79077 114049 93587 Mobile Session Record: Analytics Event Batch Count 1891 2097 2307 Mobile Session Record: Analytics Event Count 189540 211737 230570 Mobile Crash Report: Analytics Event Batch Count 6 6 N/A Mobile Crash Report: Analytics Event Count 25 42 N/A Mobile Snapshot: Analytics Event Batch Count 3132 5300 N/A Mobile Snapshot: Analytics Event Count 302663 530000 N/A Raw Beacons (per minute) 420005 739998 448810 Crash report 25 42 N/A Screenshots 925 1415 29991 Received Events 606578 731754 448739 Dropped Events 43950 222067 0 Active sessions/minute 442970 532314 505893 Closed sessions/minute 129780 153893 144123 New Sessions 81185 114049 93587 Analytics Upsert Batch Count 2073 2120 2307 Analytics Upsert Count 200991 211737 230570 Benchmarks for Browser Events Events EUM Product Use Cases Browser (High Ajax Load) Browser (High Base Page Load) Mobile/Browser (2:1) Active Users 5400 9000 4600 New Browser Sessions 1934 1176 2108 Base Page (requests/minute) 61398 345703 54611 Ajax 2762449 354213 2458191 IFrame 30737 112346 27330 Virtual Page 122855 51907 109209 Browser JSON Beacon 310000 90000 276000 Browser Record: Analytics Event Batch Count 2100 2900 2020 Browser Record: Analytics Event Batch Count 209979 289960 195471 Received Events 214649 510200 606578 Dropped Events 11 0 43950 Active sessions/minute 16110 14111 442970 Closed sessions/minute 2706 1523 129780 New Sessions 1934 1116 81185 Analytics Upsert Batch Count 85 178 2073 Analytics Upsert Count 8364 9126 200991 Benchmarks for EUM Process Resource Usage Events  EUM Product Use Cases Mobile/Browser (2:1) Mobile (100%) Browser (Use Case #1) Browser (Use Case #2) Mobile (100% Screenshot) CPU Busy (%) 30 32 15 7 14 System Memory Used (%) 57 62 40 57 68 EUM Garbage Collection Time per Minute (ms) 939 1255 456 784 566 Major Garbage Collections (per minute over 12 hours) 4 4 0 0 0 Minor Garbage Collections (per minute) 5 4 3 2 2 Max Number of EUM Threads 556 582 453 398 401 Disk Writes (per second) 37 55 1 1 240 Disk Reads (per second) 0 0 0 0 0 Disks Average Input/Output 0 1 0 0 4 Disk Input/Output Utilization (ms) 3.3 4.4  0 0 21.9 Disk Queue Wait Time (ms) 1 0.8 0.1 0.2 1.3 Max Heap Used (%) 70 70 45 67 69 Max Process CPU Usage (%) 30 28 15 11 14 Resources On premises EUM Server Sizing Guide  Understanding EUM and Events Service Concepts How do I configure Analytics for on premises Controllers?  ... View more

How do I determine optimal sizing for my on-prem EUM Server? This guide provides context to EUM data and recommendations for sizing your on-premises EUM Server for different levels of network traffic (metrics per minute). After understanding the EUM basic concepts, review the recommended sizing below for your on-premises deployment. Table of Contents EUM Basic Concepts EUM Server Sizing Recommendations Browser RUM and EUM Sizing  Mobile RUM IoT Monitoring and EUM Sizing  Resources EUM Basic Concepts To deploy EUM successfully, you should understand Beacons and Resource Timing Snapshots. Learn more about them in the Understanding EUM and Events Service Concepts article.  EUM Server Sizing Recommendations The following tables recommend T-shirt sizing (S, M, L) for your on-prem EUM Server based on synthetic load testing. Once you have estimated your EUM traffic profile, you can use these maximum load measurement results to establish which T-shirt size is appropriate for your deployment. If your EUM traffic profile exceeds the maximum traffic given in the tables, see the Extra Large Sizing Recommendations article. For simplicity, the sizing recommendations for Browser RUM and Synthetic Monitoring are grouped together. If you are using the EUM Server with the Events Service, see Analytics On-Prem Configuration Recipe Book. Browser RUM  The sizing suggestions in the table below are based on one web beacon consisting of the following: 1 base page 7 Ajax requests 100 resources EUM Sizing for Browser RUM License type Identifying string in index name Event type: Upsert or Publish Maximum Events per license, per day Disc usage: GB per license / day Transaction Analytics biz_txn_v1 upsert 1,000,000 events AVG 1.36 STDEV 0.524 MAX 2.32 Log Analytics log_v1 publish 5GB AVG 17.2* Browser Analytics browserrecord publish 2,500,000 events AVG 3.59 STDEV 1.42 MAX 8.46 Browser Analytics sessionrecord upsert 2,500,000 events AVG 3.52 STDEV 1.29 MAX 9.01 Mobile Analytics mobilesnapshot publish 2,500,000 events AVG 3.25 STDEV 1.29 MAX 5.34 Mobile Analytics mobilesession upsert 2,500,000 events AVG 2.70 STDEV 0.80 MAX 5.45 Mobile crash report mobilecrashreport publish 1,000,000 events  AVG 3.68 STDEV 4.29 MAX 16.64 Mobile RUM  The sizing suggestions in the “EUM Sizing for Mobile RUM” table are based on network traffic for iOS and Android applications sending one beacon consisting of the percentage of the data types listed below.  Data Types % of Beacon Network Request 80% UI Interaction Capture 10% Screenshots 1% Touchpoints 1% Breadcrumbs 4% ANRs 1% Code Errors 1% Crash Reports 0.02% Custom Timers 0.01% Custom Metrics 0.03% System Events 0.04% Method Calls 1.9% EUM Sizing for Mobile RUM EUM Size Maximum Traffic (Metrics per Minute)  Hardware Specifications Network Bandwidth Java Heap Size Small Beacons 90k < with 5 crashes - CPU: 4 CPU - RAM: 16 GB - Hard drive: 300 GB - EC2 Instance Type:    m4.xlarge            750 Mbps 11 GB Events 70k Sessions 40k Medium Beacons 90-130k - CPU: 8 CPU - RAM: 32 GB - Hard drive: 300 GB - EC2 Instance Type:     m4.2xlarge           1000 Mbps 30 GB Events 70-110k Sessions 40-61k Large Beacons 130-550k - CPU: 16 CPU - RAM: 64 GB - Hard drive: 300 GB - EC2 Instance Type:    m4.4xlarge          2000 Mbps 50 GB Events 110k-3.5M Sessions 61-118k IoT Monitoring The sizing suggestions below are based on network traffic for IoT applications sending beacons for the following events: Network requests Custom events Error events EUM Sizing for IoT Monitoring EUM Size Maximum Traffic (Metrics per Minute)  Hardware Specifications Network Bandwidth Java Heap Size Small Beacons 110k < - CPU: 8 CPU - RAM: 32 GB - Hard drive: 300 GB 759 Mbps 10 GB Events 500k Medium Beacons 110-300k - CPU: 8 CPU - RAM: 32 GB - Hard drive: 300 GB 1000 Mbps 22 GB Events 500-600k Large Beacons 300-600k - CPU: 16 CPU - RAM: 64 GB - Hard drive: 300 GB 2000 Mbps 50 GB Events 600k-1M Resources Sizing XL profiles for on-premises EUM Server and the Events Service: What's recommended? Understanding EUM and Events Service Concepts How do I configure Analytics for on-premises Controllers?  ... View more

You can configure the Synthetic Server to use SSL to secure network connections. Follow the steps below to configure the Synthetic Server to use a signed certificate and its password. Edit the Synthetic Scheduler configuration file at  <installation directory>/conf/synthetic-scheduler.yml  and add the  applicationConnectors  object shown below under  server : server:     ...     applicationConnectors:         - type: https           port: <port>           keyStorePath: <path to JKS files>           keyStorePassword: <jks file password>           validateCerts: false  If you don't already have a signed certificate, see Create and Sign an RSA Security Certificate.  Edit the Synthetic Shepherd configuration file at  <installation directory>/conf/synthetic- shepherd .yml  and add the  applicationConnectors  object shown below under  server : server:     ...     applicationConnectors:         - type: https           port: <port>           keyStorePath: <path to jks file>           keyStorePassword: <jks file password>           validateCerts: false  Restart the Synthetic Server. Verify the connection to the HTTPS port.  Create and Sign an RSA Security Certificate   The following sections describe and show an example of how to create a custom RSA security certificate, generate a new JKS keystore, and sign the certificate. Install the Prerequisite Libraries Create a Certificate and Keystore Sign and Install the Signed Certificate Install Prerequisite Libraries Make sure the following libraries are installed: keytool openssl Create a Certificate and Keystore Use the keytool command to create a keystore that uses RSA encryption then generate a certificate signing request (CSR). The following steps show you an example of how to do both. At a command prompt, navigate to the root directory of the Synthetic Server: cd <synthetic_server_root> Create a new keystore with a new unique key pair that uses RSA encryption: <path_to_jre>/jre/bin/keytool -genkey -keyalg RSA -validity <validity_in_days> -alias 'synthetic-server' -keystore ./mycustom.keystore This creates a new public-private key pair with an alias of "synthetic-server". You can use any value you like for the alias. The "first and last name" required during the installation process becomes the common name (CN) of the certificate. Use the name of the server. Configure the keystore by entering the information requested at the command prompt. Specify a password for the keystore. You need to configure this password in the Synthetic Server configuration file later.   Generate a certificate signing request (CSR): <path_to_jre>/jre/bin/keytool -certreq -keystore ./mycustom.keystore -file /tmp/synthetic-server.csr -alias 'synthetic-server' This generates a certificate signing request based on the contents of the alias; in the example, it is "synthetic-server". Sign and Install the Signed Certificate Once you have a CSR, you request a Certificate Authority to sign it and then install the signed certificate. The following steps are a continuation of the process from Create a Certificate and Keystore: Send the output file from the last step ( /tmp/synthetic-server.csr  in this example) to a Certificate Authority for signing. Install the certificate for the Certificate Authority used to sign the .csr file: <path_to_jre>/jre/bin/keytool -import -trustcacerts -alias myorg-rootca -keystore ./mycustom.keystore -file /path/to/<CA-root-cert> This command imports your CA's root certificate into the keystore and stores it in an alias called "myorg-rootca". Install the signed server certificate as follows: <path_to_jre>/jre/bin/keytool -import -keystore ./mycustom.keystore -file /path/to/<signed-cert>  -alias 'synthetic-server' This command imports your signed certificate over the top of the self-signed certificate in the existing alias; in the example, it is "synthetic-server". Import the root certificate to the other platform components connecting to the Synthetic Server through HTTPS:   keytool -import -trustcacerts -alias <alias_name> -file mycert.cer -keystore <complete_path_to_cacerts.jks>   ... View more

If you are having trouble starting the EUM Server as a Windows service, you can use a batch command to start it.  Follow the steps below to use a batch command to start the EUM Server: Download the Apache Common Daemon Procrun. Create the file eum-start.bat  with the following code: set SRV_PATH=C:\AppDynamics\EUM\commons-daemon-1.1.0-bin-windows\amd64 set EUM_SERVICE_NAME=AppDynamics EUM Server Test set EUM_DIR=C:\AppDynamics\EUM set JVM_MX=4096m set JVM_MS=4096m "%SRV_PATH%\prunsrv" //IS//"%EUM_SERVICE_NAME%"^ --DisplayName="%EUM_SERVICE_NAME%"^ --Description="%EUM_SERVICE_NAME%"^ --Startup=auto^ --Install="%SRV_PATH%\prunsrv.exe"^ --Jvm="%EUM_DIR%\jre\bin\server\jvm.dll"^ --Classpath="%EUM_DIR%\eum-processor\lib\*"^ --JavaHome="%EUM_DIR%\jre"^ --JvmOptions=-DEUM_COMPONENT=processor^ ++JvmOptions=-Dlogback.configurationFile=bin/logback.xml^ ++JvmOptions=-Dcom.mchange.v2.c3p0.cfg.xml=bin/c3p0.xml^ --JvmMx=%JVM_MX%^ --JvmMs=%JVM_MS%^ --StartPath="%EUM_DIR%\eum-processor"^ --StartMode=jvm^ --StartClass=com.appdynamics.eumcloud.EUMProcessorServer^ --StopMode=jvm^ --StopClass=com.appdynamics.eumcloud.EUMProcessorServer^ --LogLevel=DEBUG^ --StdOutput="%EUM_DIR%\logs\eum-processor.log"^ --StdError="%EUM_DIR%\logs\eum-processor-error.log" "%SRV_PATH%\prunsrv.exe" //RS//"%EUM_SERVICE_NAME%" Edit the file with the correct file paths and parameters. Place the file in the directory <EUM_processor>/bin . Run the batch file. You should see that the service for the EUM Server has been created. Start the EUM Server by clicking Start on the service. To stop the service, click Stop. ... View more

The Synthetic Server relies on the Python library flake8 2.6.2 to lint synthetic scripts. When you install the Synthetic Server, the installer will use pip to install the correct version of flake8 , but if you need to manually install the flake8 library and the Synthetic Server host machine does not have outbound access to the internet, you can use the following instructions to fetch and install flake8 2.6.2 . Note that you will still need a machine with internet access to fetch the package. From a machine with internet access and pip installed: Create a directory for the flake8 library: mkdir ~/flake8  Download the flake8 package:  pip download flake8==2.6.2 -d ~/flake8 Zip and tar the flake8 package: tar cvfz flake8-2.6.2.tgz ~/flake8 Copy flake8.tgz to the $HOME directory of the host machine of the Synthetic Server. From the host of the Synthetic Server that has no internet access, but does have pip installed: Unzip and extract the flake8.tgz file: tar xvfz flake8-2.6.2.tgz ~/flake8  Change to the flake8 directory. Install the flake8 library with pip with the following command: pip install flake8-2.6.2-py2.py3-none-any.whl -f ./ --no-index ... View more

How do I solve performance issues when collecting metrics with the Windows Machine Agent? Issue Some users have experienced slow performance and/or high resource consumption when collecting server metrics on Windows with Server Visibility enabled.  Solution The ServerMonitoring extension uses theWindows Management Instrumentation (WMI) to collect metrics on Windows machines. If you experience problems using WMI, you can configure the ServerMonitoring extension to use SIGAR instead. The trade-off is that SIGAR cannot collect all the metrics that WMI can. See What metrics are not available when using SIGAR?, below for the list. In addition, this solution is available only on version 4.3.8 (or higher) of the Machine Agent. To use SIGAR, specify the following System Property on the agent (the default is  false )😞 -Dappdynamics.machine.agent.extensions.sim.sigarCollectorEnabled = true   What metrics are not available when using SIGAR?  If you use SIGAR (not WMI) with the ServerMonitoring extension, the following metrics will be unavailable. Server Dashboard Server Dashboard > CPU chart > CPUs (number) Server Dashboard > Properties > all CPU metrics Metric Browser Hardware Resources|Disks|<partition>|Avg Service Time (ms) Hardware Resources|Disks|<partition>|Avg Queue Time (ms) Hardware Resources|Disks|<partition>|% CPU Time Hardware Resources|Disks|<partition>|Avg IO Utilization (%) Hardware Resources|Disks|<partition>|Avg read time (ms) Hardware Resources|Disks|<partition>|Avg write time (ms) Hardware Resources|Disks|<partition>|Queue Time (ms) 95th Percentile Hardware Resources|Disks|Avg IO Utilization (%) Hardware Resources|Process|<processName>|Faults|Major Faults/sec Hardware Resources|Process|<processName>|Faults|Minor Faults/sec Hardware Resources|CPU|%IOWait 95th Percentile Hardware Resources|Memory|Swap Total (MB) Hardware Resources|Memory|Swap Used (MB) Hardware Resources|Memory|Swap Free (MB) Hardware Resources|Memory|Swap Used % Hardware Resources|Memory|Swap Free % Hardware Resources|Memory|Pages Paged In 95th Percentile Hardware Resources|Memory|Pages Paged Out 95th Percentile Hardware Resources|Memory|Pages Swapped In 95th Percentile Hardware Resources|Memory|Pages Swapped Out 95th Percentile Hardware Resources|Load|Last 1 minute Hardware Resources|Load|Last 5 minutes Hardware Resources|Load|Last 15 minutes Hardware Resources|Service Availability|<service ID>|Response Time (ms) Hardware Resources|Service Availability|<service ID>|Response Size (bytes) Hardware Resources|Service Availability|<service ID>|Success Rate (%) Hardware Resources|Service Availability|<service ID>|Response Size (bytes) Hardware Resources|Service Availability|<service ID>|Success Rate (%) Hardware Resources|Network|<iface>|Avg Utilization (%) Hardware Resources|Network|Avg Utilization (%) ... View more

You can download several essential components for your AppDynamics environment, including Application Agents, Enterprise Console and Controller, and Events Service, directly from our Downloads page. Other components, especially ones pertaining to EUM products, can be downloaded or installed from other locations, as follow: Android SDK Install the Android SDK using Gradle. For instructions, click here. Cordova Plugin Use the hybrid platform’s CLI with the ‘Cordova’ command to install the Cordova plugin into the application. For instructions, click here. Note: This product is no longer supported (EOS) as of January 1, 2024 iOS SDK Install the iOS SDK pod from CocoaPods. For instructions, click here. IoT C/C++ SDK https://github.com/Appdynamics/iot-cpp-sd  Clone the repo from GitHub and follow the README instructions. IoT Java SDK https://github.com/Appdynamics/iot-java-sdk  Clone the repo from GitHub and follow the README instructions. JavaScript Agent Use the CDN or download the JavaScript Agent from the Controller. For instructions, click here. Node.js Agent  https://www.npmjs.com/package/appdynamics Xamarin SDK  https://www.nuget.org/packages/AppDynamics.Agent/  Install the package from the NuGet Gallery. Additional Resources To make sure you complete all the tasks necessary for a successful release upgrade to a newer version, we recommend following the relevant instructions in our upgrade checklists. These guides are not release-specific and can be referenced for any release: AppDynamics Upgrade Checklist For Any Release ... View more

Table of Contents General Alerts Availability/Location Browsers Environments Languages/Libraries Limitations/Restrictions Mobile Synthetics See also Synthetic Scripts FAQ (Part II). General What’s the best and easiest way to create a script? Start with the Firefox add-on Katalon Recorder. You will probably have to modify the script it generates, but WebDriver is simple. You can also use the Katalon Recorder to test your script locally and make sure it works.  Here are some other bits of advice: Assume you will have to clean up any auto-generated code, although the generated script will work without modifications. Test the script locally before uploading it to our system. Who are our hosting providers? We use Amazon EC2 and SoftLayer. Other providers are being considered. Why do agents sometimes appear slower than my local setup that uses WebDriver? There are several reasons why the agents may be slower than on your laptop: If the website you are hitting is close to you, an agent that's 10,000 miles away will be slower. That's the whole point of the global agent network! We clear all relevant caches on the agent machines before running the tests. If you enable traffic shaping, it will be slower. We use 1 GHz, 4GB RAM Windows VMs. These are probably less powerful than your laptop, but the effect is probably small because most sites are not CPU or memory bound. We wait a little longer to make sure pages have loaded fully to capture performance metrics. Generally, the effect is small, but, in extreme cases, the effect may be bigger. Our primary goal is to provide consistent performance in a given location. Between locations, we try to keep everything consistent except the network. When in doubt, run several sessions from the same location to confirm that the session duration is stable, and do the same from a different location to compare the results. What do I do about confirmation emails or OTP keys? We don't have special support at this time, but if you can write Python code to do something using the standard libraries, you can do that in your script.  How do I handle an alert pop-up window? One way would be to use a try-catch clause and wait for an alert as shown below: from selenium.common.exceptions import TimeoutException # Handle an alert pop-up try: WebDriverWait(driver, 2).until(EC.alert_is_present()) alert = driver.switch_to_alert() alert.accept() #print "alert accepted" except TimeoutException: print 'No alert pop-up'   How do I handle file uploads/downloads with WebDriver? For file uploads, you need to either download a file or generate one in your script (we have no way of letting you upload things to the sandbox at the moment). Next, set the path of the input element to the absolute path of the file to upload. Below is a working example that uploads a generated file with random content to https://encodable.com/uploaddemo/: import random from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.common.keys import Keys from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.support.ui import WebDriverWait import time driver.implicitly_wait(10) # Generate a file with random numbers generated_file_name = "/tmp/generatedfile.txt" with open(generated_file_name, "w") as generated_file: for _ in range(500): generated_file.write(str(random.randint(0,9))) driver.get("https://encodable.com/uploaddemo/") driver.find_element_by_css_selector("input.upform_field.file.required") \ .send_keys(generated_file_name) driver.find_element_by_css_selector("#uploadbutton") \ .click(); # Wait for "Your upload is complete" text to show up upload_complete = WebDriverWait(driver, 10).until( EC.presence_of_element_located((By.CSS_SELECTOR, "dt.first"))) # Check that things worked as expected" assert upload_complete.text == "Your upload is complete:" txt=driver.find_element_by_xpath("//dt[contains(text(),'Your upload is complete:')]") print(txt.text) As far as downloading files, you can definitely get the browser to download something, but from there you won't able to inspect the downloaded file from your script because we have no way to extract this file from the agent to the sandbox. How do you ensure isolation between scripts/tests? Each script is executed in a Docker container created and destroyed for each run. The script connects to a Windows agent to drive its web browser. For isolation, we clear the browser caches, history, and DNS cache between runs. In both cases, we don't write to the disk, so if a hacker could steal a disk from the data centers we use, they might be able to recover something, but this would be a very sophisticated and expensive attack. We baseline visual time/job time metrics—so will we baseline synthetic times by GEO as well?  The use case is that baseline response-times per-GEO could vary. We don't baseline per job per GEO currently. We do baseline the overall page times per GEO alongside the current RUM metrics. Can a maintenance window be scheduled to disable jobs on a regular schedule (for maintenance windows for instance)? You can't schedule a maintenance window per se, but if you know when your maintenance windows are going to be scheduled, then you can set up your schedules so that no jobs will be executed during that window. Alternatively, if you don't know ahead of time when the maintenance windows are going to be scheduled, you can always go in manually and hit the Disable button on the jobs before the maintenance starts and then re-enable them afterward. How can I set the screen size for my Synthetic Job?  You can set the height and width of the browser window using the set_window_size(width, height, windowHandle='current') method. For example, if you want to set the window size to 800x600 pixels, insert this method into your Synthetic Script: driver.set_window_size(800,600) Back to the top Alerts Do you alert immediately when a page crosses a performance threshold? We give the options of alerting after a retry that is also over the threshold, immediate alert with no retry and alerting after n measurements are over the threshold. How are performance alert thresholds applied to scripts with multiple pages? Each page is analyzed individually. If any of them is over the threshold, the alert is generated. Do you confirm site availability warnings and errors before alerting? We do confirm a warning and error when detected. We generate events, however, at every state: issue detected, confirmed, ongoing, and cleared, and give you the option of being notified of events you care about. Back to the top Availability and Location How many locations do you offer? We currently have 27 locations, and we’ll be adding more based on customer demand. Using the public cloud lets us deploy anywhere we can find a good cloud provider. How is availability computed? What does "ppm" or "parts-per-million" mean? Availability (parts-per-million) is computed as: (# succeeded / # attempted) * 1,000,000 and represented in per million, instead of percent, because controller metrics are always integer-valued. If we had used percent, the most precise availability we could represent would be 100%, 99%, 98%. Not, for example, 99.99%. To convert per-million to percent, just divide by 10,000. For example, if the availability (ppm) is 999,800, then the availability (%) is 99.98. Most screens convert to percent before showing, but "raw data" screens like the metric browser show the value per-million. To test internal applications from external locations, can we provide a list of AWS IP/Port information so they can allow these through their firewalls? We offer three locations with static IPs that you can use to test internal applications from external locations. Back to the top Browsers What are the browser versions for Firefox and Chrome? Firefox runs version 41.0.1, and Chrome runs version 48 (updated on 2017-03-09). Please note that browser versions are subject to change in the future. How often do you update the browsers that you support? Browser versions are generally locked; however, we can upgrade within 1-2 weeks as required. Is BSM an option for monitoring browser extensions like Flash or Silverlight? Browser extensions like Flash and Silverlight (which are being phased out) can't be monitored by stock Selenium, which is what we support. Many in the community have extended Selenium with APIs to do this. We don't currently support the use of 3rd-party libraries in our runtime. Back to the top Environments What scripting environments are supported? Python  v.2.7.x. (Python v3 is not supported yet.) Python scripts < 2.7 are likely to work, but are untested. Selenium: We support WebDriver, which is also sometimes known as Selenium 3. The scripts should be written using the Python WebDriver API. We use a custom version of the Selenium Server based on version 3.0.1. Note, this is subject to change without notice. What hardware is used to run the tests in browsers?  Browser tests are run on single-core VMs with 4 GB of RAM, although the hardware may vary slightly per location. To ensure consistent performance results, the VMs only run one job at a time. Back to the top Languages and Libraries Can Selenium scripts are written in Java be converted to Python for synthetic jobs? No. There isn't a standard accepted tool that would do that, and honestly, this is just a bad idea. These scripts do have a maintenance cost, and a pure machine conversion between two languages is just going to make this more difficult. Not to mention debugging in the first place, unless things work out of the box, which is not very likely, the machine translation is going to be really hard to debug.  What Python libraries can I use in my scripts? You can use any library that is part of the standard distribution of Python 2.7. In addition, the following libraries are available: selenium, the library used to drive the agent browser Requests  pysftp  Can I install my own libraries to support my scripts? Not yet. Back to the top Limitations and Restrictions Do we impose any kind of object size limits for test scripts? There are no size limits for test scripts.  Please be aware, however, that larger files will use more time (more "expensive"). Back to the top Mobile Synthetics Do we have a timeframe for mobile synthetics? We do not have a timeframe for mobile yet. Back to the top ... View more

When you run the EUM Server Installer, the HTTP port of the EUM Server is set up for you, but the HTTPS port is not. After the installation is complete, follow the instructions below to configure the HTTPS port for the EUM Server and update the Controller settings for the EUM Server URL and port: Set Up a Custom Keystore for Production, From the machine where your EUM Server is installed, open the file  $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties  in a text editor. Add the following line to  $APPDYNAMICS_HOME/EUM/eum-processor/bin/eum.properties , replacing  <PORT>  with the port you want the EUM server to listen to. processorServer.httpsPort=<PORT> Restart the EUM Server. Confirm that the EUM Server is listening to the configured HTTPS port:  curl https://<YOUR-DOMAIN>:<PORT>/eumcollector/ping From the Controller Admin UI, change the port for  eum.beacon.https.host  so that it is the same as the one assigned to  processorServer.httpsPort . This allows the beacon to communicate with the collector.  ... View more

When Screenshots Can Be Taken   AppDynamics has optimized the Mobile Agents to minimize performance overhead. If performance allows, the Android and iOS Agents can take screenshots when the following events occur: Screen changes Touch events Period sampling (5-10) seconds When Screenshots Cannot Be Taken   The Android and iOS Agents, however, cannot take screenshots under the following conditions: Text is being entered Network restrictions have been made Application scheduling in process Other system conditions Crash occurs and the application is killed Spoiler (Highlight to read) If the application is "crashing", the agent cannot depend on having a stable environment to collect a screenshot. Hopefully, the last processed and stored screenshot has relevance to the crash. If the application is "crashing", the agent cannot depend on having a stable environment to collect a screenshot. Hopefully, the last processed and stored screenshot has relevance to the crash. ... View more

Starting from AppDynamics 4.3, the page referrer information is no longer available by default in the browser request Analytics data. In Analytics, the page referrer is called the "Parent Page URL". The Events Service internal name for the "Parent Page URL" is pageparenturl.    Thus, when in Drag and Drop Search mode in Analytics, if you choose the event type Browser Requests and check the field Page Referrer check box, you won't see any information as shown in the screenshot below: Likewise, in Query Language Search mode, you will not receive results when querying the field referrer from the data source browser_records: Depending on your deployment (SaaS or on-prem), you can include the page referrer in the browser request Analytics data in one of the following ways: SaaS customers can submit a request to their AppDynamics account representative to include the page referrer information in browser request Analytics data. On-prem customers can run the SQL statements shown in the following sections to add the page referrer information for all or specific pages to their EUM database. Include the Page Referrer for All Pages Find your EUM account name from the Controller UI. For 4.4, connect to the EUM Server eum_db database. For 4.3, connect to Controller's MySQL database eum-processor that the EUM Server is using.  Run the following insert statement using the account_settings table: INSERT INTO `eum_db`.`account_settings` (`account_name`, `key`, `value`) VALUES ('<your-eum-account-name>', 'pagePublishedWithReferrer', '.*');   Include the Page Referrer for Specific Pages Find your EUM account name from the Controller UI. Create a list of page URLs or URL patterns that you would like to have page referrers. For each page URL or URL pattern, run an insert command. For example, if the page is http://www.google.com: INSERT INTO `eum_db`.`account_settings` (`account_name`, `key`, `value`) VALUES ('<your-eum-account-name>', 'pagePublishedWithReferrer', 'http://www.google.com'); ... View more

 If your build system is Ant-based and you want to build Android apps with the AppDynamics SDK< you must: Add agent files to the project Include a post-compile target Note: The Android SDK does not support IBM Worklight or other frameworks that do not use the build.xml file defined in Android projects.  Procedure 1. How do I add the AppDynamics Android Agent files? Create a  libs  directory in your application root directory. Since this is often "Application and a subdirectory of your project directory,  your  libs  directory might be located here:  ProjectName/Application/libs Copy  ADEumAgent.jar  to the  libs  directory. Copy  ADEumInjector.jar  to your application  root  directory. 2. How do I add or edit the post-compile target? The steps to adding or editing a post-compile target depend on your project's existing structure: If your project doesn't have a custom_rules.xml file, create this one If your project has an existingcustom_rules.xml , add this "-post-compile" target to it If your project has an existing custom_rules.xml   with "-post-compile" target, append provided text to the  <target>  element If you're using Eclipse and Ant, refer to these instructions   What do I do if my project doesn't have  a  custom_rules.xml  file? If your project doesn't have a  custom_rules.xml : Create a file in your project's root directory named  custom_rules.xml . Copy and paste the following into that file. <project> <target name="-post-compile"> <taskdef name="injector" classname="com.appdynamics.android.ant.EUMAgentInjectorTask" classpath="ADEUMInjector.jar"/> <injector classfilespath="${out.classes.absolute.dir}" outputlocation="${out.absolute.dir}/instrumented-jars/" instrumentationjarlocation="${jar.libs.absolute.dir}/ADEUMAgent.jar" jarfilesrefid="project.all.jars.path" androidjarlocation="${project.target.android.jar}"/> </target> </project> What do I do if my project's existing  custom_rules.xml  file doesn't contain a "-post-compile" target? If there is an existing  custom_rules.xml  file in your project but it does not contain a "-post-compile" target: In your project's existing custom_rules.xml file, add the following text to the end of it's existing  <project>  element: <target name="-post-compile"> <taskdef name="injector" classname="com.appdynamics.android.ant.EUMAgentInjectorTask" classpath="ADEUMInjector.jar"/> <injector classfilespath="${out.classes.absolute.dir}" outputlocation="${out.absolute.dir}/instrumented-jars/" instrumentationjarlocation="${jar.libs.absolute.dir}/ADEUMAgent.jar" jarfilesrefid="project.all.jars.path" androidjarlocation="${project.target.android.jar}"/> </target>​ What do I do if my project's existing  custom_rules.xml  file already contains a -post.compile  target: If there is an existing  custom_rules.xml  file in your project and it already contains a  -post-compile   target: Add the following text to the end of the existing "-post-compile"  <target>  element: <taskdef name="injector" classname="com.appdynamics.android.ant.EUMAgentInjectorTask" classpath="ADEUMInjector.jar"/> <injector classfilespath="${out.classes.absolute.dir}" outputlocation="${out.absolute.dir}/instrumented-jars/" instrumentationjarlocation="${jar.libs.absolute.dir}/ADEUMAgent.jar" jarfilesrefid="project.all.jars.path" androidjarlocation="${project.target.android.jar}" />​   Special Considerations What should I consider if I'm using Eclipse and Ant? If you're using Eclipse and Ant, do not include  android.jar  in the list of jar files provided as " jarfilesrefid " to your injector task—for example, if your  build.xml  looks something like this: <taskdef name="injector" classname="com.appdynamics.android.ant.EUMAgentInjectorTask" classpath="ADEUMInjector.jar"/> <injector classfilespath="${out.classes.absolute.dir}" outputlocation="${out.absolute.dir}/instrumented-jars/" instrumentationjarlocation="${jar.libs.absolute.dir}/ADEUMAgent.jar" jarfilesrefid="project.all.jars.path" androidjarlocation="${project.target.android.jar}"/> Make sure that android.jar is not included in the list of files specified by the refid " project.all.jars.path ". Otherwise, the injector will fail to instrument your build properly. ... View more