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 of supported version, 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.

Tip: 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 the port number (default 3000), but it must be the same as the port number you configure for the LoadRunner Cloud agent > Monitor tab > Data Integration Port (see Monitor tab below).

      Use the following syntax:

      http or https://<fully qualified domain name of the LoadRunner Cloud agent host>:<port number specified by 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.
  • Select the interval at which the LoadRunner Cloud agent will poll the server (every 5 seconds, every 10 seconds, or every 20 seconds).
Monitor tab

Select the relevant monitor, and enter the details:

SiteScope:

  • Data Integration Port. You can choose the port number (default 3000), but it must be the same as the port number you configure for the SiteScope data integration's Receiver URL.

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: