Installing and configuring HCL OneTest Server Results Data

You must install and configure HCL OneTest Server Results Data that is delivered as a plug-in along with HCL OneTest™ Server to view and analyze the log data in Grafana. You can view the test log data that is generated when you run a test from HCL OneTest™ Server in a Grafana dashboard.

Before you begin

You must have configured your installation so that Grafana server can access HCL OneTest™ Server.

Procedure

  1. Download HCL OneTest Server Results Data plug-in from the following URL: <your server address>/artifacts/grafana/hcltechsw-otsresults-datasource.zip.
  2. Install HCL OneTest Server Results Data plug-in by extracting the compressed file into your Grafana plug-in directory.
    Important: Before you install HCL OneTest™ Server, you must be aware that you must use an additional helm command parameter gateway.allowedOrigin during the installation or you can run this command after installation too as detailed in Additional Helm parameters.
  3. Restart the Grafana server.
  4. Enter the address of the local Grafana server in your web browser:
    Important: The plug-in is signed to be used with http://localhost:3000 or http://localhost:8080 URLs.
  5. To verify that HCL OneTest Server Results Data is available in Grafana, follow these steps:
    1. Click Configuration > plug-in in the left navigation panel of Grafana.
    2. Enter HCL OneTest Server Results Data in the search bar in the Plugins tab.
    3. Click HCL OneTest Server Results Data in the search results.
    The HCL OneTest Server Results Data readme page is displayed. You can find the links to HCL OneTest™ Server documentation and the description of the plug-in on this page.
  6. Create an instance of data source in Grafana for HCL OneTest Server Results Data by performing the following steps.
    Note: Users with the role as a server administrator can add data sources.
    1. Click Configuration > Data sources in the left navigation panel.
    2. Click Add data source.
    3. Enter HCL OneTest Server Results Data in the search bar, and then press Enter.

      HCL OneTest Server Results Data is displayed in the search results.

    4. Click Select.

      The data source configuration panel is displayed to enter the data source settings.

    5. Click Default if you want to define this instance of HCL OneTest Server Results Data as the default data source in Grafana.
      Note: Ensure that HCL OneTest Server Results Data is accessible through a web browser.
    6. Enter a name to identify the data source.
    7. Enter the URL of HCL OneTest™ Server in the Server field.
    8. Enter the token that you created from HCL OneTest™ Server to enable third-party integrations.
    9. Click Save and test.
    If the test is successful, an instance of data source is created for HCL OneTest Server Results Data.

Results

HCL OneTest Server Results Data is displayed in the list of data sources in Grafana.

What to do next

You can retrieve the test log data from HCL OneTest™ Server by using queries.