Timings
Learn about all the recorded metrics: active users, response times and counts.
As Gatling runs and executes requests, several timings are recorded, which make up the basis of all forms of reporting in Gatling: console, HTML reports, etc…
Active Users
At a given second, active users are computed as:
(the number of active users at the previous second)
+ (the number of users who started during this second)
- (the number of users who finished during the previous second)
Requests
Response Time
The response time is the elapsed time between:
- the instant Gatling tries to send a request. It accounts for:
- DNS resolution time (might be bypassed if it’s already cached). Note that the DNS resolution time metric is available in Gatling Enterprise.
- TCP connect time (might be bypassed if a keep-alive connection is available in the connection pool). Note that the TCP connect time metric is available in Gatling Enterprise.
- TLS handshake time (might be bypassed if a keep-alive connection is available in the connection pool). Note that the TLS handshake time metric is available in Gatling Enterprise.
- HTTP round trip
- the instant Gatling receives a complete response or experiences an error (timeout, connection error, etc)
Groups
Count
The counts are the number of group executions, not the sum of the counts of each individual request in that group.
Response Time
This metric provides the response times for all the requests belonging to the specified group.
In Gatling Enterprise, this metric is available in the “Request” stats.
Cumulated Response Time
Group cumulated response time is the time in a group when requests are flying: requests’ response time and resources start to end duration. In short, it’s the group duration minus the pauses.
In Gatling Enterprise, this metric is available in the “Group” stats, in the “Cumulated Response Time” chart. In Gatling open-source HTML reports, this metric is available when selecting a group.
Duration
Group duration is the elapsed time between the instant a virtual user enters a group and the instant it exits.
In Gatling Enterprise, this metric is available in the “Group” stats, in the “Duration” chart. In Gatling open-source HTML reports, this metric is available when selecting a group.
charting.charting.useGroupDurationMetric
option to true
in gatling.conf
before generating the reports.