at.happyproto.fleet.getSignals

happyproto.at

Documentation

Fleet-wide failure signals, derived from each instance's most recent snapshot. Admin only.

main query

Fleet-wide failure signals, derived from each instance's most recent snapshot. Admin only.

Output

Encodingapplication/json
instances ref#instanceCounts Required

Instances by recency. Previously a single integer counting every instance that ever reported, which overstated a fleet whose members had died.

quiet array Required

Instances whose most recent snapshot is older than the quiet threshold.

signals array Required

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": "Fleet-wide failure signals, derived from each instance's most recent snapshot. 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": {
        "instances": {
          "description": "Instances by recency. Previously a single integer counting every instance that ever reported, which overstated a fleet whose members had died.",
          "ref": "#instanceCounts",
          "type": "ref"
        },
        "quiet": {
          "description": "Instances whose most recent snapshot is older than the quiet threshold.",
          "items": {
            "ref": "#quietInstance",
            "type": "ref"
          },
          "type": "array"
        },
        "signals": {
          "items": {
            "ref": "#signal",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "instances",
        "signals",
        "quiet"
      ],
      "type": "object"
    }
  },
  "type": "query"
}
instanceCounts object

No description available.

Properties

active integer Required

Reported within 48 hours.

dormant integer Required

Silent over 90 days. EXCLUDES manual-mode instances: a manual instance quiet for 90 days is quiet, not dead.

quiet integer Required

48 hours to 90 days — plus any manual-mode instance, at any age.

total integer Required

Every instance with at least one snapshot.

View raw schema 
{
  "properties": {
    "active": {
      "description": "Reported within 48 hours.",
      "type": "integer"
    },
    "dormant": {
      "description": "Silent over 90 days. EXCLUDES manual-mode instances: a manual instance quiet for 90 days is quiet, not dead.",
      "type": "integer"
    },
    "quiet": {
      "description": "48 hours to 90 days — plus any manual-mode instance, at any age.",
      "type": "integer"
    },
    "total": {
      "description": "Every instance with at least one snapshot.",
      "type": "integer"
    }
  },
  "required": [
    "active",
    "quiet",
    "dormant",
    "total"
  ],
  "type": "object"
}
quietInstance object

No description available.

Properties

instanceId string Required

No description available.

lastSeen string datetime Required

An RFC 3339 formatted timestamp.

View raw schema 
{
  "properties": {
    "instanceId": {
      "type": "string"
    },
    "lastSeen": {
      "format": "datetime",
      "type": "string"
    }
  },
  "required": [
    "instanceId",
    "lastSeen"
  ],
  "type": "object"
}
signal object

No description available.

Properties

instances integer Required

How many instances reported this at least once.

key string Required

No description available.

label string Required

No description available.

severity string Optional

No description available.

Known values: warn, info
total integer Optional

Sum across the fleet.

View raw schema 
{
  "properties": {
    "instances": {
      "description": "How many instances reported this at least once.",
      "type": "integer"
    },
    "key": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "severity": {
      "knownValues": [
        "warn",
        "info"
      ],
      "type": "string"
    },
    "total": {
      "description": "Sum across the fleet.",
      "type": "integer"
    }
  },
  "required": [
    "key",
    "label",
    "instances"
  ],
  "type": "object"
}

Lexicon Garden

@