Adding Application
1. Add application
The onboarding step lets you create your first app. However, if you want to add a new application please click on the + icon on the dashboard page, as shown below.
Enter a display name for your application. This is usually the name which you use to refer to it.
2. Add your Test Environment
On the next step you will be prompted to add the details of the environment, you would like to test with Relicx. Usually this is your development, test or staging environments. The following inputs are required. It is advised that you have all the inputs ready before you start this process.
Input Name | Description | Comments |
Test Environment Name | This is the name of your test environment. | Use a name like Staging or Test |
Test Environment URL | This is the environment URL that you generally use to connect to your test environment. Relicx needs access to this environment to run tests | If your environment is behind a firewall. Please feel free to setup an onboarding call or post your question the Relicx community slack |
Login URL | This input is required only if your application requires us to login. This could be the same as the Test Environment URL or a different one depending on how you have implemented login | For 3rd party login validations, please make sure you provide the URL that is used for validating log in on this specific test environment |
Usename | This is the username you would use to login to your test environment | Relicx will use this username to log into your app and run the test steps |
Password | This is the corresponding password. | Relicx will use this password to log into your app and run the test steps |
Once the inputs are done, please click on continue to start the credential validation process. This is an important step where Relicx attempts to log into your test environment. If this fails due to a typo you can always retry it by inputing the credentials again.
3. Install the SDK
The next step is to add the javascript script tag to your application.
To access the script tag, click Settings and then select your newly created apps from the sidebar. You will see the script tag under the Script tab
We recommend adding the script in the header section of a common file that gets included in all the pages of the application, e.g. header/menu/template, etc.
Optionally, you can also use Google Tag Manager (GTM). Just follow the usual GTM instructions to create a tag and don't forget to publish it. For more information on how to instrument your app please check out the Instrumentation page
3. Log in to Relicx
Once you have added the script tag to the application, RelicX will start recording user sessions. Depending on how busy the site is, it may take 5-10 minutes for the first session to show up in the application UI. Once logged in you will see the Dashboard page
To view the recorded sessions, click on the sessions number on your application tile.
Click on the play icon to see the session replay
4. Define Application Environments
A unique aspect of Relicx is that it interacts with your application across the release cycle stages. It monitors your production to record user sessions, extract flows and generate tests. These tests can be run against any environment, pre-production, or production. You can therefore define multiple environments for an application.
You can manage applications environments on the settings page.
Click on the Test Environments tab, to add new environments simply click on the Add Test Environment button
To check out the hosts where sessions are captured click on the Session Capture Tab
