--- isPrivate: true title: Bits Testing description: >- Use Bits Testing, an AI agent that explores your application to map critical user journeys and generate covering Synthetic tests. breadcrumbs: Docs > Synthetic Testing and Monitoring > Bits Testing --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Bits Testing {% callout %} ##### Join the Preview! Bits Testing is in Preview. Request access to join the waiting list. [Request Access](https://www.datadoghq.com/product-preview/bits-testing/) {% /callout %} ## Overview{% #overview %} Bits Testing is an AI agent that explores your application to map its most critical user journeys. It recommends ways to increase test coverage, and it can generate the Synthetic tests needed to close coverage gaps. Bits Testing can also generate [Goal-Based tests](https://docs.datadoghq.com/synthetics/goal_based_testing.md). This Synthetic test type uses prompted, non-deterministic, agentic testing to check that users can complete a specific goal in your application. ## Prerequisites{% #prerequisites %} If your application sits behind bot protection or a web application firewall (WAF), allow the IPs listed under `synthetics` in the [Datadog IP ranges](https://docs.datadoghq.com/api/latest/ip-ranges/list-ip-ranges.md) with your provider. To run Bits Testing from a single location, you can allow only that location's IP range instead. See Run Bits Testing for the locations Bits Testing can run from. ## Access Bits Testing{% #access-bits-testing %} Open Bits Testing from Synthetic Monitoring & Testing using any of the following: - **Bits Testing** in the Synthetic Monitoring & Testing top navigation. - `Cmd+K` on macOS or `Ctrl+K` on Windows, then search for Bits Testing. - **Bits Testing** in the side navigation menu, under **Digital Experience > Synthetic Monitoring & Testing**. ## Run Bits Testing{% #run-bits-testing %} 1. On the Bits Testing page, describe the coverage you want in plain language. For example, ask Bits Testing to increase coverage generally, or to focus on specific features. 1. Select a location to run the exploration from: - Frankfurt (GCP: `gcp:europe-west3`) - N. Virginia (AWS: `aws:us-east-1`) - Ohio (AWS: `aws:us-east-2`) - Virginia (Azure: `azure:eastus`) 1. Optionally, select an Agent Profile. 1. Click Run Now. {% image source="https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_run_config.72e944fe36ee09ac38ef57dd4a9dbbed.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_run_config.72e944fe36ee09ac38ef57dd4a9dbbed.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The Bits Testing run configuration panel with a starting URL, location, and Agent Profile selectors" /%} Bits Testing explores your application starting from the URL you provide. At each new page it encounters, it determines a set of actions to try, and it repeats this process as it moves through your application. {% image source="https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_exploration_in_progress.8c4d12c00408e69e448b469b861fbcf9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_exploration_in_progress.8c4d12c00408e69e448b469b861fbcf9.png?auto=format&fit=max&w=850&dpr=2 2x" alt="A Bits Testing run in progress, exploring an application from its starting URL" /%} ### Agent Profiles{% #agent-profiles %} An Agent Profile stores context that Bits Testing uses while interacting with your application, such as login credentials. To create an Agent Profile: 1. Open the Agent Profile dropdown menu and select - New Profile . 1. Name the profile. 1. Add one or more variables. For each variable, set: - **Usage**: The variable's purpose, for example, `username` or `password`. - **Value**: Either a typed value, or an existing [Global Variable](https://docs.datadoghq.com/synthetics/platform/settings.md#global-variables). 1. Click Create Profile. {% image source="https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_agent_profile_modal.50073acc68b4c742d6c81b32db07a6bd.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_agent_profile_modal.50073acc68b4c742d6c81b32db07a6bd.png?auto=format&fit=max&w=850&dpr=2 2x" alt="The New Profile modal for creating an Agent Profile, with fields for name, variable usage, and value" /%} The new profile is automatically selected for the current run. Saved Agent Profiles can be reused in later Bits Testing runs without redefining their variables. ## Review results{% #review-results %} When a run completes, Bits Testing displays a graph of the branches it explored: - **Successful (green)** branches led to a relevant user journey that Bits Testing can generate a test for. - **Unsuccessful (indigo)** branches didn't yield a relevant journey, either because Bits Testing judged the flow as not relevant or inconsistent, or because it encountered an error. If a run doesn't complete successfully, the graph shows the error that stopped it. {% image source="https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_results_graph.37bcb9f2bc5d63f4f44dfce0a3072702.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_results_graph.37bcb9f2bc5d63f4f44dfce0a3072702.png?auto=format&fit=max&w=850&dpr=2 2x" alt="A completed Bits Testing exploration graph showing the branches explored and the journeys found" /%} ## Generated test suites{% #generated-test-suites %} Click a green journey card to open the AI-generated test suite for that journey. A test suite can include: - **[Browser tests](https://docs.datadoghq.com/synthetics/browser_tests.md)** that replay the interactions a user takes to complete the journey, with assertions along the way. - **[HTTP tests](https://docs.datadoghq.com/synthetics/api_tests/http_tests.md)** that validate the endpoints the journey calls to retrieve data. - **[Network path tests](https://docs.datadoghq.com/synthetics/network_path_tests.md)** that check the hosts powering the journey are reachable. - **[Goal-Based tests](https://docs.datadoghq.com/synthetics/goal_based_testing.md)** that validate the journey using non-deterministic, agentic testing. Each test in the suite includes a free sample test run. Review the suite and either: - Click Ignore if the suite isn't relevant, and optionally share feedback about why. - Click Start Testing to add the suite's tests to your account. After you start testing a suite, each test becomes a regular Synthetic test that you can edit or delete. By default, generated tests run every 5 minutes from the location you selected for the Bits Testing run. {% image source="https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_generated_suite.bfa3f437a9b0ba7e9877fd57dfb01dbc.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/synthetics/bits_testing/bits_testing_generated_suite.bfa3f437a9b0ba7e9877fd57dfb01dbc.png?auto=format&fit=max&w=850&dpr=2 2x" alt="A generated test suite with Browser, HTTP, Network Path, and Goal-Based tests, showing a passed run's details" /%} ## Billing{% #billing %} During the Preview, running Bits Testing and Goal-Based tests is free. Tests you enable from a Bits Testing run are billed as regular Synthetic tests, based on test runs. See [Synthetic Monitoring pricing](https://www.datadoghq.com/pricing/?product=synthetic-monitoring#products). ## Supported locations{% #supported-locations %} Bits Testing and Goal-Based tests run only from the locations in Run Bits Testing. Browser, HTTP, and network path tests generated by Bits Testing don't have this restriction. After they're created, they support the same locations as any other Synthetic test, including [private locations](https://docs.datadoghq.com/synthetics/platform/private_locations.md). ## Further reading{% #further-reading %} Additional helpful documentation, links, and articles: - [Goal-Based Testing](https://docs.datadoghq.com/synthetics/goal_based_testing.md) - [Browser Testing](https://docs.datadoghq.com/synthetics/browser_tests.md) - [HTTP Tests](https://docs.datadoghq.com/synthetics/api_tests/http_tests.md) - [Network Path Testing](https://docs.datadoghq.com/synthetics/network_path_tests.md) - [Test Suites](https://docs.datadoghq.com/synthetics/test_suites.md) - [Global Variables](https://docs.datadoghq.com/synthetics/platform/settings.md#global-variables) - [Synthetic Monitoring pricing](https://www.datadoghq.com/pricing/?product=synthetic-monitoring#products)