at.happyproto.fleet.getCostShape

happyproto.at

Documentation

Disk and memory distribution, and bytes per record. Memory is reported as separate anonymous and file-backed figures and is never totalled. Admin only.

main query

Disk and memory distribution, and bytes per record. Memory is reported as separate anonymous and file-backed figures and is never totalled. Admin only.

Output

Encodingapplication/json
bytesPerRecord ref#pair Optional

No description available.

diskBytes ref#pair Optional

No description available.

have integer Optional

No description available.

instances integer Optional

No description available.

memoryAnon ref#pair Optional

Anonymous memory. Never summed with memoryFile.

memoryFile ref#pair Optional

File-backed memory, dominated by page cache. Its own figure: adding it to memoryAnon is how a healthy instance is diagnosed as leaking.

need integer Optional

No description available.

sources ref#sources Optional

No description available.

status string Required

Why a figure is absent. Branch on this, never on field presence.

Known values: ok, accruing, withheld
unit string Optional

No description available.

Known values: days, snapshots
windowDays integer Optional

No description available.

Errors

AuthRequired This endpoint requires an authenticated caller.
Forbidden The caller is not a HappyProto admin.
Upstream The telemetry store could not be queried.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
View raw schema 
{
  "description": "Disk and memory distribution, and bytes per record. Memory is reported as separate anonymous and file-backed figures and is never totalled. Admin only.",
  "errors": [
    {
      "description": "This endpoint requires an authenticated caller.",
      "name": "AuthRequired"
    },
    {
      "description": "The caller is not a HappyProto admin.",
      "name": "Forbidden"
    },
    {
      "description": "The telemetry store could not be queried.",
      "name": "Upstream"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "bytesPerRecord": {
          "ref": "#pair",
          "type": "ref"
        },
        "diskBytes": {
          "ref": "#pair",
          "type": "ref"
        },
        "have": {
          "type": "integer"
        },
        "instances": {
          "type": "integer"
        },
        "memoryAnon": {
          "description": "Anonymous memory. Never summed with memoryFile.",
          "ref": "#pair",
          "type": "ref"
        },
        "memoryFile": {
          "description": "File-backed memory, dominated by page cache. Its own figure: adding it to memoryAnon is how a healthy instance is diagnosed as leaking.",
          "ref": "#pair",
          "type": "ref"
        },
        "need": {
          "type": "integer"
        },
        "sources": {
          "ref": "#sources",
          "type": "ref"
        },
        "status": {
          "description": "Why a figure is absent. Branch on this, never on field presence.",
          "knownValues": [
            "ok",
            "accruing",
            "withheld"
          ],
          "type": "string"
        },
        "unit": {
          "knownValues": [
            "days",
            "snapshots"
          ],
          "type": "string"
        },
        "windowDays": {
          "type": "integer"
        }
      },
      "required": [
        "status"
      ],
      "type": "object"
    }
  },
  "type": "query"
}
pair object

No description available.

Properties

instances integer Required

Instances contributing to this figure.

p50 integer Required

No description available.

p90 integer Required

No description available.

View raw schema 
{
  "properties": {
    "instances": {
      "description": "Instances contributing to this figure.",
      "type": "integer"
    },
    "p50": {
      "type": "integer"
    },
    "p90": {
      "type": "integer"
    }
  },
  "required": [
    "p50",
    "p90",
    "instances"
  ],
  "type": "object"
}
sources object

Which map each figure came from. These metrics live in `host` on the current fleet (db_bytes, memory_anon_bytes) but the collector's benchmark rollup reads `totals` (database_bytes, rss_anon). Reporting the source makes a disagreement visible rather than silently resolved; "none" means the key is absent from both, so a 0 is not a measurement.

Properties

diskBytes string Optional

No description available.

Known values: host, totals, none
memoryAnon string Optional

No description available.

Known values: host, totals, none
memoryFile string Optional

No description available.

Known values: host, totals, none
View raw schema 
{
  "description": "Which map each figure came from. These metrics live in `host` on the current fleet (db_bytes, memory_anon_bytes) but the collector's benchmark rollup reads `totals` (database_bytes, rss_anon). Reporting the source makes a disagreement visible rather than silently resolved; \"none\" means the key is absent from both, so a 0 is not a measurement.",
  "properties": {
    "diskBytes": {
      "knownValues": [
        "host",
        "totals",
        "none"
      ],
      "type": "string"
    },
    "memoryAnon": {
      "knownValues": [
        "host",
        "totals",
        "none"
      ],
      "type": "string"
    },
    "memoryFile": {
      "knownValues": [
        "host",
        "totals",
        "none"
      ],
      "type": "string"
    }
  },
  "type": "object"
}

Lexicon Garden

@