@tonbo/cli 0.24.0 → 0.25.0

package/dist/bin/tonbo.js

@@ -1062,6 +1062,22 @@ var managementOperations = {
     "idempotencyKey": false,
     "cli": "tonbo volume delete"
   },
+  "getVolumeNameMetrics": {
+    "method": "GET",
+    "path": "/volumes/{name}/metrics",
+    "pathParams": [
+      "name"
+    ],
+    "query": [
+      "series",
+      "window",
+      "granularity",
+      "from",
+      "to"
+    ],
+    "idempotencyKey": false,
+    "cli": "tonbo volume metrics"
+  },
   "listStreams": {
     "method": "GET",
     "path": "/streams",
@@ -2459,6 +2475,10 @@ var ManagementApi = class {
   getVolumeMetrics(key, query = {}) {
     return this.call("getVolumeMetrics", key, { query });
   }
+  /** One Volume's guest I/O and stored bytes per UTC hour or day. */
+  getVolumeNameMetrics(key, name, query = {}) {
+    return this.call("getVolumeNameMetrics", key, { params: { name }, query });
+  }
   /** The account's writes of yesterday and today, hourly, per lane. */
   getUsageToday(key) {
     return this.call("getUsageToday", key);
@@ -5609,14 +5629,14 @@ async function metricsVolumesCommand(deps, options = {}) {
       ["DAY", "STORED", ""],
       points.map((point) => [
         point.start.slice(0, 10),
-        bytes(point.stored_bytes),
+        bytes(point.stored_bytes ?? 0),
         point.partial ? "so far" : ""
       ])
     )
   ];
   const complete = points.filter((point) => !point.partial);
   if (complete.length > 1) {
-    const change = complete[complete.length - 1].stored_bytes - complete[0].stored_bytes;
+    const change = (complete[complete.length - 1].stored_bytes ?? 0) - (complete[0].stored_bytes ?? 0);
     lines.push(
       `Change over its complete days: ${change < 0 ? "-" : "+"}${bytes(Math.abs(change))}`
     );
@@ -6009,6 +6029,44 @@ async function resolveVolumeBinding(deps, key, spec) {
     region: volume.region
   };
 }
+var VOLUME_COLUMNS = {
+  stored_bytes: ["STORED", (value) => bytes(value)],
+  read_bytes: ["READ", (value) => bytes(value)],
+  write_bytes: ["WRITTEN", (value) => bytes(value)],
+  read_ops: ["READ OPS", String],
+  write_ops: ["WRITE OPS", String],
+  trim_ops: ["TRIMS", String]
+};
+async function volumeMetricsCommand(deps, name, options = {}) {
+  const metrics = await deps.api.getVolumeNameMetrics(
+    await deps.auth.apiKey(),
+    name,
+    metricsQuery(options)
+  );
+  const series = Object.keys(VOLUME_COLUMNS).filter(
+    (key) => metrics.points.some((point) => key in point)
+  );
+  const hourly = metrics.granularity === "hour";
+  print(
+    deps,
+    options.json,
+    metrics,
+    [
+      `Volume ${metrics.name} in ${metrics.region} from ${metrics.from} to ${metrics.to} (UTC)`,
+      table(
+        [hourly ? "HOUR (UTC)" : "DAY (UTC)", ...series.map((key) => VOLUME_COLUMNS[key][0]), ""],
+        metrics.points.map((point) => [
+          hourly ? point.start.slice(0, 16).replace("T", " ") : point.start.slice(0, 10),
+          ...series.map((key) => {
+            const value = point[key];
+            return value === null || value === void 0 ? "-" : VOLUME_COLUMNS[key][1](value);
+          }),
+          point.partial ? "so far" : ""
+        ])
+      )
+    ].join("\n")
+  );
+}
 
 // src/machine.ts
 var MACHINE_ERROR_HINTS = {
@@ -7866,6 +7924,18 @@ var COMMAND_HELP = {
     examples: ["tonbo volume show data"],
     arguments: NAME("Volume")
   },
+  "tonbo volume metrics": {
+    about: [
+      "Prints the Volume's metrics, one row per UTC hour or day: the bytes and requests its Machine read, wrote and trimmed, as the Volume served them, and what its files held at the step's last sample, compressed. The I/O updates about every 30 seconds while the Volume is attached; the current step is marked `so far`.",
+      "Give `--window` (24h hourly; 7d, 30d or 90d daily, 7d also hourly with `--granularity hour`), or `--from` and `--to` with `--granularity` (at most 8 days hourly, 92 days daily). `--series` prints only the series it names. It carries no money: `tonbo usage show` says what the Volume cost."
+    ],
+    examples: [
+      "tonbo volume metrics data --window 24h",
+      "tonbo volume metrics data --series read_bytes,write_bytes --window 7d"
+    ],
+    arguments: NAME("Volume"),
+    defaults: { "--window": "30d" }
+  },
   "tonbo volume move": {
     about: [
       "Moves the Volume to the Machine `--to`, taking it from the Machine that has it now in one write: the Volume is unbound there (that Machine's ETag changes and it boots without it) and bound to `--to`, which may be awake and gets it at its next boot. The CLI reads both Machines' ETags first, so a Machine changed since is refused, never overwritten. Without `--path` the Volume keeps the path it has now, or stays a whole disk; a whole disk moves only to a Machine on the same image.",
@@ -9900,6 +9970,17 @@ function createProgram(makeDependencies = createDependencies) {
   ).action(
     async (name, options) => volumeShowCommand(dependencies(), name, options)
   );
+  operationOptions(
+    volume.command("metrics <name>").description(
+      "show what a Volume's Machine read, wrote and trimmed, and what it held, over time"
+    ).option("--window <window>", "24h hourly, or 7d, 30d or 90d daily; 30d when omitted").option(
+      "--series <series>",
+      "the series to print, comma-separated; every series when omitted"
+    ).option("--granularity <step>", "hour or day: with --from and --to, or with --window 7d").option("--from <time>", "with --to, the window's start, on a UTC hour or day").option("--to <time>", "with --from, the window's end, exclusive"),
+    "getVolumeNameMetrics"
+  ).action(
+    async (name, options) => volumeMetricsCommand(dependencies(), name, options)
+  );
   operationOptions(
     volume.command("move <name>").description(
       "move a Volume to another Machine of its region, taking it from the asleep Machine that has it in the same write"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonbo/cli",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "The Tonbo CLI. Compute, disks, databases and streams for AI agents: your agent picks what it needs, sets it up, and knows what it costs, from the command line.",
   "homepage": "https://tonbo.dev",
   "bugs": {