get_test_run_timeline_kpis
Retrieve timeline KPIs report for a BlazeMeter test run to analyze performance metrics over time.
Instructions
Get the timeline KPIs report for a specified test run (master).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| masterId | Yes | The ID of the test run (master) to retrieve the timeline KPIs report for. |
Implementation Reference
- The handler function that implements the core logic of the tool: fetches timeline KPIs report from BlazeMeter API using basic auth and the provided masterId.
const executeFunction = async ({ masterId }) => { const baseUrl = process.env.BASE_URL; // loaded from .env const username = process.env.BZM_USERNAME; // loaded from .env const password = process.env.BZM_PASSWORD; // loaded from .env try { // Construct the URL for the timeline KPIs report const url = new URL(`${baseUrl}/api/v4/masters/${masterId}/reports/timeline/kpis`); // Set up headers for the request const headers = { 'Authorization': 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64'), 'Accept': 'application/json' }; // Perform the fetch request const response = await fetch(url.toString(), { method: 'GET', headers }); // Check if the response was successful if (!response.ok) { let errorData; try { errorData = await response.json(); } catch (jsonErr) { errorData = await response.text(); } throw new Error(`HTTP ${response.status} ${response.statusText}: ${typeof errorData === 'string' ? errorData : JSON.stringify(errorData)}`); } // Parse and return the response data const data = await response.json(); return data; } catch (error) { if (error instanceof Error) { return { error: error.message }; } else { return { error: 'Unknown error occurred while getting timeline KPIs report.' }; } } }; - The tool schema defining the name, description, input parameters (masterId as required string), used for MCP tool calls.
type: 'function', function: { name: 'get_test_run_timeline_kpis', description: 'Get the timeline KPIs report for a specified test run (master).', parameters: { type: 'object', properties: { masterId: { type: 'string', description: 'The ID of the test run (master) to retrieve the timeline KPIs report for.' } }, required: ['masterId'] } } } - lib/tools.js:7-16 (registration)Central registration function that dynamically loads and registers the apiTool from this module (via its path) into the list of available MCP tools.
export async function discoverTools() { const toolPromises = toolPaths.map(async (file) => { const module = await import(`../tools/${file}`); return { ...module.apiTool, path: file, }; }); return Promise.all(toolPromises); } - tools/paths.js:1-10 (registration)The toolPaths array includes the path to this tool's file, enabling its dynamic import during registration.
export const toolPaths = [ 'blazemeter/new-collection/get-workspace-list.js', 'blazemeter/new-collection/get-project-list.js', 'blazemeter/new-collection/get-test-runs-list.js', 'blazemeter/new-collection/get-test-run-summary.js', 'blazemeter/new-collection/get-test-run-aggregate-data.js', 'blazemeter/new-collection/get-test-run-errors-data.js', 'blazemeter/new-collection/get-test-run-thresholds.js', 'blazemeter/new-collection/get-test-run-timeline-kpis.js', ];