diff --git a/assets/images/hyperexecute/frameworks/performance_testing/gattling.png b/assets/images/hyperexecute/frameworks/performance_testing/gattling.png new file mode 100644 index 000000000..b879bcfa8 Binary files /dev/null and b/assets/images/hyperexecute/frameworks/performance_testing/gattling.png differ diff --git a/docs/hyperexecute-gattling-testing.md b/docs/hyperexecute-gattling-testing.md new file mode 100644 index 000000000..6a971a5fb --- /dev/null +++ b/docs/hyperexecute-gattling-testing.md @@ -0,0 +1,106 @@ +--- +id: hyperexecute-gattling-testing +title: Gattling Automation on HyperExecute +hide_title: false +sidebar_label: Gattling +description: Learn how to run Selenium automation tests on HyperExecute using the Gattling framework +keywords: + - Gattling + - Gattling selenium + - Gattling Java Selenium + - Gattling automation testing + - selenium webdriver Gattling + - selenium Gattling testing tutorial + - Gattling Java Selenium framework + - lambdatest Gattling + - frameworks on lambdatest + - hyperexecute + - hyperexecute Gattling testing + - hyperexecute Gattling testing + - hyperexecute automation testing + - HyperExecute Selenium automation +url: https://www.lambdatest.com/support/docs/hyperexecute-gattling-testing/ +site_name: LambdaTest +slug: hyperexecute-gattling-testing/ +--- + +import CodeBlock from '@theme/CodeBlock'; +import {YOUR_LAMBDATEST_USERNAME, YOUR_LAMBDATEST_ACCESS_KEY} from "@site/src/component/keys"; +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + + +Gatling is an open-source load and performance testing framework designed for testing web applications. It uses a powerful Scala-based DSL to define test scenarios and is capable of simulating thousands of concurrent users, making it ideal for stress and performance testing. + +This guide provides a structured approach to integrating the Gatling performance testing framework with the LambdaTest HyperExecute platform + +## Prerequisites +To run the Tests on HyperExecute from your Local System, you are required: + +- Your LambdaTest [Username and Access key](https://www.lambdatest.com/support/docs/hyperexecute-how-to-get-my-username-and-access-key/) +- [HyperExecute YAML](https://www.lambdatest.com/support/docs/hyperexecute-yaml-version0.2/) file which contains all the necessary instructions. +- [HyperExecute CLI](https://www.lambdatest.com/support/docs/hyperexecute-cli-run-tests-on-hyperexecute-grid/) in order to initiate a test execution Job . +- Setup the [Environmental Variable](https://www.lambdatest.com/support/docs/hyperexecute-environment-variable-setup/) + +## Run a Sample Project +### Step 1: Download Project +You can use your own project to configure and test it. For demo purposes, we are using the sample repository. + +:::tip Sample repo +Download or Clone the code sample for the Gattling Performance Testing from the LambdaTest GitHub repository to run the tests on the HyperExecute. + +Image View on GitHub +::: + +### Step 2: Download the CLI in your Project +Download the HyperExecute CLI and copy it into the root folder of the downloaded sample repository. + +| Platform | HyperExecute CLI | +| ---------| ---------------- | +| Linux | https://downloads.lambdatest.com/hyperexecute/linux/hyperexecute | +| Windows | https://downloads.lambdatest.com/hyperexecute/windows/hyperexecute.exe | +| macOS | https://downloads.lambdatest.com/hyperexecute/darwin/hyperexecute | + +### Step 3: Configure your hyperexecute.yml file +Here is a complete working YAML configuration that runs Gatling performance tests on linux runners via HyperExecute: + +```yaml reference title="hyperexecute.yaml" +https://github.com/prateekLambda/Gatling-performance-hyperexecute/blob/main/HYE.yaml +``` + +> 📘 For a deeper understanding and project-specific configurations, check out the [YAML documentation](https://www.lambdatest.com/support/docs/hyperexecute-yaml-parameters/). + +### Step 4: Execute your Test Suite +From the project root directory, execute the below CLI command in your terminal: + +
+ + {`./hyperexecute --user ${ YOUR_LAMBDATEST_USERNAME()} --key ${ YOUR_LAMBDATEST_ACCESS_KEY()} --config hyperexecute.yaml`} + +
+ +> **NOTE :** In case of macOS, if you get a permission denied warning while executing CLI, simply run **`chmod u+x ./hyperexecute`** to allow permission. In case you get a security popup, allow it from your **System Preferences** → **Security & Privacy** → **General tab**. + +automation-dashboard \ No newline at end of file diff --git a/docs/hyperexecute-performance-testing.md b/docs/hyperexecute-performance-testing.md index cc9036a7a..756237b64 100644 --- a/docs/hyperexecute-performance-testing.md +++ b/docs/hyperexecute-performance-testing.md @@ -62,7 +62,6 @@ Think of it like putting your app through a rigorous training regime. We throw v HyperExecute offers a comprehensive platform for performance testing, providing users with the following benefits: -- **Seamless Integration with JMeter:** HyperExecute seamlessly integrates with Apache JMeter, a popular open-source tool for performance testing, allowing users to leverage their existing JMeter test plans in the cloud environment effortlessly. - **Real-Time Monitoring and Reporting:** HyperExecute provides real-time monitoring and reporting capabilities, enabling users to track performance metrics, identify bottlenecks, and analyze results as tests are running. This empowers users to make informed decisions and take immediate action to optimize performance. - **Customizable Load Distribution:** HyperExecute enables users to configure load distribution, specifying different data center names and percentages of load to be generated from them. This flexibility ensures efficient utilization of resources and accurate simulation of real-world scenarios. diff --git a/sidebars.js b/sidebars.js index 8ef0b001a..b6362e7c7 100644 --- a/sidebars.js +++ b/sidebars.js @@ -363,12 +363,12 @@ module.exports = { { type: "category", collapsed: true, - label: "JMeter-Performance Testing", + label: "Performance Testing", link: { type: "doc", id: "hyperexecute-performance-testing", }, - items: ["hyperexecute-run-jmeter-tests"], + items: ["hyperexecute-run-jmeter-tests", "hyperexecute-gattling-testing"], }, { type: "doc",