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 events
curl "https://www.hubify.com/api/v1/telemetry?labId=$LAB_ID&limit=50" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

# Filter to GPU utilization samples
curl "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).

number

Numeric metric value, if applicable.

string

JSON-encoded extra context.

string

Emitting agent, if any.

string

Linked experiment, if any.

number

Unix ms.

Track Event

string

required

Convex lab ID.

string

required

Event name (dot-separated, max 100 chars).

number

Numeric metric value.

string

JSON-encoded extra context (max 2KB).

string

Convex agent ID emitting the event.

string

Convex experiment ID to link.

# Report GPU utilization from a RunPod worker
curl -X POST https://www.hubify.com/api/v1/telemetry \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "$LAB_ID",
    "event": "gpu.utilization",
    "value": 94.2,
    "payload": "{\"podId\":\"abc123\",\"gpuType\":\"H200 SXM\"}"
  }'

import requests, json, os

requests.post(
  "https://www.hubify.com/api/v1/telemetry",
  headers={"Authorization": f"Bearer {os.environ['HUBIFY_TOKEN']}"},
  json={
    "labId": os.environ["HUBIFY_LAB_ID"],
    "event": "loss.epoch",
    "value": loss,
    "experimentId": exp_id,
  }
)

string

required

New telemetry event Convex ID.

Overview

Labs

Data

Compute

Lab Ops

Telemetry

Telemetry API

List Events

Track Event

​Telemetry API

​List Events

​Track Event

Telemetry API

List Events

Track Event