Skip to content
Hayonix

API reference · Schema

PodTelemetry

  • objectstringrequired

    Always `pod_telemetry`: the type of this object

    One ofpod_telemetry

  • pod_idstringrequired

    ID of the pod

  • resolution_secondsintegerrequired

    Seconds per point

  • sourcestringrequired

    Where the points come from: `raw` samples, or `minute` or `hour` summaries (coarser resolutions)

    One ofrawminutehour

  • limitsobjectrequired

    The pod’s resources, the 100% mark of the percentages

    Show 3 fields of limits
    • vcpusintegerrequired

      vCPUs the pod has

    • memory_bytesnumberrequired

      Memory the pod has, in bytes

    • gpu_countintegerrequired

      Number of GPUs

  • pointsarray of objectrequired

    One point per bucket, oldest first

    Show 14 fields of points
    • tstring (date-time)required

      Start of the bucket

    • covered_secondsnumberrequired

      Seconds of the bucket with samples (less when it was not running)

    • cpu_coresnumberrequired

      Average CPU use, in cores

    • cpu_percentnumberrequired

      Of the pod’s vCPUs

    • memory_bytes_avgnumberrequired

      Average memory use, in bytes

    • memory_bytes_maxnumberrequired

      Peak memory use, in bytes

    • memory_percentnumberrequired

      Average memory use as a percentage of the pod’s memory

    • disk_read_bytes_per_secondnumberrequired

      Average disk read rate, in bytes per second

    • disk_write_bytes_per_secondnumberrequired

      Average disk write rate, in bytes per second

    • network_rx_bytes_per_secondnumberrequired

      Average network receive rate, in bytes per second

    • network_tx_bytes_per_secondnumberrequired

      Average network send rate, in bytes per second

    • gpu_utilization_percentnumber | nullrequired

      Average GPU utilisation, 0–100; null when there are no GPU samples

    • gpu_memory_bytes_avgnumber | nullrequired

      Average GPU memory in use, in bytes; null without GPU samples

    • gpu_memory_bytes_maxnumber | nullrequired

      Peak GPU memory in use, in bytes; null without GPU samples

  • totalsobjectrequired

    Sums over the whole range

    Show 6 fields of totals
    • covered_secondsnumberrequired

      Seconds of the range with samples

    • cpu_core_secondsnumberrequired

      CPU used, in core-seconds

    • disk_read_bytesstringrequired

      Bytes read from disk (integer as a decimal string)

    • disk_write_bytesstringrequired

      Bytes written to disk (integer as a decimal string)

    • network_rx_bytesstringrequired

      Bytes received (integer as a decimal string)

    • network_tx_bytesstringrequired

      Bytes sent (integer as a decimal string)

  • as_ofstring (date-time)required

    When the response was computed

Example
{
  "object": "pod_telemetry",
  "pod_id": "string",
  "resolution_seconds": 1,
  "source": "raw",
  "limits": {
    "vcpus": 1,
    "memory_bytes": 1.5,
    "gpu_count": 1
  },
  "points": [
    {
      "t": "2026-01-01T00:00:00.000Z",
      "covered_seconds": 1.5,
      "cpu_cores": 1.5,
      "cpu_percent": 1.5,
      "memory_bytes_avg": 1.5,
      "memory_bytes_max": 1.5,
      "memory_percent": 1.5,
      "disk_read_bytes_per_second": 1.5,
      "disk_write_bytes_per_second": 1.5,
      "network_rx_bytes_per_second": 1.5,
      "network_tx_bytes_per_second": 1.5,
      "gpu_utilization_percent": 1.5,
      "gpu_memory_bytes_avg": 1.5,
      "gpu_memory_bytes_max": 1.5
    }
  ],
  "totals": {
    "covered_seconds": 1.5,
    "cpu_core_seconds": 1.5,
    "disk_read_bytes": "string",
    "disk_write_bytes": "string",
    "network_rx_bytes": "string",
    "network_tx_bytes": "string"
  },
  "as_of": "2026-01-01T00:00:00.000Z"
}

Used by