Configuring and viewing Zia RCA in Zoho QEngine | Zoho QEngine Help

Configuring and viewing Zia RCA in Zoho QEngine

What does this page cover

This document guides you to configure and use Zia RCA in Zoho QEngine. Before you begin, it's essential to understand how Zia RCA works. Learn about Zia Root Cause Analysis.

Availability 

  1. Zia Root Cause Analysis is available across all plans of Zoho QEngine.
  2. Only super admins and admins can configure Zia by integrating an AI model that powers it, and enable Zia RCA for a test plan
  3. Super admins, admins, managers, and testers can view Zia RCA once it is set up.
  4. Zia RCA is available only for Web platform.

1. Enabling Zia RCA for a test plan

1.1 Prerequisite

Configure an AI model for Zia

Zia is powered by Zoho GenAI by default and needs no additional setup. To use a different provider, such as OpenAI, Gemini, or Claude, set it up in Zia. See Configuring Zia for Zoho QEngine for the steps.

NotesNote: Only super admins and admins can configure an AI model for Zia. Managers and testers can view Zia RCA once an AI model is configured. 


1.2 Steps to enable Zia RCA for a test plan

  1. Navigate to Test Plans and click + Create Test Plan to set up a web test plan, or click an existing web test plan to edit.
  2. Select Web as the platform type, under Environments.
  3. Select Yes from the Enable Zia RCA drop-down. This field will only appear when the platform type is selected as Web.



  4. Click Create if you are setting up a new test plan, or Update if you are editing an existing one.

Notes

Note:

  1. Zia RCA will begin analyzing this test plan starrting with its next run. Runs that are already in progress, or completed will not be analyzed.
  2. Enabling Zia RCA will not generate any tags or perform analysis if an AI model has not been configured for your portal. Learn how to Troubleshoot

2. Viewing Zia RCA in results

Zia RCA's tags and analysis appear directly on the Results page, scoped to the environment you're viewing. You can view test case tags and metrics, and open the analysis for an environment or an individual test case.

2.1 Viewing the Zia Tag column and metrics

NotesNote: Zia RCA is available in test plan results only when it is enabled for the corresponding test plan. Learn how to enable Zia RCA for a test plan
  1. Open the Results page for a test plan run.
  2. Select the environment you want to view. If the run covers more than one environment, either use the environment drop-down, or click directly on the environment from the Results page.
  3. View the Zia Tag column next to Duration. It is populated automatically as soon as the run finishes. Each test case shows its primary tag, with a +N indicator if additional tags apply. Learn about tag categories in Zia RCA for what each tag means.

The Results page also shows the environment's Total, Passed, Failed, and Flaky counts, and its Health Score once the environment analysis has been generated. Learn more about Metrics in Zia RCA 

2.2 Viewing the Zia analysis for an environment

  1. Select the environment you want to view from the environment drop-down.



  2. Click the Zia icon {} in the Results header for the selected environment.

     

NotesNote:
  1.  If every test case in the environment was individually analyzed, the full environment analysis is displayed directly. In case any of the test cases isn't individually analysed, you i'll prompted to run the zia analysis manually. Click Analyze using Zia to initiate the analysis.



  2. A full environment analysis does not refresh automatically once generated. To get an updated analysis for an environment, run the test plan again.
  3. Deleting a test plan run also deletes its Zia RCA analysis, including Zia tags, test case and the environment analysis.

2.3 Viewing the Zia analysis for a test case

  1. Hover over the sparkle icon next to a test case's Zia Tag to see a short summary, and click View Full Analysis to open its full analysis. Alternatively, you can click on a test case to view it's Zia analysis inside.



  2. View the collapsible Zia Analysis banner on the preview page of the respective test case. The banner header shows the primary tag, a +N indicator if more tags apply, and a short summary. For a failed test case, this includes its Primary cause and Possible fix. For a passed test case, it includes the Key finding and Improvements. The banner also displays the parameters Zia assessed, such as Severity, Confidence, Run history, and more. Learn about what the full analysis for a test case
