You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You can configure a secure tunnel in HyperExecute to test applications that are:
40
41
41
-
# Tunnel Configuration
42
+
- Hosted locally on your system, or
43
+
- Behind a private network/firewall.
42
44
43
-
***
45
+
## Prerequisites
46
+
- HyperExecute YAML file -> HyperExecute supports multiple ways of setting up tunnels directly from your YAML configuration. You can use any version of [YAML](https://www.lambdatest.com/support/docs/hyperexecute-yaml-parameters/) to pass the Tunnel parameters.
47
+
-[HyperExecute CLI](/support/docs/hyperexecute-cli-run-tests-on-hyperexecute-grid/) to trigger your tests.
44
48
45
-
## How to Configure Tunnel with HyperExecute?
46
-
47
-
> You can use any version of YAML to pass the Tunnel Parameters.
48
-
49
-
If you want to use a tunnel with HyperExecute, you will have to download the [HyperExecute CLI](/support/docs/hyperexecute-cli-run-tests-on-hyperexecute-grid/) and configure it.
50
-
51
-
There are 3 ways to use a tunnel in HyperExecute:
49
+
## Ways to Use Tunnel in HyperExecute
50
+
There are 3 main ways to use a tunnel in HyperExecute:
52
51
53
52
### 1. Simple `tunnel` Connection
53
+
Enable tunnel directly by setting the `tunnel` flag to `true` in your HyperExecute YAML file. The HyperExecute CLI will launch a tunnel as sub process for accessing your applications which are locally hosted or behind a firewall.
54
54
55
-
Set the `tunnel` flag to `true` to enable it. The cli will launch a tunnel as sub process for accessing your applications which are locally hosted or behind a firewall.
56
-
57
-
```bash
55
+
```yaml title="hyperexecute.yaml"
58
56
tunnel: true
59
57
```
58
+
> Recommended if you want to quickly enable tunnel access for locally hosted apps.
60
59
61
60
### 2. Using Existing `tunnel`
61
+
If you already have a running tunnel, you can reuse it by specifying its name to access your applications which are locally hosted or behind a firewall.
62
62
63
-
Specify the list of already running tunnel names which you want to use for accessing your applications which are locally hosted or behind a firewall.
64
-
65
-
```bash
63
+
```yaml title="hyperexecute.yaml"
66
64
tunnelNames: ["lambdatest_tunnel"]
67
65
```
68
66
69
-
### 3. Advanced `tunnel` Configurations
67
+
> Useful when running multiple jobs and you don’t want to spawn new tunnels each time.
70
68
69
+
### 3. Advanced `tunnel` Configurations
71
70
These are the parameters you can use to configure your [tunnel](/support/docs/deep-dive-into-hyperexecute-yaml/#tunnel) settings when running it.
72
71
73
72
| Options | Type | Description |
@@ -79,7 +78,11 @@ These are the parameters you can use to configure your [tunnel](/support/docs/de
79
78
|`systemProxy`| Boolean | Should the tunnel be OS system wide? Default false. |
80
79
|`checkTunnelOnFailure`| Boolean | Check tunnel on failure adds a check on our system to check the tunnel connection if a test fails and the tunnel is set to true. This option will retry the test 2 times if tunnel connection is flaky. |
81
80
82
-
```bash
81
+
> HyperExecute now supports tunnel capabilities for [Maestro](https://www.lambdatest.com/support/docs/hyperexecute-maestro-testing/) tests running on both virtual devices and real devices using the Raw Framework configuration.
> HyperExecute now supports [tunnel capabilities](/support/docs/hyperexecute-how-to-configure-tunnel/) for Maestro tests running on both virtual devices and real devices using the Raw Framework configuration.
139
+
138
140
## Step 5: Generate JUnit XML Report
139
141
1. Update the `runTest.sh` file to include the `--format junit` flag in the maestro test command:
HyperExecute now supports the `syncStart` directive in the job YAML. When enabled, all VMs in `autosplit` or `matrix` mode start their tasks simultaneously after allocation—ideal for benchmarking or comparative test runs.
48
+
49
+
If some VMs are not ready within 15 minutes, the job starts with the available ones.
50
+
51
+
> **NOTE :** For detailed usage and examples, refer to the detailed [HyperExecute documentation](/support/docs/deep-dive-into-hyperexecute-yaml/#syncstart).
Debugging large test executions often generates extensive logs, making it difficult to identify key issues. The new **Logs Categorization** feature enhances log readability by automatically highlighting and grouping critical entries.
48
+
49
+
HyperExecute categorizes logs into Errors and Warnings using intelligent pattern detection based on regular expressions (regex). This will help you quickly locate and review the most relevant log lines during test analysis.
Copy file name to clipboardExpand all lines: docs/hyperexecute-yaml-parameters.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -165,7 +165,7 @@ The **HyperExecute YAML** file serves as the foundational component for test exe
165
165
|[project](/support/docs/deep-dive-into-hyperexecute-yaml/#project)| String | Segregate data at a project/repo level |
166
166
|[slackChannel](/support/docs/deep-dive-into-hyperexecute-yaml/#slackchannel)| String | Allows you to receive notifications of your Job updates directly in your preferred Slack channel. |
167
167
|[afterEachScenario](/support/docs/deep-dive-into-hyperexecute-yaml/#aftereachscenario)| List of Strings | Allows you to trigger your define tasks after each test scenario. |
168
-
|[syncStart](/support/docs/deep-dive-into-hyperexecute-yaml/#execution)| Map | Ensures all VMs are ready before starting parallel tasks.|
168
+
|[syncStart](/support/docs/deep-dive-into-hyperexecute-yaml/#syncstart)| Map | Ensures all VMs are ready before starting parallel tasks.|
Copy file name to clipboardExpand all lines: docs/hyperexecute-yaml-version0.2.md
+13Lines changed: 13 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -67,6 +67,7 @@ The ```framework``` field in Hyperexecute YAML Version 0.2 allows you to configu
67
67
|[artifacts](#artifacts)| Boolean | No | Specifies whether to generate artifacts or not |
68
68
|[language](#language)| String | No | Specifies the device’s system language for the test session. This determines the language in which your app’s UI and strings will be displayed. |
69
69
|[locale](#locale)| String | No | Defines the regional format settings such as date, time, currency, and number conventions. |
70
+
|[mitmProxy](#mitmProxy)| Boolean | No | Capture network logs directly from emulator sessions using MITM. |
70
71
71
72
### `name`
72
73
Specifies the testing framework used in your repository.
@@ -204,6 +205,17 @@ framework:
204
205
```
205
206
206
207
208
+
### `mitmProxy`
209
+
210
+
You can now capture network logs directly from emulator sessions using MITM. This enhancement enables deeper debugging of API calls, request/response payloads, and overall network traffic during test execution.
0 commit comments