LoadRunner Cloud agent

Use the LoadRunner Cloud agent to access data from third-party monitoring tools 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 agent, to LoadRunner Cloud where it is displayed on the SiteScope on-premises monitor.

Dynatrace supports both application monitoring and server monitoring. The LoadRunner Cloud agent pulls the data collected by Dynatrace and displays it on the Dynatrace monitor in LoadRunner Cloud.

LoadRunner Cloud agent system requirements

OS Windows 2008 R2
CPU 2
Memory 4 GB

Back to top

Set up my third-party monitoring tool

Before you start:

Action How to
Ensure that your monitoring tool is installed and that it can access the servers hosting the applications.

Supported monitoring tools:

  • Dynatrace
  • SiteScope

For details about supported versions, see Support Matrix.

Confirm that the machine can access the internet.

If the machine on which you are installing the agent cannot access the internet directly, make sure to have your proxy details available. You will need this information when you configure the agent.

Ensure that the date and time on the LoadRunner Cloud agent machine are correct.

Synchronize your computer clock with an Internet time server.

LoadRunner Cloud agent port

An outbound connection from the LRC 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 agent. Installing both on the same LAN will yield the best performance.

Configure your monitoring tool to work with LoadRunner Cloud

Dynatrace

In Dynatrace, set up a dashboard containing chart-type dashlets that display the information you want to view in LoadRunner Cloud.

Note: LoadRunner Cloud supports chart-type dashlets in Dynatrace only. LoadRunner Cloud displays each measurement in the chart as a separate line graph.

SiteScope

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 agent receiving the data from the SiteScope monitor. This must be a full URL including the server, the host on which the LoadRunner Cloud 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 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.

Install and configure the LoadRunner Cloud agent

Install the LoadRunner Cloud agent

Do the following to install the LoadRunner Cloud agent:

Action How to
Get the installation package Download the LoadRunner Cloud agent from Home > Get Tools > Agents.
Run installation package

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

Select installation location

By default, the LoadRunner Cloud 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 agent

Do the following to configure the LoadRunner Cloud agent:

Access the LoadRunner Cloud agent configuration tool

When the installation is complete, the LoadRunner Cloud 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 will be able to communicate only after the LoadRunner Cloud agent is properly configured.

General tab
  • Enter a logical name for the LoadRunner Cloud Agent. This identifier will appear in LoadRunner Cloud in the list of available agents.

    Example:

    • For SiteScope, call it SiteScopeOnPrem Agent.
    • For Dynatrace, call it Dynatrace Agent.
  • Enter your LoadRunner Cloud username/password or client ID/secret key. 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 details of the LoadRunner Cloud server.
  • Select a log level.
Monitor tab

Select the relevant monitor, and enter the details:

SiteScope:

  • 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 disable 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 will be started with the HTTPS server, and metrics from SiteScope server will be sent in a secured protocol.

Dynatrace:

  • Server. Enter the details of the Dynatrace server in the following format:

    https://<Dynatrace server name>:8021

  • Username and Password. Enter the user name and password of the Dynatrace user that can access the dashboards that were set up to work with LoadRunner Cloud.
  • Use proxy for monitoring tool connection. Select this check box to use the proxy configured in the Misc tab to connect to the Dynatrace server.

Click Save & Test to save your settings and test your connection to the LoadRunner Cloud agent and cloud.

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

Launch the LoadRunner Cloud 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 agent

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

Action How to
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 Cloud agent

Do the following steps:

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

Launch the LoadRunner Cloud agent

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

Back to top

Access the LoadRunner Cloud agent configuration tool

If you skipped the LoadRunner Cloud 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 agent, check for the following text in the <installation-folder>/testexec.server/stormagent/stormagent.log file:

"got data from sis"

Back to top

See also: