Skip to main content

Getting started

This guide demonstrates how to start publishing web performance test results to Latency Lingo.

Input file

Latency Lingo depends on the CSV results file generated by JMeter, so first make sure you can generate this file. You can review the JMeter documentation on listeners to learn more. The CLI currently assumes the default column formatting.

Example command to run tests and generate this file.
jmeter -n \
-t test-plan.jmx \
-l 20220810_test_results.csv

Support for other test runner result files is planned, but please reach out with your needs to help prioritize.

Install the CLI

We will use the CLI to publish the metrics from our input file to Latency Lingo. You can review this process in the Architecture page.

CLI releases are available on the GitHub releases page. Download and extract the correct build for your system.

Example downloading and extracting the latest Mac OS X release.
curl -L https://github.com/AnthonyBobsin/latency-lingo-cli/releases/latest/download/latency-lingo-cli_Darwin_x86_64.tar.gz \
| tar -xz
note

Move the executable to a bin directory included in your path for easier access.

Publish your results file

Invoke the publish command with your CSV file containing the test results.

Create a test report with your API key
latency-lingo-cli publish \
--file ./20220810_test_results.csv \
--label "checkout flow"
--api-key 05b6c656-006b-4107-991d-96a5a2a3227c
tip

Find your API key by signing up and viewing account settings.

The output logs will include a link to the created report.

Report can be found at https://latencylingo.com/test-runs/bdd8ce59-8c93-431f-aea9-d53d3ad03182

Congrats, you have just created your first report on Latency Lingo!

https://latencylingo.com/reports/demo
report demoreport demo