Merge pull request #2331 from splunk/gschatz-O11YDOCS-6478

chrome flag feature

Author: gschatz-splunk

_includes/synthetics/chrome-flags.rst

@@ -0,0 +1,22 @@
+.. list-table::
+  :header-rows: 1
+  :widths: 40 60
+  :width: 100%
+
+  * - :strong:`Chrome flag`  
+    - :strong:`Description`
+  * - ``--disable-http2``
+    - Requests are made using using ``http/1.1`` instead of ``http/2.0``. This HTTP version is viewable in the HAR file.
+  * - ``--disable-quic``
+    - Deactivates QUIC, which also deactivates HTTP3.
+  * - ``--disable-web-security``
+    - Deactivate enforcement of same origin policy.
+  * - ``--unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test``
+    - Treat given insecure origin as secure. Multiple origins can be supplied in a comma-separated list.
+  * - ``--proxy-bypass-list="*.google.com;*foo.com;127.0.0.1:8080"``
+    - Proxy bypass list for any specified proxy for the given semi-colon-separated list of hosts. This flag must be used with ``--proxy-server``.
+  * - ``--proxy-server="foopy:8080"``
+    - Uses a specified proxy server to override default settings.
+  * - ``--no-proxy-server``
+    - Don't use a proxy server, always make direct connections. This flag can be used to override any other proxy server flags that you may have set up in a private location. 
+

synthetics/browser-test/set-up-browser-test.rst

@@ -392,7 +392,6 @@ Auto-retry
 
 Run a test again automatically if it fails without any user intervention. It's a best practice to turn on auto-retry to reduce unnecessary failures from temporary interruptions like network issues, timeouts, or intermittent issues on your site. Auto-retry runs do not impact subscription usage, only the completed run result counts towards your subscription usage. Auto-retry requires at least runner version 0.9.29.
 
-.. Security
 
 .. _browser-validation:
 
@@ -420,7 +419,6 @@ When executing the browser test, the Chrome browser is configured with the crede
 
 More details on Chrome authentication are available :new-page:`here list <https://www.chromium.org/developers/design-documents/http-authentication/>`.
 
-.. Custom content
 
 .. _browser-headers:
 
@@ -510,6 +508,19 @@ Here are the limits for each type of wait time. The maximum limit for a run is 3
 
 
 
+Chrome flags 
+----------------
+Google Chrome flags are a helpful tool for troubleshooting. Activate browser features that are not available by default to test custom browser configurations and specialized use cases, like a proxy server.
+
+For more, see 
+:new-page:`What are Chrome flags? <https://developer.chrome.com/docs/web-platform/chrome-flags>` in the Google Chrome Developer guide. 
+
+Note: Global variables are incompatible with Chrome flags. 
+
+These are the flags available: 
+
+
+.. include:: /_includes/synthetics/chrome-flags.rst