All pages
Powered by GitBook
1 of 3

Loading...

Loading...

Loading...

Create LoadRunner Professional telemetry instances

To create an instance of the LoadRunner provider, build a YAML file (instance.yml in this example) with the definition of the instance:

Then you can create the instance for the system using the Akamas CLI:

Configuration options

When you create an instance of the LoadRunner provider, you should specify some configuration information to allow the provider to correctly extract and process metrics from LoadRunner.

You can specify configuration information within the config part of the YAML of the instance definition.

Required properties

  • hostname: The hostname or IP of the server that hosts the CIFS share where the LoadRunner results have been exported. See .

  • username: The username and the domain required to access the network share. Supported formats are:

    • username

Telemetry instance reference

The following YAML file provides the reference for the definition of a telemetry instance.

The following table describes the reference for the config section within the definition of the LoadRunner provider instance:

Field
Type
Description
Default Value
Restrictions
Required

LoadRunner Professional provider

The LoadRunner provider collects metrics generated by a LoadRunner instance (converted to their JSON format and placed in CIFS network share) and makes them available to Akamas.

Prerequisites

This section provides the minimum requirements that you should match before using the LoadRunner telemetry provider.

Supported versions

  • Micro Focus LoadRunner 12.60 or 2020

Network requirements

  • The network share is reachable at port 445/TCP

  • The network share is reachable at port 139/UDP

Permissions (optional)

  • Username, domain (if required), and password of the network share.

  • Read permission on the network share.

Supported component types

  • Web Application

You can check to see how component-types metrics are extracted by this provider.

Setup the data source

The provider expects that its required data are on a CIFS share. If you are using the , please follow the instruction on here below on how to export LoadRunner results in a network share by setup a share on the LoadRunner Controller.

Share a Controller folder

To share a folder on Windows, please follow these steps:

  1. Right-click on the folder, then select Properties

  2. Go to Sharing tab, then select Advanced Sharing

  3. In the opened window, enable Share this folder

Mount network share on the controller

  1. Open "This PC" from the Start menu, then click on "Map network drive"\

  2. In the "Map Network Drive" window, select a suitable drive letter name and enter the remote folder path of the network share that has been given to you by your storage admin (it should be something with the format \\mycompanyshareserver.mycompany\foldername)\

  3. Make sure to check "Reconnect at sign-in" and "Connect using different credentials".

Components configuration

Akamas reasons in terms of a system to be optimized and in terms of parameters and metrics of components of that system. To understand the link between metrics collected from LoadRunner and a specific component, the LoadRunner provider looks up the property loadrunner in the components of a system:

# LoadRunner Telemetry Provider Instance
provider: LoadRunner
config:
 hostname: cifsserver.mycompany.com
 username: akamas
 password: mypassword
 shareName: akamas_lr_results
akamas create telemetry-instance instance.yml system

domain\username

  • username@domain

  • password: The password required to access the network share

  • shareName: The name of the network share as it is exposed by the server

  • The username and the domain required to access the share

    -

    Supported formats:

    • username

    • domain\username

    • username@domain

    Yes

    password

    String

    The password required to access the share

    -

    -

    Yes

    shareName

    String

    The name of the share as it is exposed by the server

    -

    -

    Yes

    pathPrefix

    String

    A prefix for the default path where the provider looks for the data.

    The default path is {studyName}{experimentId}{trialId}

    See

    -

    A valid Windows path

    No

    hostname

    String

    the hostname or IP of the server that hosts the CIFS share where the LoadRunner results have been exported. See LoadRunner operator

    -

    IP address or FQDN

    Yes

    username

    LoadRunner operator

    String

    In the "
    Share name
    " textbox type the name of the share. This is the name of the share over the network\
  • Then click on Permissions, then Add

  • In the textbox type the name of the user or the group (with the domain if required) that you want to grant access to the share, then click "OK"\

  • Select the added user (or group) and grant the required permissions\

  • Click OK, OK, and then Close

  • Click Finish

  • In the "Windows Security" window enter the username (with the domain, if required) and the password for the network share and check "Remember my credentials".

  • Click "OK"

  • LoadRunner provider metrics mapping
    LoadRunner operator

    Install LoadRunner Professional provider

    To install the LoadRunner provider, create a YAML file (called provider.yml in this example) with the definition of the provider:

    Then you can install the provider using the Akamas CLI:

    The installed provider is shared with all users of your Akamas installation and can monitor many different systems, by configuring appropriate telemetry provider instances.

    provider: LoadRunner # this is an instance of the LoadRunner provider
    config:
     hostname: cifsserver.mycompany.com # Share server
     username: user@mycompany
     password: mypassword
     shareName: akamas_lr_results
     pathPrefix:YAML
    # Specification for a component, whose metrics should be collected by the Prometheus Provider
    name: "WebApplication1" # name of the component
    description: "LoadRunner controller" # description of the component
    properties:
      loadrunner: ""   # the presence of this property helps akamas discriminate metrics imported using loadrunner from the ones provided by other providers
    LoadRunner operator
    # LoadRunner Telemetry Provider
    name: LoadRunner
    description: Telemetry Provider that enables to import of metrics from LoadRunner installations
    dockerImage: 485790562880.dkr.ecr.us-east-2.amazonaws.com/akamas/telemetry-providers/loadrunner-provider:3.1.0
    akamas install telemetry-provider provider.yml