> OctoPerf's load testing - Load Test Report Export documentation page. APDEX definition and how to configure it for a load test report.

Source: https://api.octoperf.com/doc/analysis/export-bench-report/

# Load Test Report Export

You can export a report in two formats:

- **PDF**, to share a formatted document with its charts, cover page and appendix: this page describes it first.
- **Markdown**, to get every value of the report as text and tables, for a reader or an AI assistant: see [Export as Markdown](#export-as-markdown).

The export button is available in the [report page header](https://api.octoperf.com/doc/analysis/edit-bench-report/#actions):

![Export Report Button](https://api.octoperf.com/doc/analysis/export-bench-report/img/export-report-button.png "Export Report Button")

Click on it to switch to the export view:

![Export Report View](https://api.octoperf.com/doc/analysis/export-bench-report/img/exported-report.png "Export Report View")

You can click on the _Back to edition_ button to switch back to the report view.

## Automatic formatting

We add several items in order to make the report easier to read, all of them are configurable:

### Cover page

The cover page content can be seen and edited from the [Configuration menu](#cover-page-config).

### Table of contents

Any title *H1* or subtitle *H2* used inside [Text report items](https://api.octoperf.com/doc/analysis/edit-bench-report/report-items/text/) is listed in the table of contents. 

### Page breaks

A page break is inserted before every title *H1* when you export as a PDF file. 

## Configure export

Click on the **Configure export** button at the top of the page to open the Report Export Configuration modal:

![Configure Report Export](https://api.octoperf.com/doc/analysis/export-bench-report/img/configure-report-export.png "Configure Report Export")

### Cover page config

The editor lets you insert and format text and images, using the [Markdown syntax](https://api.octoperf.com/doc/design/edit-virtual-user/code-editor/#markdown-cheat-sheet):

![edit-cover-page](https://api.octoperf.com/doc/analysis/export-bench-report/img/edit-cover-page.png)

You can use the following variables:

* \$COMPANY_NAME\$ to insert your company name (from your [user profile](https://api.octoperf.com/doc/account/profile/#billing-information),
* \$REPORT_NAME\$ to insert the report name,
* \$REPORT_DATE\$ to insert the report creation date,
* \$REPORT_DESCRIPTION\$ to insert the report description.
* \$RESULT_START(0)\$ and \$RESULT_END(0)\$ to insert when the test started and ended.

The other variables of the [report templates](https://api.octoperf.com/doc/analysis/edit-bench-report/templates/) are also available.

### Tables

This screen allows you to configure the maximum size of all tables:

![configure-report-tables](https://api.octoperf.com/doc/analysis/export-bench-report/img/configure-report-tables.png)

### Print configuration

You can select the orientation, format, scale and margins of the document:

![configure-report-format](https://api.octoperf.com/doc/analysis/export-bench-report/img/configure-report-format.png)

### Appendix

An appendix is appended to the end of the exported report. It contains a glossary that defines the most common terms used in load testing.

![Appendix](https://api.octoperf.com/doc/analysis/export-bench-report/img/appendix.png "Appendix")

## Printing as a PDF file

To print the report, simply click on the _Save as PDF_ button placed on the top left corner of the screen. Once the generation is finished you will be able to download the file:

![download](https://api.octoperf.com/doc/analysis/export-bench-report/img/download.png)

![download-files](https://api.octoperf.com/doc/analysis/export-bench-report/img/download-files.png){ align=left }

PDF generation can take several minutes. If you do not want to wait, you can leave this page and the PDF will be placed in the report [log panel](https://api.octoperf.com/doc/analysis/edit-bench-report/test-logs/#jmeter-logs) when it is ready.

<div style="clear:both"></div>

!!! tip
    To export several reports at once, select them in the [reports list](https://api.octoperf.com/doc/analysis/#reports-list-actions) and use **Export PDFs**: each report uses its own print configuration, and you download all the PDFs in one zip file.

## Export as Markdown

The Markdown export downloads the report as a single `.md` text file. Use it when you want the values of the report rather than its layout: to read them in any text editor, to paste them in a ticket or a wiki page, or to give the whole report to an AI assistant and ask it questions about the test.

### Where to find it

- In the [reports list](https://api.octoperf.com/doc/analysis/#reports-list-actions): open the menu of a report and select **Export as Markdown**.
- In the report itself: open the **…** menu of the [report header](https://api.octoperf.com/doc/analysis/edit-bench-report/#actions) and select **Export as Markdown**.

The file is downloaded right away, under the name of the report, for example `Checkout campaign.md`.

### What the file contains

The file starts with a table of the test results of the report: scenario, status, start and end dates, duration, locations, load generators and virtual users. Then every item of the report follows, in the order of the report:

- tables, trees and tops give their rows, sorted by their first metric;
- charts give the statistics of each curve (minimum, average, 95th percentile, maximum), then their values over time;
- errors are grouped by action and message, with how many times each one occurred;
- SLA alarms, insights and monitors give their counters, severities and when they occurred, relative to the start of the test;
- [Text items](https://api.octoperf.com/doc/analysis/edit-bench-report/report-items/text/) keep their text, with their variables replaced.

The [time range](https://api.octoperf.com/doc/analysis/edit-bench-report/configuration/#time-range) of the report applies, as on screen.

Comparison and trend reports give one column per test result. Each result is named by its label, as on screen: *Reference* or *Run 3* in a [trend report](https://api.octoperf.com/doc/analysis/trend-bench-results/), the name you gave it in a [comparison report](https://api.octoperf.com/doc/analysis/compare-bench-results/).

Example, a table of actions:

```markdown
| Action | HITS_TOTAL (COUNT) | RESPONSE_TIME_AVG (MILLISECONDS) | ERRORS_PERCENT (PERCENT) |
| --- | ---: | ---: | ---: |
| Home | 245000 | 180 | 0.0123 |
| Login | 201000 | 240 | 0.0421 |
| … | | | |
| Wishlist | 47000 | — | 0 |

Sorted by HITS_TOTAL (COUNT), descending.
```

!!! note
    To keep the file readable, long tables are cut. The file always says how many rows were left out: nothing is removed silently. The full values remain in the report on screen.

The Markdown export does not use the [export configuration](#configure-export): no cover page, page breaks or appendix, and dates are written in UTC.

You can also receive this file automatically at the end of a test, attached to an [email](https://api.octoperf.com/doc/notifications/#email) or to [Jira issues](https://api.octoperf.com/doc/notifications/jira/board/#attaching-the-markdown-report).

!!! info
    A report whose data must first be [updated](https://api.octoperf.com/doc/analysis/update-report-data/) cannot be exported. Open it once to update its data, then export it again.