k6-docs
k6-docs copied to clipboard
Improve clarity around logs behaviour in k6
k6 has a bit unusual approach to the logs it prints in CLI output by default. Logs of all levels are written to stderr, unless --log-output option is used. With that option, logs of all levels are re-directed to the specified location. There is no difference in the logs behaviour by levels (INFO vs ERROR vs WARNING).
From the user's perspective, it appears as if this approach was taken to distinguish between test run process messages and summary in stdout and logs in stderr. This is a bit unusual from the perspective of CLI tooling, and it'd be useful for some use cases to be explicit about these details in the docs.
:+1: It'd be good to get more logs about docs. Now the only info is in the reference for a few scattered options.
Now that we have a new sidebar section called "Results output", I think it'd be pretty sensible to put a new page or collection of pages called Logs there.
Relates to https://github.com/grafana/k6-docs/issues/327