blaze-performance-tester 3.1.34 → 3.1.36

package/dist/cli.js

@@ -87,6 +87,54 @@ 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 METERICS]
+- 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, actionable infrastructure or architectural sizing recommendations. Do not use markdown headers inside your response, use standard HTML bold text if needed, and 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: 800 }
+      })
+    });
+    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(/\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.");
@@ -349,6 +397,7 @@ 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);
@@ -358,7 +407,7 @@ async function runIntelligentAgenticStressTest(config) {
   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]`);
@@ -397,6 +446,7 @@ 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}].`);
@@ -412,7 +462,7 @@ async function runStandardStressTest(config) {
     total4xx: metrics.c4xx,
     total5xx: metrics.c5xx,
     breakdownRates
-  }, finalSummaryCards, rawRequests);
+  }, finalSummaryCards, rawRequests, geminiAnalysisHtml);
 }
 function getFallbackClusterLogs() {
   const logs = [];
@@ -467,7 +517,7 @@ function processMetricsTelemetry(requests, durationSec) {
   const avgTlsMs = mathUtils.mean(requests.map((r) => r.tlsTimeMs || 0));
   const avgTtfbMs = avgDnsMs + avgTcpMs + avgTlsMs + avgLatencyMs * 0.3;
   let c1xx = 0, c2xx = 0, c3xx = 0, c4xx = 0, c5xx = 0;
-  const codeCounts = { 400: 0, 401: 0, 403: 0, 404: 0, 429: 0, 500: 502, 503: 0, 504: 0 };
+  const codeCounts = { 400: 0, 401: 0, 403: 0, 404: 0, 429: 0, 500: 0, 502: 0, 503: 0, 504: 0 };
   requests.forEach((r) => {
     if (r.statusCode >= 100 && r.statusCode < 200) c1xx++;
     else if (r.statusCode >= 200 && r.statusCode < 300) c2xx++;
@@ -528,7 +578,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);
@@ -545,33 +595,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     x: Number(((r.timestampMs - firstTimestamp) / 1e3).toFixed(2)),
     y: Number(((r.dnsTimeMs || 0) + (r.tcpTimeMs || 0) + (r.tlsTimeMs || 0) + r.durationMs * 0.3).toFixed(1))
   }));
-  let narrativeStoryText = "";
-  const terminalWave = history[history.length - 1];
-  const isSystemDegraded = cards.healthScore < 85 || terminalWave && terminalWave.errorRate > 0.01;
-  if (isSystemDegraded) {
-    let analyticalLogContext = "";
-    if (semanticReport && semanticReport.clusters && semanticReport.clusters.length > 0) {
-      const primaryPattern = semanticReport.clusters[0];
-      const blueprintSample = (primaryPattern.template || "").replace(/\[\d{4}-\d{2}-\d{2}.*?\]\s*/, "").substring(0, 130);
-      analyticalLogContext = ` The system failure state was dominated by a flood of <strong>${primaryPattern.category || "unclassified exceptions"}</strong> (${primaryPattern.count} trace entries), capturing dynamic footprints like: <code>${blueprintSample}...</code>.`;
-    }
-    narrativeStoryText = `<strong>Incident Narrative:</strong> During the load stress verification timeline, system resource contention triggered sharp degradation as simulated concurrency mounted up to <strong>${terminalWave?.threads || cards.saturationKneePoint} Virtual Users</strong>. At peak saturation, infrastructure throughput flattened out at <strong>${cards.throughput.toFixed(0)} req/sec</strong> while tracking metrics registered a P95 latency surge up to <strong>${terminalWave?.p95Latency.toFixed(1)}ms</strong>. ${verdictReason}${analyticalLogContext} The performance collapse dragged the composite health rating down to <strong>${cards.healthScore}/100</strong>, indicating target capacity boundaries have officially broken down under the active profile constraints.`;
-  } else {
-    narrativeStoryText = `<strong>Operational Summary:</strong> The pipeline concluded successfully without showing structural strain or performance compromises. Across the concurrency tiers peaking at <strong>${terminalWave?.threads || config.threads} active execution threads</strong>, infrastructure velocity sustained a robust <strong>${cards.throughput.toFixed(0)} req/sec</strong> with an exceptional Apdex tier of <strong>${cards.apdex.toFixed(2)}</strong>. Scanned event frameworks and metric trends yielded zero repeating error footprints, confirming system resilience matches the expected parameters perfectly with a health score of <strong>${cards.healthScore}/100</strong>.`;
-  }
-  const incidentNarrativeBoxHtml = `
-  <div class="card" style="margin-bottom: 2rem; background: linear-gradient(135deg, #1e1b4b 0%, #0f172a 100%); border: 1px solid #4338ca; border-radius: 8px; padding: 1.5rem; box-shadow: 0 4px 25px rgba(0, 0, 0, 0.55);">
-    <div style="display: flex; align-items: center; justify-content: space-between; margin-bottom: 0.85rem;">
-      <div style="display: flex; align-items: center; gap: 0.6rem; font-weight: 700; color: #818cf8; font-size: 1.1rem; text-transform: none; letter-spacing: normal;">
-        \u{1F9E0} Generative Incident Narrative (AI Plain-English Summary)
-      </div>
-      <span style="background: #4338ca; color: #e0e7ff; font-size: 0.7rem; font-weight: 800; padding: 0.25rem 0.6rem; border-radius: 4px; text-transform: uppercase; letter-spacing: 0.05em;">Telemetry Insight</span>
-    </div>
-    <p style="margin: 0; color: #cbd5e1; font-size: 0.95rem; line-height: 1.65; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;">
-      ${narrativeStoryText}
-    </p>
-  </div>
-  `;
   let logClustersHtml = "";
   if (semanticReport) {
     const totalLogCount = semanticReport.clusters.reduce((sum, c) => sum + c.count, 0);
@@ -770,7 +793,6 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
     .badge-fail { background: #dc2626; color: #fef2f2; }
   </style></head><body>
   <div class="container">
-    ${incidentNarrativeBoxHtml}
     <div class="header">
       <h1>\u{1F525} Blaze Core Performance Analysis</h1>
       <div class="meta">Target Script: <code>${config.targetScript}</code></div>
@@ -869,6 +891,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;">
+        ${geminiAnalysisHtml}
+      </div>
+    </div>
+
     <div class="charts-grid">
       <div class="graph-card">
         <div class="graph-title">\u{1F4CA} Throughput Velocity & Workload Volume</div>
@@ -1094,7 +1126,7 @@ function exportHtmlDashboard(history, config, verdictReason, semanticReport, res
         responsive: true,
         maintainAspectRatio: false,
         plugins: {
-          legend: { position: 'top', labels: { color: '#94a3b8', font: { size: 11 } },
+          legend: { position: 'top', labels: { color: '#94a3b8', font: { size: 11 } } },
           cutout: '65%'
         }
       }

package/package.json

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