tinkoff / xk6-output-error

A k6 extension for add more information into StdErr

xk6-output-error

This is a k6 extension using the xk6 system. xk6-output-error is a k6 extension to add more information into StdErr k6. Moreover, you can send logs with errors in your Elasticsearch or other log storage system used for this vector.dev (config vector), filebeat, etc.

Contents

• Build
• Usage

Build

To build a k6 binary with this extension, first ensure you have the prerequisites:

• Go toolchain
• Git

Then:

1. Install xk6:

go install go.k6.io/xk6/cmd/xk6@latest

2. Build the binary:

CGO_ENABLED=1
xk6 build --with github.com/Tinkoff/xk6-output-error@latest

If you use Windows:

set CGO_ENABLED=1
xk6 build master --with github.com/Tinkoff/xk6-output-error

Usage

You can use default params:

k6 run -o xk6-output-error sample.js

Also, you can add special fields for output:

k6 run -o xk6-output-error=fields="proto,tls_version" sample.js

Or set an environment variable:

export K6_OUTPUTERROR_FIELDS="proto,tls_version"
k6 run -o xk6-output-error sample.js

Moreover, you can set output into a file:

k6 run -o xk6-output-error=fields="proto,tls_version" ./examples/sample.js 2>error.log

xk6-output-error's Issues

Needed to maintain listing in k6 Extensions Registry

We've recently updated the requirements for maintaining an extension within the listing on our site. As such, please address the following items to maintain your listing within the registry:

• add an examples directory containing k6 test scripts making use of your extension
• needs to build with a recent version of k6; minimum v0.43

For more information on these and other listing requirements, please take a look at the registry requirements.