Grafana Datasource

Display Gatling Enterprise simulations reports in Grafana.

Requirements

Download and install Grafana.

Grafana datasource installation

The Gatling Enterprise datasource for Grafana is packaged as a zip bundle that you can found at this URL:

https://downloads.gatling.io/releases/frontline-grafana-bundle/1.14.2/frontline-grafana-bundle-1.14.2-bundle.zip

You can install it using the grafana-cli:

grafana-cli --pluginUrl GRAFANA_DATASOURCE_BUNDLE_URL plugins install frontline

Please note that the plugin is unsigned, and may recent versions of Grafana may reject it. In this case, you need to add the plugin to the list of allowed unsigned plugin.

Grafana configuration sample:

allow_loading_unsigned_plugins = frontline

Adding the datasource

  • In the Grafana side menu you will find the Data Sources link under Configuration (link name may depend on the grafana version).
  • Click the Add data source link in the top header.
  • Select Gatling Enterprise.
Name Description
Name The datasource name.
Default Should be checked if you want that datasource to be selected by default in new panels
URL URL of your Gatling Enterprise server, for example: https://demo-beta.gatling.io
Access Server access via Grafana backend, Browser access directly from browser.
Auth Gatling Enterprise datasource ignore these fields.
API Token Token generated through the Gatling Enterprise dashboard.
pdfheight=20%

Templating

To use the Gatling Enterprise datasource in Grafana, you will need to set template variables.

These are global dashboard parameters that can be used in your graphs with the query builder.

To create a variable on your dashboard, Click the settings button on the top right menu of the dashboard, go to the Variables tab and click on the + New button.

For example, to create the simulation template variable and use them in your graphs:

You will need for the scopes to use Custom type as shown below :

At the end, your template variables should be something like:

Gatling Enterprise Metrics

Gatling Enterprise offers a large amount of metrics:

  • Requests metrics:
    • req.<Percentiles>: Response time percentiles metric.
    • requests: Requests count per second.
    • responsesOk: Responses OK count per second.
    • responsesKo: Responses KO count per second.
    • responsesByStatus: Requests count by status per second.
    • errors: Errors count by error name per second.
  • Group metrics:
    • groupCumulated.<Percentiles>: Group cumulated response time percentiles.
    • groupDuration.<Percentiles>: Group duration percentiles metric.
    • groupCountsOk: Group count OK per second.
    • groupCountsKo: Group count KO per second.
  • Users metrics:
    • usr+: Users arrival count per second.
    • usr-: Users termination count per second.
    • usrActive: Concurrent users count per second.
  • Injectors metrics:
    • gcCount: GC count per second.
    • gcTime: GC time per second.
    • heapUsed: Heap used in Mb.
    • heapMax: Heap max in Mb.
    • heapCommitted: Heap committed in Mb.
    • tcpSeg: TCP events count per second.
    • tcpConn: TCP connection events count per second.
    • cpuSys: CPU system usage in percent.
    • cpuUser: CPU user usage in percent.
  • Bandwidth metrics:
    • bitsSent: Bits sent per second.
    • bitsReceived: Bits received per second.
  • Connections metrics:
    • connectionOpened: Connection opened count per second.
    • connectionClosed: Connection closed count per second.
    • connectionTcpState: TCP connection count by state.
    • tcp.<Percentiles>: TCP connect duration percentiles metric.
    • tls.<Percentiles>: TLS handshake duration percentiles metric.
  • DNS metrics:
    • dns.<Percentiles>: DNS resolution duration percentiles metric.

Metric Requirements

Part 1

Metrics name simulation scenario group request
req.<Percentiles>
requests
responsesOk
responsesKo
responsesByStatus
errors
groupCumulated.<Percentiles>
groupDuration.<Percentiles>
groupCountsOk
groupCountsKo
usr+
usr-
usrActive
gcCount
gcTime
heapUsed
heapMax
heapCommitted
tcpSeg
tcpConn
cpuSys
cpuUser
bitsSent
bitsReceived
connectionOpened
connectionClosed
connectionTcpState
tcp.<Percentiles>
tls.<Percentiles>
dns.<Percentiles>

Part 2

Metrics name remote hostname injector scope
req.<Percentiles>
requests
responsesOk
responsesKo
responsesByStatus
errors
groupCumulated.<Percentiles>
groupDuration.<Percentiles>
groupCountsOk
groupCountsKo
usr+
usr-
usrActive
gcCount
gcTime
heapUsed
heapMax
heapCommitted
tcpSeg
tcpConn
cpuSys
cpuUser
bitsSent
bitsReceived
connectionOpened
connectionClosed
connectionTcpState
tcp.<Percentiles>
tls.<Percentiles>
dns.<Percentiles>

Edit this page on GitHub