--- sourceDocument: Brazil Build or modify applications sourceDocumentLink: https://www.servicenow.com/docs/r/application-development Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil Build or modify applications ft:clusterId : - cadev bundleId : - cadev workflow : - Development, Data, and Analytics --- # ATF Health Check # ATF Health Check {#ariaid-title1} Release version: Brazil Updated September 18, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read ATF Health Check detects ATF misconfiguration that may lead to support cases by scanning your instance for 14 known issues and providing findings you can resolve proactively. ATF Health Check is a set of Instance Scan checks for the Automated Test Framework (ATF). It inspects your instance's ATF configuration, tests, and step definitions for a known list of configurations and deviations from general guidelines. Each issue is reported as a finding you can act on. The checks were built directly from the issues seen most often in ATF-related support cases. Examples include `gs.sleep()` calls left in test scripts, tests that modify large numbers of existing records, ATF Debug mode left enabled, and an invalid ATF Cloud User. Running the scan lets you confirm whether any of those issues are present on your instance, so you can resolve them proactively. ## Prerequisites {#atf-health-check-suites__section_prerequisites} The following prerequisites must be met to use ATF Health Check: * The base Automated Test Framework plugin (`com.glide.automated_testing_framework`) and the Instance Scan plugin (`com.glide.instance_scan`) must be active * You need the `admin` role to execute the scan suites * The `admin` role is also required to change the configurable modified-records threshold * The four checks in the ATF Test Generator and Cloud Runner suite run only if the ATF Test Generator and Cloud Runner Store app (`sn_atf_tg`) is active. Otherwise, they are skipped automatically ## Terminology {#atf-health-check-suites__section_terminology} Instance Scan : The ServiceNow platform capability that runs configurable checks against an instance and reports the results as findings Suite : A named, organized group of related checks that can be run together Check : A single, specific test performed during a scan---for example, "is ATF Debug mode enabled?" Finding : A flagged result produced when a check's condition is met---that is, an issue was detected ## What's Included {#atf-health-check-suites__section_whats_included} ATF Health Check adds one parent suite with two child suites underneath it: ATF Health Check Suites (parent): Root container for the following child suites. Run this suite to execute every ATF Health Check scan in one pass * ATF Core (10 checks): Covers core ATF configuration, test design, and performance. Available on any instance with the base ATF plugin active. Organized into Performance checks (7) and Upgradability checks (3) * ATF Test Generator and Cloud Runner (4 checks): Covers the ATF Test Generator and Cloud Runner (TG/CR) store app. These checks only execute if `sn_atf_tg` is active. Organized into Manageability checks (3) and Upgradability checks (1) {#atf-health-check-suites__ul_hpd_qcn_rkc} Each finding links directly to the affected record, so you can navigate and resolve issues immediately. ## Check categories {#atf-health-check-suites__section_check_categories} Checks are organized by category to help you prioritize and understand the scope of each issue: * Performance: Identifies configurations that slow down test execution, such as debug mode, fixed waits, excessive screenshots, or tests that modify too many records * Upgradability: Verifies that ATF data, configurations, and tests follow best practices that support clean instance cloning and upgrades * Manageability: Validates that infrastructure and integrations (mutual authentication, Cloud Runner app, ADCV2 configuration) are correctly configured for Test Generator and Cloud Runner {#atf-health-check-suites__ul_xbj_ycn_rkc} * **[Run an ATF Health Check scan](https://www.servicenow.com/docs/lznRz904nCqmUh4BOTdQUg)** Execute an ATF Health Check scan to detect configuration issues on your instance. You can run a full suite of all 14 checks, run only core checks, run checks for ATF Test Generator and Cloud Runner, or run a single check. * **[ATF Health Check checks and configuration](https://www.servicenow.com/docs/EZum1R94yBVt10MfIpcNOw)** Look up all 14 ATF Health Check scans, understand what each check detects, and configure the modified-records threshold to fit your environment. **Related concepts** * [Reusable tests](https://www.servicenow.com/docs/v7l0QfXfxAJa0VCwveMYBA "Leverage reusable tests to simplify test maintenance and streamline the management of large tests and test suites. Reusable tests reduce redundancy, ensuring consistent and reliable test execution across your system.") * [Mutually exclusive tests](https://www.servicenow.com/docs/6v1MZXBoyJVvaDitNczI~w "Prevent conflicting tests from running in parallel by marking them as mutually exclusive. For example, when the system identifies tests that modify the same record, the system makes these tests mutually exclusive. You can also manually mark tests as mutually exclusive.") * [Quick start tests](https://www.servicenow.com/docs/23fRkv3gDn87n2Gi9Fn5DA "Copy and customize quick start tests provided by the ServiceNow AI Platform to validate that your instance works after you make any configuration changes. For example, if you apply an upgrade or develop an application.") * [Parallel testing](https://www.servicenow.com/docs/yN0eKmLxVs4nTmguBjpMPA "Reduce test design time by running multiple tests and test suites in parallel. Design tests to run in parallel by avoiding resource conflicts and data dependencies.") * [Performance profiling](https://www.servicenow.com/docs/fIsCPZiTOOZ3HZxkkB7JLA#atf-perf-prof "Performance profiling allows you to do performance testing on your instances.") * [ATF administration overview](https://www.servicenow.com/docs/xHrnxTD7ARPilnINXxy6Ng "Enable or disable the Automated Test Framework, modify retention policies, move tests between instances, control user access to the Automated Test Framework, and create custom test step configurations and step environments.") * [Optimizing ATF performance](https://www.servicenow.com/docs/GWLONEWi8P~lfUac31W__w "You can troubleshoot automatic test performance by inspecting system transaction log records and potentially shorten execution time by adjusting how often automatic tests capture screenshots.") * [ATF test suites overview](https://www.servicenow.com/docs/YADpXw3tVCkSNbAjIpPWbg "Run a group of tests in a specific order to test an application or a group of related features.") **Related tasks** * [Accelerate ATF tests failure resolution](https://www.servicenow.com/docs/~HRGRsGb5DZW5qDDMeS2fw "Resolve ATF test failures faster using the actionable support provided by the new ATF failure insights feature. You can achieve it by accessing the Find changes since last successful run related link.")