CSV

suggest edits

You can output granular data points in CSV format. To do so, use k6 run with the --out flag. Pass the path for your CSV file as the flag argument:

$ k6 run --out csv=test_results.csv script.js

You can also get the results gzipped, like this:

$ k6 run --out csv=test_results.gz script.js

To inspect the output in real time, you can use a command like tail -f on the file you save:

$ tail -f test_results.csv

CSV format

The CSV result file will look something like this:

metric_name,timestamp,metric_value,check,error,error_code,group,method,name,proto,scenario,status,subproto,tls_version,url,extra_tags
http_reqs,1595325560,1.000000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_duration,1595325560,221.899000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_blocked,1595325560,225.275000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_connecting,1595325560,217.680000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_tls_handshaking,1595325560,0.000000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_sending,1595325560,0.112000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_waiting,1595325560,220.280000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
http_req_receiving,1595325560,1.507000,,,,,GET,http://test.k6.io,HTTP/1.1,default,200,,,http://test.k6.io,
vus,1595325560,1.000000,,,,,,,,,,,,,
vus_max,1595325560,20.000000,,,,,,,,,,,,,
checks,1595325561,1.000000,status is 200,,,,,,,default,,,,,
checks,1595325561,0.000000,response body,,,,,,,default,,,,,
data_sent,1595325561,76.000000,,,,,,,,default,,,,,
data_received,1595325561,11045.000000,,,,,,,,default,,,,,
iteration_duration,1595325561,1449.049580,,,,,,,,default,,,,,
iterations,1595325561,1.000000,,,,,,,,default,,,,,

Each entry in the report represents a metric, metric_name, along with its value, metric_value, at time, timestamp. If an error happens, then the error along with the error_code fields will be populated.

CSV options

k6 provides a few options to help you configure your CSV output:

option	Configures	Possible values	Default	Env. variable
saveInterval	The time intervals at which k6 writes to the CSV	Either a string with time units("1m45s"), or a number of milliseconds	"1s"	K6_CSV_SAVE_INTERVAL
timeFormat	The timestamp format	unix, rfc3339	unix	K6_CSV_TIME_FORMAT
fileName	The file name and path where output is saved	N/A	file.csv	K6_CSV_FILENAME

Get started

Using k6

Results output

Test authoring

Test Types

Testing Guides

Misc

CSV

CSV format

CSV options

Read more

Product

Resources

Community

About