Document toolboxDocument toolbox

Header

⏱️Real-time Reporting Portal

Owned by Shruti Agrawal
Last updated: Oct 17, 2024
2 min read

With the Real-Time Reporting portal in Qualitia Automation Studio (QAS), you can monitor your test suite that are in progress or completed. It updates the results of a test suite execution in Real-Time after each step in the test case iteration is executed.

The portal opens automatically when executing a test suite in the following ways:

  1. Through a QAS - Client. It directly shows you the Suite of Suites screen.

  2. Through an Offline Suite. It shows you a login screen if the offline suite is present on your machine and connected to the QAS’s Server. Ensure you have access to the associated project to monitor the progress of the test suite execution.

Accessing Real-Time Reporting Portal

To access the Real-Time Reporting portal, you need to get the Reports and Dashboards URL from your Qualitia Admin who installed the QAS - Server. Alternatively, you can also access the Real-Time reports from the Reports tab in the QAS - Client.

📚Prerequisites:

Before running your test suite either through the QAS - Client or an Offline Package, ensure the following:

  1. Real-Time Reporting is enabled in the Execution Profile Settings.

  2. The Real-Time Reporting Server has enough drive space to display the test suite results.

  3. For offline suite execution, your computer is connected to the QAS - Server, and the Qualitia Server URL is set in the Settings tab of the Qualitia Offline Configuration Manager.

Additional Configurations for Log Files

You can change the logs generated with suite execution results in the execution profile settings. The settings you can change are:

Setting

Description

Enable Real-Time Reporting

You can view the test execution results in the Real-Time Reporting Portal. If the Web Dashboards feature is enabled, these records can be viewed in the Dashboard portal.

Maximum Size Per Log File

You can set the maximum size for every log file of a test suite execution. The default value is 1MB.

Application Step Log Size

You can set the maximum size for logs of a step. The default is 1MB and the maximum you can set is 2MB.

Application Log Level

You can choose the type of logs to generate the following: Info Logs, Error Logs, and All Logs.
If you do not want any, select None.

Server Space Notifications

As the number of suite executions increases, the available storage for Real-Time Reporting assets diminishes. The Real-Time Reporting portal triggers notifications based on the available drive space:

  1. 10-30%: When the available space falls within the range of 10% to 30%, a yellow warning message appears at the top of the portal. This message specifies the available drive space alongside the percentage. It is crucial to monitor the drive space and ensure it does not drop below 10%.

  2. Less than 10%: If the available space is less than 10%, a red warning message will appear at the top of the portal. This message indicates that real-time reporting cannot provide information on new suite executions. Additionally, you cannot upload or save reports.

In both scenarios, reach out to the Qualitia Admin to initiate the process of purging reports.

 🔧 Got trouble? Let’s fix! 

  • Live Report option is disabled during execution and the execution is not visible on the Real-Time Reporting portal: If the Live Report option is disabled during execution and the execution is not visible on the Real-Time Reporting portal, check the disk space—it should be at least 10%. You can temporarily fix this by adjusting the DiskSpaceLowerLimit to ensure it's not below 10%.

    To update the DiskSpaceLowerLimit, navigate to the following path:
    C:\ProgramData\Qualitia Automation Studio - Server\workspace\data\settings.yaml
    and set the appropriate limit.

    image-20241016-072045.png

    For Example, if you've set the DiskSpaceLowerLimit to 10 GB but the actual available space is only 2.5 GB (less than 10%), you will encounter this error and see a warning message like the one shown in the screenshot. To resolve this and enable execution with real-time reporting, adjust the DiskSpaceLowerLimit to 1 GB and proceed.

    image-20241016-073103.png

     

  • Not able to see the execution in Real-Time Reporting portal after migrating 8.x data: After migrating data from version 8.x, executions may not appear in the Real-Time Reporting portal. The execution reports appear in the portal for newly created projects, but not for upgraded projects. This issue might occur when a dashboard is disabled in Qualitia v8.x.
    Steps to Resolve:

    Before running the readiness tool for any client, follow these steps to help refill the dashboard with any missing entries:

    1. If the dashboard is disabled in Qualitia v8.x:

      • Enable the dashboard in v8.x by running the server again.

    2. Run the ETL job on the Qualitia v8.x dashboard database using the command:

      • For MySQL:
        CALL daily_etl_run('<master db name>')

      • For SQL Server:
        EXEC daily_etl_run '<master db name>'

    3. Run the readiness tool on v8.x.

    4. Upgrade to version 9.0.

    5. Once a suite, offline package, or scheduler is executed, the report will appear in the portal.

 

Footer