parse-jtl

A Node.js library to parse and aggregate JMeter JTL files.

Features

• Parse JTL files to extract requests and transactions.
• Aggregate performance metrics like Average, Median, 90th, 95th, and 99th percentiles.
• Calculate Throughput (TPS), Error Rate, and Latency metrics.
• Support for custom delimiters and quoted fields.

Installation

npm install parse-jtl

Usage

Parsing a JTL file

const { parse } = require('parse-jtl');

const results = parse('path/to/results.jtl');
console.log(results.requests);
console.log(results.transactions);
console.log(results.total_requests);

Aggregating results

const { aggregate } = require('parse-jtl');

const summary = aggregate('path/to/results.jtl');
console.table(summary);

Metrics Calculated

• Samples: Total number of requests.
• Average: Arithmetic mean of response times.
• Median: 50th percentile of response times.
• 90% Line: 90th percentile of response times.
• 95% Line: 95th percentile of response times.
• 99% Line: 99th percentile of response times.
• Min/Max: Minimum and maximum response times.
• Error %: Percentage of requests with response code >= 400.
• Throughput: Transactions per second.
• Latency Metrics: Average, Median, and Percentiles for Latency (if available).

License

ISC