NotesNote: If a test case could not be analyzed, it shows "Not Analysed" instead of Zia tags. Learn how to troubleshoot this.

3. Managing Zia RCA

This section covers viewing, filtering, deleting, updating, stopping, and troubleshooting Zia RCA once it is set up and running.

3.1 View and filter results

You can filter the Results table only based on the test cases carrying a specific Zia Tag.

  1. Navigate to the Results page for the test plan run.
  2. Click the filter icon to open the filter.
  3. Under Zia Tag, choose a category: All, Priority, Stability, Performance, or Pattern.
  4. Select the specific tag you want to filter by. Then, click Apply Filter.

3.2 Disable Zia RCA for a Test Plan

To stop Zia RCA from analyzing future runs of a Test Plan:

  1. Navigate to Test Plans.
  2. Click the preferred test plan to edit.
  3. Select No from the Enable Zia RCA drop-down.
  4. Click Update.
NotesNote: Disabling Zia RCA does not remove tags or analysis already generated for past test runs. It only stops Zia RCA from analyzing runs executed after it is disabled.

4. Troubleshoot

Zia couldn't analyze a test case

If Zia could not individually analyze a test case, hovering the sparkle icon next to it shows a message explaining the reason, and points you to the execution logs for more detail.

To resolve this:

  1. Hover the sparkle icon {} next to the test case. 
  2. Click View Logs to open the execution logs for that test case, or open the test case directly to view them. Review the logs to identify and resolve the issue.

Zia can't reach the AI model

If Zia cannot reach the configured AI model while generating an environment analysis, retry the analysis and verify the AI model configuration.

To resolve this:

  1. Click Retry Analysis to reattempt the analysis.

Check with a super admin or admin that the AI model configured under Setup > Operations > Zia is valid and reachable. If the issue persists, contact support@zohoqengine.com.

5. Related links

  1. Self-Healing in Zoho QEngine
  2. Configuring Zia for Zoho QEngine
  3. Test Plans
  4. Results
  5. Run History
  6. Performance metrics in Zoho QEngine 

6. FAQ

Do I need to turn on Zia RCA for every test plan?
A: Yes. Zia RCA only analyzes runs for Test Plans where it has been explicitly enabled, and only for runs that start after it is enabled.

Why isn't a Zia Tag showing for a test case?
A: If no test case in the environment shows a Zia Tag, Zia RCA may not be enabled for the test plan, or an AI model may not be configured for the portal. If only this test case is affected, it may not have run, or an internal error may have interrupted its analysis. Learn how to troubleshoot this.

Do I always need to click the sparkle icon to get the full analysis for an environment?
A: Yes, always click the Zia icon to open the environment analysis. If every test case in that environment was individually analyzed, the full analysis opens directly. If even one test case could not be individually analyzed, a prompt appears instead, inviting you to generate it yourself.

Can I get an updated analysis without waiting for the next run?
A: No. An environment analysis does not refresh automatically. Run the test plan again to get an updated analysis for that environment.
Does disabling Zia RCA delete existing analyses?
A: No. It only stops analysis for future runs of that test plan. Previously generated tags and analysis remain unaffected.

7. What's next

Next step
With the results Zia RCA surfaces, update the affected test case, or review and approve a proposed locator fix using Self-healing for live preview and test plan runs in Zoho QEngine

