Upload Allure Reports to Test Observability
Quick start guide to upload your Allure Reports to BrowserStack Test Observability
Allure Report is a popular tool for generating and reporting test results. However, Allure Reports are quite limited in functionality and offer only a simple HTML report.
Test Observability takes the best of Allure Reports and makes them better - with advanced AI-based failure analysis, rich test analytics, custom dashboards, monitoring, developer workflows and more!
We recommend you upload your Allure Reports only if you do not see your framework in the list of supported frameworks. This provides an easier and deeper integration and more features with Test Observability.
Prerequisites
- BrowserStack Username and Access Key, which you can find in account settings. If you have not created an account yet, you can sign up for a Free Trial or purchase a plan.
- Allure Reports generated and stored in a directory.
Upload Allure Reports to Test Observability
Prepare your Allure Reports for upload
Zip the allure-results directory and store it.
We reccomend you wipe the allure-results directory between build runs to prevent data from previous runs from being included in your reports.
Here is a quick checklist to prepare your report for upload:
- The file format is zip archive containing the
allure-resultsdirectory at its root. - All files generated by Allure from the same build run are left intact and unmodified.
Upload the reports via API
Make a POST request to https://upload-observability.browserstack.com/upload (refer to the sample cURL below) to upload the Allure Reports.
Additional API Parameters
The sample cURL command provided above has additional parameters that you can use to add more metadata. This can be leveraged in filters and dashboards to get more granular insights.
If you have a framework we support in the list of supported frameworks, the integration process is far simpler (no need for API calls) and this information is automatically captured.
Here’s the full sample cURL command with all the parameters:
Please note that the parsing of the uploaded Allure Reports happens asynchronously. It might take a few seconds for the results to be available on Test Observability after the API request is made.
Visit Test Observability
Voila! Your report will now be available in Test Observability. You can then visit the Test Observability Dashboard to analyze and gain insights from the imported test results.
Troubleshooting & FAQs
Why am I getting `X tests could not be processed as test result files were invalid`?
While uploading your Allure Reports to Test Observability, you may see the following error:
X tests could not be processed as test result files were invalid
This error is rare and unlikely to be seen by most users. This happens when the data in the test results file (e.g. {uuid}-result.json) could be malformed or manually modified by users.
Please ensure that the test results file are uploaded as-generated by Allure and no additional modifications are made.
If you feel that this is an error still occuring despite no tampering of the original result files, please reach out to our support and we will investigate this.
Please attach the original zip file, and the link to your build to the support ticket to help expedite the investigation.
Why am I getting `Report parsing failed. No valid files were found within the uploaded zip file`?
While uploading your Allure Reports to Test Observability, you may see the following error:
Report parsing failed. No valid files were found within the uploaded zip file.
This error occurs when no test results files are generated by Allure for your tests (e.g. {uuid}-result.json). Please ensure that your tests are running and Allure is generating the test results files. Even if your hooks run, but no test results files are generated, this error will occur.
If you feel that this is an error still occuring despite test result files being present, please reach out to our support and we will investigate this.
Please attach the original zip file, and the link to your build to the support ticket to help expedite the investigation.
Why am I getting `Report parsing failed Uploading pre-dated build runs is not supported currently. Upload the builds run later than X`?
While uploading your Allure Reports to Test Observability, you may see the following error:
Report parsing failed
Uploading pre-dated build runs is not supported currently. Upload the builds run later than 22 Jan 2025, 06:02:25
This error occurs when the timestamp of the tests in your build precede the timestamp of the latest build of the same name in Test Observability. This is to ensure users don’t accidentally upload older builds and disrupt the test’s history and analytics in Test Observability.
Please ensure you upload only the latest build to Test Observability. A good practice is to wipe the allure-results directory between build runs to prevent old test results from being uploaded.
If you feel that this is an error still occuring despite test result files being present, please reach out to our support.
Please attach the original zip file, and the links to your different builds to the support ticket to help expedite the investigation.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!