{"id":17053760,"url":"https://github.com/relrin/k6-reports-tool","last_synced_at":"2026-04-20T13:08:46.138Z","repository":{"id":149274625,"uuid":"454022414","full_name":"Relrin/k6-reports-tool","owner":"Relrin","description":"A CLI tool for managing k6 test results ","archived":false,"fork":false,"pushed_at":"2022-04-25T15:12:03.000Z","size":29,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-28T12:34:50.617Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Relrin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-31T13:44:44.000Z","updated_at":"2022-06-22T22:21:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"7c46acc2-fd39-4e9f-b8e6-5af95a1510a6","html_url":"https://github.com/Relrin/k6-reports-tool","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Relrin%2Fk6-reports-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Relrin%2Fk6-reports-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Relrin%2Fk6-reports-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Relrin%2Fk6-reports-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Relrin","download_url":"https://codeload.github.com/Relrin/k6-reports-tool/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245061384,"owners_count":20554563,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T10:13:10.229Z","updated_at":"2026-04-20T13:08:41.114Z","avatar_url":"https://github.com/Relrin.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# k6-reports-tool\nA CLI tool for managing k6 test results \n\nThis CLI executable was implemented for covering developer needs in saving K6 load test results after the execution. The current implementation relies on the fact that  we store all generated data in the InfluxDB local or remote node. However, as developer as it would be great to export such information for tracking history between test runs and do analytics based on that.\n\nCurrently K6 provides some exports in the [PDF format](https://k6.io/docs/cloud/analyzing-results/result-export/), however such functionality expects from a developer or a company to own a quite [expensive subscription](https://k6.io/pricing/) what can be an issue for small teams.\n\n- [Quick start](#quick-start)\n- [Development](#development)\n- [License](#license)\n\n## Features\n\n- Minimalistic implementation for extracting load test results in the CSV format from InfluxDB node(s)\n\n## Quick start\nFor using this CLI tool will need:\n\n1. Download executable file in according to the used operation system from the [releases page](https://github.com/Relrin/k6-reports-tool/releases).\n\n2. Link executable/binary file to your operation system, so you could invoke `k6-reports` everywhere:\n\n    - Linux / Mac OS\n\n      Move the binary file to the `/usr/local/bin` directory and restart the terminal\n        ```\n        mv ~/Downloads/k6-reports /usr/local/bin\n        ```\n\n    - Windows\n\n        1. Right click on the Windows Logo and select the `System` menu item.\n        2. Click on the `Advanced System Settings` button.\n        3. Click on the `Environment Variables` button.\n        4. Select your `PATH` variable and click in the `Edit` button.\n        5. Click on the `New` button.\n        6. Add the file path to the directory with the `k6-reports` executable.\n        7. Click on the `OK` button a couple of times for applying changes.\n\n3. Restart a terminal or a console to reflect the changes and get access to execute `k6-reports` commands.\n\nFor more information about the extracted metrics:\n- [k6 Metrics](https://k6.io/docs/using-k6/metrics/)\n- [k6 Results export](https://k6.io/docs/cloud/analyzing-results/result-export/)\n\n## Development\n\nTo start developing will need to have installed latest [K6](https://k6.io/docs/getting-started/installation/), [Rust](https://www.rust-lang.org/learn/get-started) and [Docker](https://docs.docker.com/install/). \n\nInstead of manually installing all of the used dependencies (e.g. Grafana nodes), will be more than enough to start up a bunch of Docker containers with the following command:\n```\ndocker-compose up -d\n```\n\nAfter it, we can interact with the such environment by exposed ports:\n\n| Port       | Service     |\n| ---------- | ----------- |\n| 3000       | Grafana     |  \n| 8086       | InfluxDB    |\n| 8888       | Chronograf  |\n\nFor running k6 tests and pushing metrics to a InfluxDB node you can use the k6 CLI with a command like this one:\n```bash\nk6 run --out influxdb=http://influxdb:8086/k6 ./simple-k6-test.js\n```\n\nFor more information about how to implement and run k6 tests you can read the official [k6 documentation](https://k6.io/docs/getting-started/running-k6/).\n\n## License\n\nThe k6-reports-tool project is published under BSD license. For more details read the [LICENSE](https://github.com/Relrin/k6-reports-tool/blob/main/LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelrin%2Fk6-reports-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frelrin%2Fk6-reports-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelrin%2Fk6-reports-tool/lists"}