at.happyproto.fleet.getSignals
Fleet-wide failure signals, derived from each instance's most recent snapshot. Admin only.
Details · query
| Kind | query |
|---|---|
| Authority | fleet.happyproto.at |
| Indexed |
Checks
Validunlimited-stringdefs.quietInstance.properties.instanceIdNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.signal.properties.keyNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.signal.properties.labelNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.signal.properties.severityNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"instanceCounts": {
"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"
},
"main": {
"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"
},
"quietInstance": {
"properties": {
"instanceId": {
"type": "string"
},
"lastSeen": {
"format": "datetime",
"type": "string"
}
},
"required": [
"instanceId",
"lastSeen"
],
"type": "object"
},
"signal": {
"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"
}
},
"id": "at.happyproto.fleet.getSignals",
"lexicon": 1
}