blaze-performance-tester 3.1.35 → 3.1.37

package/dist/cli.js

@@ -87,6 +87,60 @@ var mathUtils = {
     return sorted[Math.max(0, index)];
   }
 };
+async function generateGeminiRCA(history, finalSummary, errorLogs) {
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey) {
+    return `<span style="color: #ef4444;">\u26A0\uFE0F Gemini API Key missing. Export GEMINI_API_KEY to enable automated 2.5 Flash RCA analysis.</span>`;
+  }
+  console.log("\u{1F9E0} Querying Gemini 2.5 Flash for Advanced Root Cause Analysis...");
+  const formattedHistory = history.map(
+    (h) => `Threads: ${h.threads} VUs | Throughput: ${h.throughput.toFixed(1)} req/s | Avg Latency: ${h.avgLatency.toFixed(1)}ms | Errors: ${(h.errorRate * 100).toFixed(2)}% | Apdex: ${h.apdex.toFixed(2)}`
+  ).join("\n");
+  const uniqueLogs = Array.from(new Set(errorLogs)).slice(0, 10).join("\n");
+  const prompt = `
+You are an expert Performance & Systems Reliability Engineer. Analyze the following load test execution telemetry and logs:
+
+[LOAD SUMMARY METRICS]
+- Unified Blaze Health Score: ${finalSummary.healthScore}/100
+- Saturation Knee Point: ${finalSummary.saturationKneePoint} VUs
+- Peak Stability Variance (Std Dev): ${finalSummary.stdDev.toFixed(2)}ms
+- Network Bandwidth: ${finalSummary.bandwidth.toFixed(2)} MB/s
+
+[EXECUTION STEP HISTORY]
+${formattedHistory}
+
+[UNIQUE LOG SAMPLES EXPLORATION]
+${uniqueLogs || "No unique structural exceptions encountered."}
+
+Provide a punchy, highly technical 3-paragraph Root Cause Analysis (RCA) report. 
+Paragraph 1: Diagnose the exact bottleneck point (CPU saturation, socket pool exhaustion, database lock contention, etc.) indicated by how latency changes with concurrency.
+Paragraph 2: Correlate unique error patterns directly to performance drops.
+Paragraph 3: Give concrete, infrastructure or architectural sizing recommendations. 
+
+CRITICAL: Return ONLY plain paragraph text. Do not use markdown headers (###). If you use bold text, use standard HTML <strong> tags. Wrap lines cleanly.
+`;
+  try {
+    const response = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=${apiKey}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        contents: [{ parts: [{ text: prompt }] }],
+        generationConfig: {
+          temperature: 0.2,
+          maxOutputTokens: 2048
+          // Expanded token safety margin to prevent mid-sentence cutting
+        }
+      })
+    });
+    const data = await response.json();
+    const candidateText = data?.candidates?.[0]?.content?.parts?.[0]?.text;
+    if (!candidateText) throw new Error("Malformed API structural response layout");
+    return candidateText.replace(/\*\*(.*?)\*\*/g, "<strong>$1</strong>").replace(/\n/g, "<br>");
+  } catch (error) {
+    console.error("\u274C Gemini API processing breakdown failure:", error);
+    return `<span style="color: #f87171;">Failed to generate AI diagnosis framework: ${error.message}</span>`;
+  }
+}
 async function executeTestPipeline(config) {
   if (!blazeCore || typeof blazeCore.runCorrelatedTransaction !== "function") {
     console.error("\u274C Error: runCorrelatedTransaction function is missing from the compiled binary bindings.");
@@ -334,7 +388,7 @@ async function runIntelligentAgenticStressTest(config) {
     const analyzer = new LogAnalyzer();
     semanticReport = analyzer.process(aggregateErrorLogs);
   }
-  const finalState = history[history.length - 1] || { apdex: 0, errorRate: 0, p95Latency: 0, throughput: 0, avgLatency: 0 };
+  const finalState = history[history.length - 1] || { apdex: 0, errorRate: 0, p95Latency: 0, throughput: 0 };
   const healthScore = computeHealthScoreValue(finalState.apdex, finalState.errorRate, finalState.p95Latency, config.maxAllowedLatencyMs);
   const finalSummaryCards = {
     apdex: finalState.apdex,
@@ -349,17 +403,17 @@ async function runIntelligentAgenticStressTest(config) {
     healthScore
   };
   generateFinalAgentReport(history, healthScore);
+  const geminiAnalysisHtml = await generateGeminiRCA(history, finalSummaryCards, aggregateErrorLogs);
   if (config.isSeo) {
     const finalLat = finalState.avgLatency || finalSummaryCards.ttfb;
     const seo = calculateSeoImpactMetrics(finalLat);
     console.log(`\u{1F50E} [SEO Impact Report]: Target latency under stress (${finalLat.toFixed(1)}ms) triggers a predicted Search Visibility Loss of -${seo.trafficLoss}% [Status: ${seo.status}].`);
   }
   const breakdownRates = {};
-  Object.keys(globalCodeCounts).forEach((codeStr) => {
-    const code = parseInt(codeStr, 10);
+  Object.keys(globalCodeCounts).forEach((code) => {
     breakdownRates[code] = totalRequestsAccumulator === 0 ? 0 : globalCodeCounts[code] / totalRequestsAccumulator * 100;
   });
-  exportHtmlDashboard(history, config, verdictReason, semanticReport, { total1xx, total2xx, total3xx, total4xx, total5xx, breakdownRates }, finalSummaryCards, lastRawRequests);
+  exportHtmlDashboard(history, config, verdictReason, semanticReport, { total1xx, total2xx, total3xx, total4xx, total5xx, breakdownRates }, finalSummaryCards, lastRawRequests, geminiAnalysisHtml);
 }
 async function runStandardStressTest(config) {
   console.log(`\u{1F3CB}\uFE0F Running Standard Stress Test [Threads: ${config.threads} | Duration: ${config.durationSec}s]`);
@@ -398,13 +452,13 @@ async function runStandardStressTest(config) {
   };
   const isPassed = metrics.apdexScore >= config.targetApdex && metrics.errorRate <= config.targetErrorRate;
   const verdictReason = isPassed ? "Static single-wave baseline checks concluded successfully without triggering health boundaries." : "Static verification loop completed with values exceeding defined quality thresholds.";
+  const geminiAnalysisHtml = await generateGeminiRCA(history, finalSummaryCards, rawErrors.length > 0 ? rawErrors : getFallbackClusterLogs());
   if (config.isSeo) {
     const seo = calculateSeoImpactMetrics(metrics.avgLatencyMs);
     console.log(`\u{1F50E} [SEO Impact Report]: Target latency (${metrics.avgLatencyMs.toFixed(1)}ms) triggers a predicted Search Visibility Loss of -${seo.trafficLoss}% [Status: ${seo.status}].`);
   }
   const breakdownRates = {};
-  Object.keys(metrics.codeCounts).forEach((codeStr) => {
-    const code = parseInt(codeStr, 10);
+  Object.keys(metrics.codeCounts).forEach((code) => {
     breakdownRates[code] = metrics.totalRequests === 0 ? 0 : metrics.codeCounts[code] / metrics.totalRequests * 100;
   });
   exportHtmlDashboard(history, config, verdictReason, semanticReport, {
@@ -414,7 +468,7 @@ async function runStandardStressTest(config) {
     total4xx: metrics.c4xx,
     total5xx: metrics.c5xx,
     breakdownRates
-  }, finalSummaryCards, rawRequests);
+  }, finalSummaryCards, rawRequests, geminiAnalysisHtml);
 }
 function getFallbackClusterLogs() {
   const logs = [];
@@ -530,7 +584,7 @@ function generateFinalAgentReport(history, score) {
   console.log(`\u26A1 Peak Achieved Cluster Velocity   : ${peakThroughput.toFixed(0)} req/sec`);
   console.log("=======================================================\n");
 }
-function exportHtmlDashboard(history, config, verdictReason, semanticReport, responseMatrix, cards, rawRequests = []) {
+function exportHtmlDashboard(history, config, verdictReason, semanticReport, responseMatrix, cards, rawRequests = [], geminiAnalysisHtml = "") {
   const labels = history.map((h, i) => `${i + 1}s`);
   const successRequestsData = history.map((h) => h.successRequests);
   const failedWorkloadsData = history.map((h) => h.failedRequests);
@@ -843,6 +897,16 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
       </div>
     </div>
 
+    <!-- Live Gemini 2.5 Flash Autonomous RCA Module -->
+    <div class="card" style="margin-bottom: 2rem; background: #0c172b; border: 1px solid #7c3aed;">
+      <h3 style="color: #a78bfa; display: flex; align-items: center; gap: 0.6rem; font-size: 1.2rem; border-bottom: 1px solid #1e293b; padding-bottom: 0.5rem;">
+        \u26A1 Gemini 2.5 Flash Autonomous Root Cause Analysis (RCA)
+      </h3>
+      <div style="font-size: 0.95rem; line-height: 1.6; color: #cbd5e1; padding: 0.5rem 0; white-space: pre-wrap; word-break: break-word;">
+        ${geminiAnalysisHtml}
+      </div>
+    </div>
+
     <div class="charts-grid">
       <div class="graph-card">
         <div class="graph-title">\u{1F4CA} Throughput Velocity & Workload Volume</div>
@@ -865,6 +929,13 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         </div>
       </div>
 
+      <div class="graph-card">
+        <div class="graph-title">\u{1F369} HTTP Status Code Proportions</div>
+        <div style="height: 280px; position: relative;">
+          <canvas id="statusDonutChart"></canvas>
+        </div>
+      </div>
+
       <div class="graph-card">
         <div class="graph-title">\u{1F4C8} Time-to-First-Byte Scatter Plot</div>
         <div style="height: 280px; position: relative;">
@@ -1047,8 +1118,8 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         },
         scales: {
           x: { grid: { color: '#1e293b' }, ticks: { color: '#64748b' } },
-          yThreads: { position: 'left', grid: { color: '#1e293b' }, ticks: { color: '#38bdf8' }, title: { display: true, text: 'VUs / Threads', color: '#38bdf8' } },
-          yTtf: { position: 'right', grid: { drawOnChartArea: false }, ticks: { color: '#f43f5e' }, title: { display: true, text: 'TTF Index / Latency ms', color: '#f43f5e' } }
+          y_threads: { position: 'left', grid: { color: '#1e293b' }, ticks: { color: '#38bdf8' }, title: { display: true, text: 'VUs / Threads', color: '#38bdf8' } },
+          y_ttf: { position: 'right', grid: { drawOnChartArea: false }, ticks: { color: '#f43f5e' }, title: { display: true, text: 'TTF Index / Latency ms', color: '#f43f5e' } }
         }
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blaze-performance-tester",
-  "version": "3.1.35",
+  "version": "3.1.37",
   "description": "A high-performance, multi-threaded load testing engine built with Rust and QuickJS.",
   "type": "module",
   "main": "dist/index.js",