Previous step
Before configuring and viewing Zia RCA, understand how Zia Root Cause Analysis in Zoho QEngine works. 

 


        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          Access your files securely from anywhere

            Zoho CRM Training Programs

            Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

            Zoho CRM Training
              Redefine the way you work
              with Zoho Workplace

                Zoho DataPrep Personalized Demo

                If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

                Zoho CRM Training

                  Create, share, and deliver

                  beautiful slides from anywhere.

                  Get Started Now


                    Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                    BOOK A SESSION







                                Quick LinksWorkflow AutomationData Collection
                                Web FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                Digital FormsMarketingForms for Small Business
                                HTML FormsEducationForms for Enterprise
                                Contact FormsE-commerceForms for any business
                                Lead Generation FormsHealthcareForms for Startups
                                Wordpress FormsCustomer onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG

                                  Zoho FSM Video Tutorials


                                        All-in-one knowledge management and training platform for your employees and customers.

                                                  Create. Review. Publish.

                                                  Write, edit, collaborate on, and publish documents to different content management platforms.

                                                  Get Started Now




                                                                    You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                                        Manage your brands on social media


                                                                          • Desk Community Learning Series


                                                                          • Digest


                                                                          • Functions


                                                                          • Meetups


                                                                          • Kbase


                                                                          • Resources


                                                                          • Glossary


                                                                          • Desk Marketplace


                                                                          • MVP Corner


                                                                          • Word of the Day


                                                                          • Ask the Experts


                                                                            Zoho Sheet Resources

                                                                             

                                                                                Zoho Forms Resources


                                                                                  Secure your business
                                                                                  communication with Zoho Mail


                                                                                  Mail on the move with
                                                                                  Zoho Mail mobile application

                                                                                    Stay on top of your schedule
                                                                                    at all times


                                                                                    Carry your calendar with you
                                                                                    Anytime, anywhere




                                                                                          Zoho Sign Resources

                                                                                            Sign, Paperless!

                                                                                            Sign and send business documents on the go!

                                                                                            Get Started Now




                                                                                                    Zoho TeamInbox Resources





                                                                                                              Zoho DataPrep Demo

                                                                                                              Get a personalized demo or POC

                                                                                                              REGISTER NOW


                                                                                                                Design. Discuss. Deliver.

                                                                                                                Create visually engaging stories with Zoho Show.

                                                                                                                Get Started Now








                                                                                                                                    • Related Articles

                                                                                                                                    • Zia Root Cause Analysis in Zoho QEngine

                                                                                                                                      In a nutshell Zia Root Cause Analysis (Zia RCA) works across every web environment in a test plan run. It tags each test case automatically as soon as the run finishes, so you can triage failures, flag improvements, and spot stability and performance ...
                                                                                                                                    • Configuring Zia for Zoho QEngine

                                                                                                                                      What does this page cover Learn how to configure an AI model for Zia, Zoho QEngine's AI assistant, to enable capabilities such as generating manual test cases and test data. This page explains how to set up Zoho GenAI or connect external AI models ...
                                                                                                                                    • Configuring Zoho Sprints in Zoho QEngine

                                                                                                                                      1. What does this page cover This document guides you on how to configure Zoho Sprints within Zoho QEngine. Before you begin, it's essential to understand how Zoho Sprints integration works. 2. Steps to configure integration with Zoho Sprints Note: ...
                                                                                                                                    • Converting manual test cases to automation scripts using Zia

                                                                                                                                      In a nutshell Zia's manual-to-automation capability converts your manual test case into a ready-to-run automation script without writing any code. It maps each step to the corresponding UI element on the target page, validates them live in your ...
                                                                                                                                    • Integrating Zoho QEngine with Jira

                                                                                                                                      In a nutshell Zoho QEngine integrates with Jira, an issue-tracking and project management tool, to let you report bugs from test case executions, link executions to existing Jira issues, and track their status directly from Zoho QEngine. This ...
                                                                                                                                      Wherever you are is as good as
                                                                                                                                      your workplace

                                                                                                                                        Resources

                                                                                                                                        Videos

                                                                                                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                                        eBooks

                                                                                                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                                        Webinars

                                                                                                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                                        CRM Tips

                                                                                                                                        Make the most of Zoho CRM with these useful tips.



                                                                                                                                          Zoho Show Resources