SiteScope

This section explains how to use the LoadRunner Cloud SiteScope agent to access data from SiteScope.

SiteScope overview

Use the LoadRunner Cloud agent to access data from SiteScope about your applications or the servers on which they are running.

SiteScope collects data from the application servers behind your firewall and sends the data, by means of the LoadRunner Cloud SiteScope agent, to LoadRunner Cloud where it is displayed on the SiteScope on-premises monitor.

Note: A single LoadRunner Cloud agent for SiteScope can only be used in one load test at any time.

LoadRunner Cloud SiteScope agent system requirements

The following are the system requirements for the LoadRunner Cloud SiteScope agent:

Resource Value
OS

A Windows x64 operating system
CPU 2
Memory 4 GB

Back to top

Prerequisites

Carry out the following steps to set up SiteScope to work with LoadRunner Cloud:

Before you start:

What to check Details
Ensure that SiteScope is installed and that it can access the servers hosting the applications.

For details about supported versions, see Support Matrix.
Confirm that the machine can access the internet.

If the machine on which you are installing SiteScope cannot access the internet directly, make sure to have your proxy details available. You need this information for configuring the agent.
Ensure that the date and time on the SiteScope machine are correct.

Synchronize your computer clock with an Internet time server.
The LoadRunner Cloud SiteScope agent port must be set.

An outbound connection from the LRC SiteScope agent to the LRC servers in the cloud is required, on port 443.
The SiteScope machine must be able to initiate a network connection to the machine where you install the LoadRunner Cloud SiteScope agent. Installing both SiteScope and the LoadRunner Cloud SiteScope agent on the same LAN, yields the best performance.

Back to top

Configure SiteScope to work with LoadRunner Cloud

You can create a monitor group for data integration with LoadRunner Cloud.

Tip: For full instructions on configuring SiteScope data integrations, see the SiteScope Help.

  1. In SiteScope, select a monitor group or add a new group and move all your monitors under this new group.
  2. In the monitor group's Properties tab, select a tag or add a new tag to associate with the monitor group.

  3. Go to Preferences > Integration preferences, and add a new data integration.

    • Name. The name for the integration.

    • Receiver URL

      The URL of the LoadRunner Cloud SiteScope agent receiving the data from the SiteScope monitor. This must be a full URL including the server, the host on which the LoadRunner Cloud SiteScope agent runs, and the port number.

      You can choose a port number, but it must be the same as the port number configured in the Monitor tab. The default port value is 443. In LoadRunner Cloud versions prior to 2021.04 where TLS was not supported, the default port was 3000.

      Use the following syntax:

      http or https://<fully qualified domain name of the LoadRunner Cloud SiteScope agent host>:<port number specified in the Data integration port>

    • Reporting Interval. The interval (in seconds) between consequent data reporting by SiteScope to the SiteScope agent. Default: 60 seconds.

  4. As authentication is not supported for this integration, ensure that the Web Server Security Settings and Proxy Server Settings areas are empty.
  5. Verify that Disable integration option is not selected.
  6. Select the tag that you associated earlier with your monitor group.

Back to top

Install and configure the LoadRunner Cloud SiteScope agent

Carry out the following steps to install and configure the LoadRunner Cloud SiteScope agent:

Install the LoadRunner Cloud SiteScope agent

Do the following to install the LoadRunner Cloud SiteScope agent:

Action How to perform the action
Get the installation package Download the LoadRunner Cloud banner > Tools and Integrations > Agents area.
Run installation package

On the machine where you want to install the LoadRunner Cloud SiteScope agent, run, as administrator, the installation file (.exe) provided by your Customer Service representative.

Select installation location

By default, the LoadRunner Cloud SiteScope agent is installed in c:\loadrunnerCloud_agent. To install the agent in a different folder, click Options, change the path, and click OK.
Install

Click Install to start the installation of the agent and other required software.

Configure the LoadRunner Cloud SiteScope agent

Do the following to configure the LoadRunner Cloud SiteScope agent:

Access the LoadRunner Cloud SiteScope agent configuration tool

When the installation is complete, the LoadRunner Cloud SiteScope agent configuration tool opens.

