Gatling produces detailed reports at the end of every simulation run. The open-source distribution generates self-contained static HTML reports that can be opened in any browser. Gatling Enterprise Edition adds an interactive cloud report interface with real-time charts, filtering, time-window selection, run comparison, shareable public links, and custom PDF export. Both formats present the same core metrics—response time distributions, throughput, error rates, virtual user injection—but the Enterprise cloud report extends that foundation with significantly deeper analysis capabilities.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/gatling/gatling.io-doc/llms.txt
Use this file to discover all available pages before exploring further.
Static HTML reports (open-source)
After each local run, Gatling writes a static HTML report to thetarget/ folder (or the configured results directory). Open index.html in your browser to explore the results.
You can generate a report from an interrupted run using the
-ro CLI option. Note that the last few data points may be missing if the run was forcefully killed, because the simulation log uses a write buffer.Report structure
The static report has two top-level menu entries:| Menu | Description |
|---|---|
| Global | Consolidated statistics across all requests and groups |
| Details | Per-request and per-group breakdowns |
Charts in the global report
Response time ranges
Response time ranges
A distribution chart showing what percentage of responses fell within configurable time ranges (OK and KO counts on the right panel). The threshold ranges can be customised in
gatling.conf.Summary statistics table
Summary statistics table
Min, max, mean, standard deviation, and configurable percentiles—globally and per request. When scenarios contain groups, the panel renders as a tree with groups as non-leaf nodes. Group timings default to cumulated response times of all contained elements (configurable in
gatling.conf).Users start rate
Users start rate
Number of virtual users started per second over time. This matches the injection profile shape for open models.
Concurrent users
Concurrent users
Number of concurrent virtual users over time. This matches the injection profile shape for closed models.
Response time distribution
Response time distribution
Histogram of the distribution of response times across all requests.
Response time percentiles over time
Response time percentiles over time
Percentile curves over the run duration, computed only for successful responses. Failed requests are excluded to prevent timeouts from skewing the curves.
Requests per second over time
Requests per second over time
Number of requests sent per second throughout the run.
Responses per second over time
Responses per second over time
Total, successful, and failed responses per second over time.
Per-request chart (Details view)
The Details menu provides a Response Time against Global RPS scatter chart that shows how the response time for a specific request correlates with the overall system load. This chart helps identify whether latency increases are load-driven or request-specific.Interactive cloud reports (Gatling Enterprise)
The Enterprise cloud report provides a live, interactive view of every run. Access it by clicking the chart icon in the tests table or the runs list.Report layout
The report is divided into three main sections:Summary
High-level KPIs, assertion results, and overview charts for the entire run.
Report
Detailed panels for requests, groups, virtual users, connections, DNS, and load generators.
Logs
Raw logs from the test run and each load generator.
Summary tab
The Summary tab gives you an at-a-glance health check for the run: Main KPIs:| KPI | Description |
|---|---|
| Error ratio | Percentage of failed responses out of total responses |
| Total requests | Total number of requests sent during the run |
| Max concurrent VUs | Peak number of concurrent virtual users |
| P95 response time | 95th percentile response time in milliseconds |
Report tab
The Report tab provides deep-dive analysis across six panels:- Requests
- Groups
- Virtual Users
- Connections
- DNS
- Load Generators
Charts and a tabular view of request performance. Filter by scenario, group, or individual request. The table is linked to the timeline—adjusting the time window updates the table data.Download the table as CSV using the download button in the top-right corner of the table. CSV output is scoped to the selected scenario.
Timeline and time window selection
Use the timeline at the top of the Report tab to narrow the analysis window:- Select a predefined time range from the dropdown, or
- Drag and drop on the timeline chart to select a custom range
Chart interaction tips
Zoom and reset
Zoom and reset
Double-click on any chart to reset the zoom. Zoom in by clicking the zoom controls, selecting a zone in a chart, or using the time range picker.
Markers
Markers
Right-click on any chart to place a named marker. Markers are visible across all charts simultaneously. Click the top of a marker to delete it.
Multiple highlights
Multiple highlights
Enable Multiple Highlights in the top-right menu to show the tooltip across all charts at the same cursor position.
Percentiles mask
Percentiles mask
In the top-right menu, click Percentiles to choose which percentile curves are displayed in the response time chart.
Date time / elapsed time
Date time / elapsed time
Toggle between elapsed time (seconds from run start) and absolute date/time in the top-right menu.
Highlight legend
Highlight legend
Hover over a label in the percentiles chart legend to highlight that curve in the chart.
Shareable public links
Enterprise cloud reports can be shared with users who do not have a Gatling Enterprise account.Open the Share menu
Click the Share button in the Actions dropdown at the top-right of the report page.
Organization administrators can disable public links organization-wide in Organization Settings. When disabled, all existing public links are immediately invalidated.
Custom PDF reports
The Create custom report option in the Actions dropdown opens a configurable report builder where you can assemble a tailored PDF: Available blocks:| Block type | Description |
|---|---|
| Title | Section heading |
| Text Area | Editable free-text block |
| New Page | Page break |
| Run Status | Current run status with editable description |
| Run Comments | Run notes/description |
| Run Assertions | Assertions table |
| Run Summary | Full summary table (rendered in landscape) |
| Chart | Any chart from the Report tab, fully interactive before export |
| Counts | Count chart element |
- Save as template — saves the block structure without content, reusable for future runs
- Save as save — saves the full configuration including chart settings and text content