{"id":15166057,"url":"https://github.com/jenkinsci/loadrunner-cloud-plugin","last_synced_at":"2025-09-30T21:31:06.315Z","repository":{"id":66295796,"uuid":"529207062","full_name":"jenkinsci/loadrunner-cloud-plugin","owner":"jenkinsci","description":"Jenkins plugin for LoadRunner Cloud","archived":false,"fork":true,"pushed_at":"2024-09-12T13:55:31.000Z","size":908,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-09-30T05:48:09.156Z","etag":null,"topics":["builder","cloud-testing","jenkins-plugin","load-testing","loadrunner-cloud","performance-testing","report"],"latest_commit_sha":null,"homepage":"https://www.microfocus.com/en-us/products/loadrunner-cloud/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"MicroFocus/lrc-jk-plugin","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null}},"created_at":"2022-08-26T10:06:33.000Z","updated_at":"2024-09-12T13:55:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"92de2904-3b62-4414-aed6-e17bf813ded2","html_url":"https://github.com/jenkinsci/loadrunner-cloud-plugin","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Floadrunner-cloud-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Floadrunner-cloud-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Floadrunner-cloud-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Floadrunner-cloud-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/loadrunner-cloud-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234782971,"owners_count":18885818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["builder","cloud-testing","jenkins-plugin","load-testing","loadrunner-cloud","performance-testing","report"],"created_at":"2024-09-27T04:23:06.995Z","updated_at":"2025-09-30T21:31:05.951Z","avatar_url":"https://github.com/jenkinsci.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://ci.jenkins.io/job/Plugins/job/loadrunner-cloud-plugin/job/main/badge/icon)](https://ci.jenkins.io/job/Plugins/job/loadrunner-cloud-plugin/job/main/)\n[![CodeQL](https://github.com/jenkinsci/loadrunner-cloud-plugin/actions/workflows/codeql.yml/badge.svg)](https://github.com/jenkinsci/loadrunner-cloud-plugin/actions/workflows/codeql.yml)\n[![Jenkins Security Scan](https://github.com/jenkinsci/loadrunner-cloud-plugin/actions/workflows/jenkins-security-scan.yml/badge.svg)](https://github.com/jenkinsci/loadrunner-cloud-plugin/actions/workflows/jenkins-security-scan.yml)\n\n- [Introduction](#introduction)\n- [Getting Started](#getting-started)\n - [System Configuraiton](#system-configuration)\n - [Job Configuraiton](#job-configuration)\n - [Freestyle](#freestyle)\n - [Pipeline](#pipeline)\n - [Results](#results)\n - [Trending](#trending)\n- [Notes](#notes)\n- [Releases](#releases)\n\n# Jenkins plugin for LoadRunner Cloud\n\n## Introduction\n\nThis is the official plugin for [LoadRunner Cloud](https://www.microfocus.com/en-us/products/loadrunner-cloud). \nThe plugin lets you run a test in LoadRunner Cloud and collect results. \nIt provides a build step **Run test in LoadRunner Cloud** to run tests, and a post-build action **Generate LoadRunner Cloud trending report** to generate trending reports.\nBoth steps are also exposed in the pipeline job as `lrcRunTest` and `lrcGenTrendingReport`.\n\n## Getting started\n\n### System configuration\n- Navigate to **Manage Jenkins** \u0026rarr; **System Configuration** \u0026rarr; **Configure System** \u0026rarr; **LoadRunner Cloud** and then configure the following settings: \n - **Client ID** and **Client Secret** \n Refer to [API access keys](https://admhelp.microfocus.com/lrc/en/Latest/Content/Storm/Admin-APIAccess.htm) for details. You can still input **Username** and **Password** in the fields (depends on the feature toggle in your tenant). However, it's recommended to use API access keys.\n - **URL**, default: \"https://loadrunner-cloud.saas.microfocus.com\"\n - **Tenant ID**, for example: 123456789\n - **Proxy** settings (optional). If you need to use a proxy to access LoadRunner Cloud, select **Connect LoadRunner Cloud via proxy** checkbox, then configure the following fields.\n - Proxy Host\t - The proxy server host name.\n - Proxy Port\t - The proxy server port number.\n - Proxy Username\t- The username to log into the proxy server.\n - Proxy Password\t- The password to log into the proxy server.\n \u003e **Notes**: The above proxy settings are only applicable for connections between Jenkins and LoadRunner Cloud. \n\n![System configuration](/images/system_config.png \"LoadRunner Cloud\")\n\n- Sample configuration for \n[Jenkins configuration as Code](https://github.com/jenkinsci/configuration-as-code-plugin): \n```yaml\nunclassified:\n lrcRunTest:\n tenantId: \"\u003cTENANT ID\u003e\"\n url: \"https://loadrunner-cloud.saas.microfocus.com\"\n clientId: \"\u003cCLIENT ID\u003e\"\n clientSecret: \"\u003cCLIENT SECRET\u003e\"\n useProxy: false\n proxyHost: \"\u003cPROXY HOST\u003e\"\n proxyPort: \"\u003cPROXY PORT\u003e\"\n proxyUsername: \"\u003cPROXY USERNAME\u003e\"\n proxyPassword: \"\u003cPROXY PASSWORD\u003e\"\n```\n\n### Job configuration\n\n#### Freestyle\nIn a freestyle project, in **Add build step**, select **Run test in LoadRunner Cloud** and then configure the **Test ID** and **Project ID**. \n\u003e **Tip:** To build a more flexible job, you can use string parameters (LRC_TEST_ID, LRC_PROJECT_ID) to override the **Test ID** and **Project ID**. \n \n![Job configuration](/images/job_config.png \"Run test in LoadRunner Cloud\")\n\n#### Pipeline\nBelow is an example on how to run a test and generate a trending report in a pipeline:\n\n```groovy\npipeline {\n agent any\n \n stages {\n stage('lrc') { \n steps {\n lrcRunTest testId: \"2398\", projectId:'45', sendEmail: false\n lrcGenTrendingReport benchmark: 0, runsCount: 5, trtAvgThresholdImprovement: 5, trtAvgThresholdMajorRegression: 10, trtAvgThresholdMinorRegression: 5, trtPercentileThresholdImprovement: 5, trtPercentileThresholdMajorRegression: 10, trtPercentileThresholdMinorRegression: 5\n }\n }\n }\n}\n```\n### Results\n\nAfter the build is completed, the plugin generates the following files (if they are available) in the workspace folder.\n\n| File | Description |\n|------------------------------|-----------------------------------------------------------------------------------------------------------------|\n| **lrc_report_XXX.xml** | A JUnit XML file containing basic information about the test run, such as name, status, duration, and so forth. |\n| **lrc_report_XXX.csv** | A CSV file containing detailed test run results with metrics, such as Vuser count, error count, and so forth. |\n| **lrc_report_XXX.pdf** | A PDF file containing report data for the test run. |\n| **lrc_report_trans_XXX.csv** | A CSV file containing detailed statistics for each transaction in the test run. |\n\n\u003e **Notes:** \n\u003e - In the above, \"XXX\" refers to tenant id-run id. For example: 652261300-123.\n\u003e - If a Jenkins job that includes a running test is aborted, the plugin will attempt to stop the corresponding test run in LoadRunner Cloud. **It does not collect results**. The attempt may fail if there are network problems, or if Jenkins aborts the job before the plugin can stop the test run.\n\u003e - If a PDF report is not needed, define a boolean or string parameter (LRC_SKIP_PDF_REPORT: true) to skip it.\n\u003e - The test run id is exposed in the environment variable: **LRC_RUN_ID**.\n\n### Trending\nIf you need a trending report, select **Generate LoadRunner Cloud trending report** in **Add post-build action**.\n![Trending configuration](/images/trending_config.png \"Generate LoadRunner Cloud trending report\")\n\n| Item | Description |\n|----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Number of Runs** | The number of last successful runs to include in the report. The valid range is 5-10. |\n| **Benchmark** | Enter a specific test run ID to use as a benchmark, or leave blank to compare a run to the previous run.\u003cbr/\u003e**Note**: If you change the benchmark run ID, only those load tests that run after the change are compared to the new benchmark. Load tests that ran before the change show their original comparison. |\n| **Thresholds: TRT (Avg)** | \u003cEnter a positive integer from 1 to 100\u003e |\n| Improvement | The percentage decrease in average transaction response time considered to be an improvement in performance. |\n| Minor Regression | The percentage increase in average transaction response time considered to be a minor regression in performance. |\n| Major Regression | The percentage increase in average transaction response time considered to be a major regression in performance. |\n| **Thresholds: TRT (Percentile)** | \u003cEnter a positive integer from 1 to 100\u003e |\n| Improvement | The percentage decrease in percentile transaction response time considered to be an improvement in performance. |\n| Minor Regression | The percentage increase in percentile transaction response time considered to be a minor regression in performance. |\n| Major Regression | The percentage increase in percentile transaction response time considered to be a major regression in performance. |\n\nYou can view the trending report by clicking the \"**LoadRunner Cloud Trending**\" menu. It shows the trends for the last 5-10 runs of the load test configured in the job. \n\n![Trending menu](/images/trending_menu.png \"LoadRunner Cloud Trending menu\")\n\u003e **Notes:** If you start multiple LoadRunner Cloud test runs in one Jenkins build, only the last test run will be processed by **Generate LoadRunner Cloud trending report**.\n\n## Notes\n- Keep your password or secret safe.\n- The plugin requires Jenkins version **2.289.3** or above.\n- It is recommended to use the latest Jenkins [**LTS**](https://get.jenkins.io/war-stable/) release.\n- It is recommended to update the plugin to the latest version.\n \u003e **Tip**: **Manage Jenkins** \u0026rarr; **Manage Plugins**, on the **Updates** tab, click **Check now** to check for the most recent plugin updates.\n\n## Releases\nSee [GitHub Releases](https://github.com/jenkinsci/loadrunner-cloud-plugin/releases)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Floadrunner-cloud-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Floadrunner-cloud-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Floadrunner-cloud-plugin/lists"}