To skip the configuration at this point, close the tool and configure it later.

Note: LoadRunner Cloud and the relevant monitoring tool are able to communicate only after the LoadRunner Cloud SiteScope agent is properly configured.
General tab

  • Enter a logical name for the LoadRunner Cloud SiteScope agent. This identifier appears in LoadRunner Cloud in the list of available agents. For example, call it SiteScopeOnPrem Agent.

  • Enter your LoadRunner Cloud username/password or client ID/secret key. Tenants created before version 24.3 can authenticate using the username/password or OAuth authentication methods. However, tenants created for version 24.3 and higher may only authenticate with the OAuth method with a client ID and secret key. The preferred and more secure method is to always authenticate with a client ID and secret key, even for earlier versions. For details, see API access keys.

  • Enter your LoadRunner Cloud tenant ID.
Misc tab

  • To use a proxy other than the one shown, enter your proxy URL.

    If your proxy requires authentication, select the Advanced tab to enter your credentials.

    Note: This is necessary only if the agent machine cannot directly access the internet.

  • Enter the URL of the LoadRunner Cloud server. You can copy the LoadRunner Cloud server URL from the address bar of the browser in which you opened LoadRunner Cloud.

    Example: If the URL in the address bar of the browser is https://loadrunner-cloud.saas.microfocus.com/home/?TENANTID=208294383&projectId=1, copy the address https://loadrunner-cloud.saas.microfocus.com.

  • Select a log level.
Monitor tab

Select the SiteScope monitor, and enter the details:

  • Data Integration Port. You can choose the port number (by default 443 from version 2021.04), but it must match the port number configured for the SiteScope data integration's Receiver URL.

  • Use TLS. Beginning with LoadRunner Cloud version 2021.04, by default the SiteScope agent is launched with TLS (Transport Layer Security) enabled. With TLS enabled, the LoadRunner Cloud agent starts SiteScope as an HTTPS server. If you deactivate this option, the agent starts SiteScope as an HTTP server.

    To work with SiteScope as an HTTPS secure server, you must first do the following:

    1. Copy your certificate files, server.key and server.crt to C:\loadrunnerCloud_agent\testexec.server\stormagent\certificates (by default).

    2. Import these certificates to the SiteScope server: Select Preferences > Certificate management > Import certificate. For the host address, enter the IP of the SiteScope agent machine, with port 443.

    3. Indicate HTTPS in the integration preferences: Select Preferences > Integration preferences> Receiver URL and choose HTTPS.

    The SiteScope agent is started with the HTTPS server, and metrics from SiteScope server are sent in a secured protocol.

Note: If you get an error, check that the configuration details that you provided are correct.

Launch the LoadRunner Cloud SiteScope agent

Click the Start button on your machine and search for Start LRC Agent.

Add the relevant monitor to the LoadRunner Cloud assets

For details, see Monitors.

Back to top

Update the SiteScope agent to the LoadRunner Cloud SiteScope agent

The LoadRunner Cloud SiteScope agent is the new name for the SiteScope agent.

Action How to perform the action
Delete the SiteScope agent that is installed

For reference, back up your current SiteScope agent configuration file:

<SiteScope agent installation path>\sitescope_stormagent\testexec.server\stormagent\monitor_sample_conf.json

Delete the whole SiteScope agent installation folder.
Install and configure the LoadRunner CloudSiteScope agent

Do the following steps:

  1. Install the LoadRunner Cloud SiteScope agent.
  2. Configure the LoadRunner Cloud SiteScope agent.

Launch the LoadRunner Cloud SiteScope agent

Click the Start button on your machine and search for Start LRC Agent.

Back to top

Access the LoadRunner Cloud SiteScope agent configuration tool

If you skipped the LoadRunner Cloud SiteScope agent configuration when you installed/updated it, or if you need to update the configuration settings:

Click the Start button on your machine and search for Configure LRC Agent.

Back to top

Troubleshooting

To verify that SiteScope data is being received by the LoadRunner Cloud SiteScope agent, check for the following text in the <installdir>/testexec.server/stormagent/stormagent.log file:

"got data from sis"

Back to top

See also: