Reports

Analyze your reports and discover the bottlenecks in your application.

The reports can be accessed by clicking on the icon in the simulations table or in the runs table.

This view displays all of the metrics available for a specific run. The Reports page consists of:

Reports

Run Bar

This bar is a combination of buttons including:

  • Start / Stop: Use this button to start a new run of the simulation, or stop the ongoing run (not available if you have a Viewer permission)
  • Generate public link: To create a public link that can be viewed by anyone it is sent to.
  • Export: To export reports
Run bar

Top Navigator Menu

The navigation menu allows you to choose the simulation time range. You can also view a custom time range by dragging the cursors.

Timewindow

Assertions

The image below shows the status of the simulation (Ongoing, successful, timeout…). If your simulation has assertions, you can click this label. You can add comments to the run by clicking on the icon.

Timeline assertions

Timeline

The timeline contains metrics of the full run providing an overview of the run. Global information are available such as the resolution and the simulation name.

The resolution indicates the number of seconds per data point in the graph.

You can change the time range with control buttons or by selecting a region on the timeline:

Timeline

Tabs

Below the navigator chart, there are tabs to switch charts. Each tab has the same structure except the summary that is available only for requests and groups tabs.

Tabs

Filter Bar

This filter bar is a combination of buttons:

  • Switch to Summary: Switch to summary view for Requests & Groups tabs
  • buttons to filter the metrics displayed in the charts area
Filter bar

Charts

All charts in Gatling Enterprise runs are interactive, so if you select a time window on a chart it will automatically change the time window for all other charts. Metrics are drawn in multiple charts.

Charts

Some of them have an icon to update the chart settings:

Distribution chart

You can also switch from area to pie and column charts using the icon.

Pie button

Summary (Requests and Groups only)

This view is available only from the Requests and Groups tabs. The summary of the data which is laid out in this table which can be viewed in flat mode (default) or hierarchy mode The summary is also connected to the timeline and the time window selected, so if you change the time window the summary will refresh the data to match the time window.

In flat mode, you can click on the title of each column to arrange the data in ascending or descending order.

Summary

A public link is a link of the current reports which will be accessible to anyone, without having to log in to Gatling Enterprise. To generate a public link, click on the Generate public link button and choose the expiration date of your link.

Generate public links

The maximum allowed lifetime for a public link is 1 year.

Choose an expiration date, then click the generate button.

Successful public link generation

You can copy the public link to share your report to non-Gatling Enterprise users, or click on the “Go” Button to access it yourself. You can click on the “OK” button to close this modal.

Export PDF

When clicking on the blue export button in the navigator menu, you will have access to a page where you can configure and then export a PDF report of a specific simulation run.

Export button

This report is initialized with:

  • a title element with the date of the run you were coming from
  • the run status
  • the run comments
  • the run assertions
  • the run requests summary
  • 3 charts of the run:
  • Requests and Responses per second
  • Responses per Second by Status
  • Response Time Percentiles
Export page

This page is a configurable list of different elements that will be displayed in the report. You can click on the blue add button under every element to add another one.

Every element can be moved up or down by clicking on the blue arrow on the top right of the element, or be removed by clicking on the red dash.

Those elements are composed of:

  • Title: adds a title element.
  • Text Area: adds an editable text element.
  • New Page: allows you to skip a page in the report.
  • Run:
    • Status: adds an editable text element with a predefined text set to the status of the selected run.
    • Comments: adds an editable text element with a predefined text set to the comments of the selected run.
    • Assertions: adds a table with the assertions of the selected run.
    • Summary: adds the summary table of the selected run in a new landscape page.
  • Chart: adds a chart element that you can interact with before exporting it to PDF.
  • Counts: adds a count chart element that you can interact with before exporting it to PDF.

As you can see below, every chart (or other element) can be interacted with individually. You can zoom in on sections, or select the run, the scenario, the group, etc.. whose data you want to fetch. You do not need to have the same settings for each element.

Export charts

After adding all desired elements in the report you can click on the Export PDF button on the top right to get your PDF file.

Export actions

There are two more actions available to you:

  • Save: saves the current Export configuration:
    • as a template: this option will save the element list without the content
    • as a save: this option will save everything, including the content of the Text Area and the configuration of the graphs
  • Load: load a previously saved template or save.

Useful Tips

Zoom

You can reset the zoom status by double clicking on a chart. It is possible to change the time range window by doing any of the following actions:

  • Clicking the zoom icons of the control buttons
  • Selecting a zone in any charts or timelines
  • Selecting a range of time from the top navigation bar

Markers

To ease your analysis, you can create markers on all the charts by right clicking on them. You can click on the top of the marker to delete it.

Marker

Multiple Highlights

In the top right menu, you can activate the Multiple Highlights setting which allows the tooltip to be displayed on every chart at the same time.

Multiple check
Multiple

Percentiles Mask

In the top right menu, you can click on the Percentiles setting to be able to choose which percentiles to display in the chart.

Percentiles mask
Percentiles chart

Date Time / Elapsed Time

In the top right menu, you can activate the Date Time setting which lets you switch from elapsed time to date time.

Multiple check
Multiple

Highlight Legend

If you hover your mouse over a label on the percentiles chart legend, you will be able to highlight the curve on the chart, leading to a better view of that curve. The highlight legend option is enabled for every “non stacked” graph.

Highlight chart

Edit this page on GitHub