StormRunner Load agent

Use the StormRunner Load 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 StormRunner Load agent, to StormRunner Load where it is displayed on the SiteScope on-premises monitor.

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

StormRunner agent system requirements

OS Windows 2008 R2
CPU 2
Memory 4 GB

Back to top

Set up my third-party monitoring tool to support the StormRunner Load agent

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 versions 6.5 and later.
  • SiteScope versions 11.24, 11.30, 11.32.
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 StormRunner agent machine are correct.

Tip: Synchronize your computer clock with an Internet time server.

StormRunner Load agent port

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

Configure your monitoring tool to work with StormRunner Load

Dynatrace

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

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

SiteScope

Create a monitor group for data integration with StormRunner Load.

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 StormRunner Load agent receiving the data from the SiteScope monitor.

      This must be a full URL including the server, the host on which the StormRunner Load 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 StormRunner Load agent > Monitor tab > Data Integration Port (see Monitor tab below).

      Use the following syntax:

      http or https://<fully qualified domain name of the StormRunner Load 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 StormRunner Load agent

Install the StormRunner Load agent

Do the following to install the StormRunner Load agent:

Action How to
Get the installation package Download the StormRunner Load agent from Home > Get Tools > Agents
Run installation package

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

Select installation location

By default, the StormRunner Load agent is installed in c:\stormrunner_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 StormRunner Load agent

Do the following to configure the StormRunner Load agent:

Access the StormRunner Load agent configuration tool

When the installation is complete, the StormRunner Load agent configuration tool opens.

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

Note: StormRunner Load and the relevant monitoring tool will be able to communicate only after the StormRunner Load agent is properly configured.

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

    Example:

    • For SiteScope, call it SiteScopeOnPrem Agent.
    • For Dynatrace, call it Dynatrace Agent.
  • Enter your StormRunner Load user name and password.
  • Enter your StormRunner Load 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 StormRunner Load server.
  • Select a log level.
  • Select the interval at which the StormRunner Load 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:

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 StormRunner.
  • 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 StormRunner agent and cloud.

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

Launch the StormRunner Load agent

Go to Start > StormRunner agent > Start agent.

Add the relevant monitor to the StormRunner Load assets

For details, see Monitors.

Back to top

Update the SiteScope agent to the StormRunner Load agent

The StormRunner Load 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 StormRunner Load agent

Do the following steps:

  1. Install the StormRunner Load agent.
  2. Configure the StormRunner Load agent.

Launch the StormRunner Load agent

Go to Start > StormRunner agent > Start agent.

Back to top

Access the StormRunner Load agent configuration tool

If you skipped the StormRunner Load agent configuration when you installed/updated it, or if you need to update the configuration settings:

Go to Start > StormRunner agent > Configure agent.

Back to top

Troubleshooting

To verify that SiteScope data is being received by the StormRunner Load 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: