@closeup1202/klag 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 > Know **why** your Kafka consumer lag is growing — in 5 seconds from the terminal
 
-[![npm version](https://badge.fury.io/js/klag.svg)](https://www.npmjs.com/package/klag)
+[![npm version](https://badge.fury.io/js/%40closeup1202%2Fklag.svg)](https://www.npmjs.com/package/@closeup1202/klag)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## Compared to existing tools
@@ -21,21 +21,21 @@ npx @closeup1202/klag --broker localhost:9092 --group my-service
 
 ## Output example
 ```
-⚡ klag  v0.1.0
+⚡ klag 0.3.0
 
 🔍 Consumer Group: my-service
    Broker:         localhost:9092
-   Collected At:   2026-03-26 17:27:27 (Asia/Seoul)
+   Collected At:   2026-03-28 17:27:27 (Asia/Seoul)
 
-   Group Status : ⚠️  WARNING   Total Lag : 1,234
+   Group Status : 🚨 CRITICAL   Total Lag : 1,234   Drain : ∞
 
-┌────────┬───────────┬──────────────────┬────────────────┬───────┬─────────┬──────────────┬──────────────┐
-│ Topic  │ Partition │ Committed Offset │ Log-End Offset │  Lag  │ Status  │ Produce Rate │ Consume Rate │
-├────────┼───────────┼──────────────────┼────────────────┼───────┼─────────┼──────────────┼──────────────┤
-│ orders │         0 │            8,796 │         10,000 │ 1,204 │ 🔴 HIGH │  40.0 msg/s  │   0.0 msg/s  │
-│ orders │         1 │            9,988 │         10,000 │    12 │ 🟢 OK   │   0.0 msg/s  │   0.0 msg/s  │
-│ orders │         2 │            9,982 │         10,000 │    18 │ 🟢 OK   │   0.0 msg/s  │   0.0 msg/s  │
-└────────┴───────────┴──────────────────┴────────────────┴───────┴─────────┴──────────────┴──────────────┘
+┌────────┬───────────┬──────────────────┬────────────────┬───────┬─────────┬──────┬──────────────┬──────────────┐
+│ Topic  │ Partition │ Committed Offset │ Log-End Offset │  Lag  │ Status  │ Drain│ Produce Rate │ Consume Rate │
+├────────┼───────────┼──────────────────┼────────────────┼───────┼─────────┼──────┼──────────────┼──────────────┤
+│ orders │         0 │            8,796 │         10,000 │ 1,204 │ 🔴 HIGH │    ∞ │  40.0 msg/s  │   0.0 msg/s  │
+│ orders │         1 │            9,988 │         10,000 │    12 │ 🟢 OK   │    — │   0.0 msg/s  │   0.0 msg/s  │
+│ orders │         2 │            9,982 │         10,000 │    18 │ 🟢 OK   │    — │   0.0 msg/s  │   0.0 msg/s  │
+└────────┴───────────┴──────────────────┴────────────────┴───────┴─────────┴──────┴──────────────┴──────────────┘
 
 🔎 Root Cause Analysis
    [PRODUCER_BURST] orders
@@ -156,8 +156,9 @@ All consumption pauses during rebalancing, which can cause a temporary lag spike
 
 - [x] v0.1.0 — lag collection, hot partition, producer burst, slow consumer, rebalancing detection, watch mode with lag trend (▲▼)
 - [x] v0.2.0 — SSL/SASL authentication, `.klagrc` config file support
-- [ ] v0.3.0 — multi-group monitoring
-- [ ] v0.4.0 — Slack alerts, Prometheus export
+- [x] v0.3.0 — time-to-drain severity classification, Drain column per partition
+- [ ] v0.4.0 — multi-group monitoring
+- [ ] v0.5.0 — Slack alerts, Prometheus export
 
 ## License
 

package/dist/cli/index.js

@@ -363,12 +363,30 @@ import chalk from "chalk";
 import Table from "cli-table3";
 
 // src/types/index.ts
-var VERSION = "0.2.0";
-function classifyLag(lag) {
-  if (lag < 100n) return "OK";
-  if (lag < 1000n) return "WARN";
+var VERSION = "0.3.0";
+function classifyLag(lag, consumeRate) {
+  if (lag === 0n) return "OK";
+  if (consumeRate !== void 0) {
+    if (consumeRate === 0) return "HIGH";
+    const drainSec = Number(lag) / consumeRate;
+    if (drainSec < 60) return "OK";
+    if (drainSec < 300) return "WARN";
+    return "HIGH";
+  }
+  if (lag < 10000n) return "OK";
+  if (lag < 100000n) return "WARN";
   return "HIGH";
 }
+function formatDrainTime(lag, consumeRate) {
+  if (lag === 0n) return "\u2014";
+  if (consumeRate === 0) return "\u221E";
+  const sec = Math.ceil(Number(lag) / consumeRate);
+  if (sec < 60) return `${sec}s`;
+  const m = Math.floor(sec / 60);
+  const s = sec % 60;
+  if (sec < 3600) return s > 0 ? `${m}m${s}s` : `${m}m`;
+  return `>${Math.floor(sec / 3600)}h`;
+}
 
 // src/reporter/tableReporter.ts
 var LEVEL_ICON = {
@@ -388,8 +406,8 @@ function formatTrend(lagDiff) {
   if (lagDiff > 0n) return chalk.red(`\u25B2 +${lagDiff.toLocaleString()}`);
   return chalk.green(`\u25BC ${lagDiff.toLocaleString()}`);
 }
-function groupStatus(totalLag) {
-  const level = classifyLag(totalLag);
+function groupStatus(totalLag, totalConsumeRate) {
+  const level = classifyLag(totalLag, totalConsumeRate);
   if (level === "OK") return chalk.green("\u2705 OK");
   if (level === "WARN") return chalk.yellow("\u26A0\uFE0F  WARNING");
   return chalk.red("\u{1F6A8} CRITICAL");
@@ -418,18 +436,25 @@ function printLagTable(snapshot, rcaResults = [], rateSnapshot, watchMode = fals
     chalk.bold("   Collected At:   ") + chalk.gray(`${localTime} (${tz})`)
   );
   console.log("");
-  const status = groupStatus(totalLag);
-  const totalStr = chalk.bold(formatLag(totalLag));
-  console.log(`   Group Status : ${status}   Total Lag : ${totalStr}`);
-  console.log("");
   const hasRate = !!rateSnapshot && rateSnapshot.partitions.length > 0;
   const hasTrend = watchMode;
   const rateMap = /* @__PURE__ */ new Map();
+  let totalConsumeRate;
   if (hasRate && rateSnapshot) {
+    let sum = 0;
     for (const r of rateSnapshot.partitions) {
       rateMap.set(`${r.topic}-${r.partition}`, r);
+      sum += r.consumeRate;
     }
+    totalConsumeRate = sum;
   }
+  const status = groupStatus(totalLag, totalConsumeRate);
+  const totalStr = chalk.bold(formatLag(totalLag));
+  const drainStr = totalConsumeRate !== void 0 ? `   Drain : ${chalk.cyan(formatDrainTime(totalLag, totalConsumeRate))}` : "";
+  console.log(
+    `   Group Status : ${status}   Total Lag : ${totalStr}${drainStr}`
+  );
+  console.log("");
   const head = [
     chalk.bold("Topic"),
     chalk.bold("Partition"),
@@ -438,7 +463,11 @@ function printLagTable(snapshot, rcaResults = [], rateSnapshot, watchMode = fals
     chalk.bold("Lag"),
     ...hasTrend ? [chalk.bold("Trend")] : [],
     chalk.bold("Status"),
-    ...hasRate ? [chalk.bold("Produce Rate"), chalk.bold("Consume Rate")] : []
+    ...hasRate ? [
+      chalk.bold("Drain"),
+      chalk.bold("Produce Rate"),
+      chalk.bold("Consume Rate")
+    ] : []
   ];
   const table = new Table({
     head,
@@ -450,16 +479,19 @@ function printLagTable(snapshot, rcaResults = [], rateSnapshot, watchMode = fals
       "right",
       ...hasTrend ? ["right"] : [],
       "center",
-      ...hasRate ? ["right", "right"] : []
+      ...hasRate ? ["right", "right", "right"] : []
     ],
     style: { head: [], border: ["grey"] }
   });
   let lastTopic = "";
   for (const p of partitions) {
-    const level = classifyLag(p.lag);
-    const lagStr = level === "HIGH" ? chalk.red(formatLag(p.lag)) : level === "WARN" ? chalk.yellow(formatLag(p.lag)) : chalk.green(formatLag(p.lag));
     const rateEntry = rateMap.get(`${p.topic}-${p.partition}`);
+    const level = classifyLag(p.lag, rateEntry?.consumeRate);
+    const lagStr = level === "HIGH" ? chalk.red(formatLag(p.lag)) : level === "WARN" ? chalk.yellow(formatLag(p.lag)) : chalk.green(formatLag(p.lag));
     const rateColumns = hasRate ? [
+      chalk.cyan(
+        rateEntry !== void 0 ? formatDrainTime(p.lag, rateEntry.consumeRate) : "\u2014"
+      ),
       chalk.yellow(formatRate(rateEntry?.produceRate ?? 0)),
       chalk.cyan(formatRate(rateEntry?.consumeRate ?? 0))
     ] : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@closeup1202/klag",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Kafka consumer lag root cause analyzer",
   "type": "module",
   "bin": {