Track and query custom telemetry events from agents, CLI tools, and external runners.
Telemetry API
The Telemetry API is a general-purpose event bus for emitting structured events from agents, CLI scripts, and external compute runners. Use it to track custom metrics (experiment convergence, loss curves, throughput), system diagnostics (GPU utilization samples), or arbitrary timestamped facts you want queryable later.
List Events
string
required
Convex ID of the lab.
string
Filter to a specific event name (e.g., gpu.utilization, loss.epoch).
number
default:100
Max events to return. Capped at 500.
# All eventscurl "https://www.hubify.com/api/v1/telemetry?labId=$LAB_ID&limit=50" \ -H "Authorization: Bearer $HUBIFY_TOKEN"# Filter to GPU utilization samplescurl "https://www.hubify.com/api/v1/telemetry?labId=$LAB_ID&event=gpu.utilization" \ -H "Authorization: Bearer $HUBIFY_TOKEN"
object[]
required
Telemetry events, newest first.
Show Event
string
required
Convex document ID.
string
required
Event name (dot-separated, e.g., loss.epoch, experiment.step).