@vzn/vx-otel 0.0.530 → 0.0.531

package/README.md

@@ -113,7 +113,12 @@ otel({
   ran how many files its key read (`vx.task.input_files`) and what its key
   changed since the last entry the cache saved for it
   (`vx.cache.miss.change_count`, and `vx.cache.miss.changes`, the first ten
-  as `changed file packages/a/src/x.ts`). A
+  as `changed file packages/a/src/x.ts`), and what the cache cost: the
+  artifact's size (`vx.cache.artifact_bytes`, a hit's entry or the one a
+  miss saved), a miss's save (`vx.cache.save_ms`) and a remote hit's
+  download (`vx.cache.fetch_ms`). The run span adds the remote uploads
+  once they settled (`vx.cache.upload.count`, `.bytes`, `.ms` summed,
+  `.failed`). A
   failed task sets span status
   `ERROR`. A task span links to the spans of the tasks it waited on (a
   group seen through to the tasks behind it), and carries an event per
@@ -144,8 +149,9 @@ backend adds runs rather than reading each as the series' new total.
 `vx.task.duration` (ms, with `vx.cache.source`), and for a task the runner
 measured `vx.task.cpu_time` (ms) and `vx.task.peak_memory` (bytes), on a
 hit `vx.task.time_saved` (ms), `vx.task.admission_held` (ms) when an
-`admit` policy held it, and `vx.task.queued` (ms) when it waited for a
-worker; a skipped task sends none. While a task runs, its process tree is sampled
+`admit` policy held it, `vx.task.queued` (ms) when it waited for a
+worker, `vx.task.artifact_size` (bytes), `vx.task.cache_save` and
+`vx.task.cache_fetch` (ms); a skipped task sends none. While a task runs, its process tree is sampled
 each second: `vx.task.cpu_usage` (cores busy since the last sample, 1 =
 one core) and `vx.task.memory` (resident bytes). Sampling runs only while
 metrics export; a remote task, or a task under 1 s, has no samples.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx-otel",
-  "version": "0.0.530",
+  "version": "0.0.531",
   "license": "MIT",
   "description": "OpenTelemetry exporter for vx — a telemetry plugin mapping runs to OTLP traces + metrics (CI/CD + VCS semantic conventions).",
   "keywords": [
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@vzn/vx": "^0.0.530"
+    "@vzn/vx": "^0.0.531"
   },
   "repository": {
     "type": "git",

package/src/otlp.ts

@@ -151,6 +151,13 @@ const VX_ATTR = {
   taskQueuedMs: 'vx.task.queued_ms',
   taskInputFiles: 'vx.task.input_files',
   missChangeCount: 'vx.cache.miss.change_count',
+  artifactBytes: 'vx.cache.artifact_bytes',
+  fetchMs: 'vx.cache.fetch_ms',
+  saveMs: 'vx.cache.save_ms',
+  uploadCount: 'vx.cache.upload.count',
+  uploadBytes: 'vx.cache.upload.bytes',
+  uploadMs: 'vx.cache.upload.ms',
+  uploadFailed: 'vx.cache.upload.failed',
   missChanges: 'vx.cache.miss.changes',
   ciJob: 'vx.ci.job',
   ciAttempt: 'vx.ci.attempt',
@@ -406,6 +413,14 @@ export function runSpanAttributes(run: RunContextRecord, summary?: RunSummaryRec
       boolAttr(VX_ATTR.runExitOk, summary.exitOk),
       strAttr(SEMCONV.pipelineResult, pipelineResult(summary)),
     )
+    if (summary.uploads !== undefined) {
+      attrs.push(
+        intAttr(VX_ATTR.uploadCount, summary.uploads.count),
+        intAttr(VX_ATTR.uploadBytes, summary.uploads.bytes),
+        intAttr(VX_ATTR.uploadMs, summary.uploads.ms),
+        intAttr(VX_ATTR.uploadFailed, summary.uploads.failed),
+      )
+    }
   }
   return attrs
 }
@@ -520,6 +535,9 @@ export function taskSpanAttributes(t: TaskTelemetry, run: TaskSpanRunContext): K
     attrs.push(intAttr(VX_ATTR.taskAdmissionHeldMs, t.admissionHeldMs))
   if (t.queuedMs !== undefined) attrs.push(intAttr(VX_ATTR.taskQueuedMs, t.queuedMs))
   if (t.inputFiles !== undefined) attrs.push(intAttr(VX_ATTR.taskInputFiles, t.inputFiles))
+  if (t.artifactBytes !== undefined) attrs.push(intAttr(VX_ATTR.artifactBytes, t.artifactBytes))
+  if (t.fetchMs !== undefined) attrs.push(intAttr(VX_ATTR.fetchMs, t.fetchMs))
+  if (t.saveMs !== undefined) attrs.push(intAttr(VX_ATTR.saveMs, t.saveMs))
   if (t.inputChanges !== undefined) {
     // `changed file src/a.ts`: what moved the key since the last saved entry.
     attrs.push(
@@ -725,6 +743,9 @@ function taskMetrics(points: readonly TaskMetricPoint[]): unknown[] {
     if (t.storedDurationMs !== undefined) add('vx.task.time_saved', 'ms', at(t.storedDurationMs))
     if (t.admissionHeldMs !== undefined) add('vx.task.admission_held', 'ms', at(t.admissionHeldMs))
     if (t.queuedMs !== undefined) add('vx.task.queued', 'ms', at(t.queuedMs))
+    if (t.artifactBytes !== undefined) add('vx.task.artifact_size', 'By', at(t.artifactBytes))
+    if (t.fetchMs !== undefined) add('vx.task.cache_fetch', 'ms', at(t.fetchMs))
+    if (t.saveMs !== undefined) add('vx.task.cache_save', 'ms', at(t.saveMs))
   }
   return [...series].map(([name, { unit, dataPoints }]) => ({ name, unit, gauge: { dataPoints } }))
 }