mirror of
https://github.com/MeshCore-Beacon/beacon-server.git
synced 2026-10-20 12:11:58 +00:00
Merge remote-tracking branch 'origin/dev' into codex/post20-base-20261002
This commit is contained in:
+32
-1
@@ -2835,7 +2835,7 @@ const docTemplate = `{
|
||||
},
|
||||
"/stats/scopes": {
|
||||
"get": {
|
||||
"description": "Packets are those heard since the window start, each counted once per hour however many of the requested IATAs heard it. Observers and nodes are current memberships: observers filter by the IATA they last reported from, nodes by their IATA memberships. With filters, lists only manual scopes configured for a matching region and imported scopes whose current MeshMapper catalogue includes a matching IATA; those remain listed with zero counts. An empty region returns an empty array.",
|
||||
"description": "Packets are those heard since the window start, each counted once per hour however many of the requested IATAs heard it. Observers and nodes are current memberships: observers filter by the IATA they last reported from, nodes by their IATA memberships. hourly splits packetCount by UTC hour and adds the distinct observers and advertising nodes active in the scope each hour (empty hours omitted; outage gaps come from /stats/series hour status). With filters, lists only manual scopes configured for a matching region and imported scopes whose current MeshMapper catalogue includes a matching IATA; those remain listed with zero counts. An empty region returns an empty array.",
|
||||
"produces": [
|
||||
"application/json"
|
||||
],
|
||||
@@ -4872,6 +4872,10 @@ const docTemplate = `{
|
||||
"hour": {
|
||||
"type": "integer"
|
||||
},
|
||||
"maxEntries": {
|
||||
"description": "longest path received that hour across the requested IATAs; 0 if only empty paths",
|
||||
"type": "integer"
|
||||
},
|
||||
"oneByte": {
|
||||
"type": "integer"
|
||||
},
|
||||
@@ -5205,9 +5209,36 @@ const docTemplate = `{
|
||||
}
|
||||
}
|
||||
},
|
||||
"github_com_MeshCore-Beacon_beacon-server_internal_api.ScopeHour": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"hour": {
|
||||
"description": "epoch ms, start of the UTC hour",
|
||||
"type": "integer"
|
||||
},
|
||||
"nodes": {
|
||||
"description": "distinct nodes whose adverts were heard in the scope that hour",
|
||||
"type": "integer"
|
||||
},
|
||||
"observers": {
|
||||
"description": "distinct observers that heard the scope's packets that hour",
|
||||
"type": "integer"
|
||||
},
|
||||
"packets": {
|
||||
"type": "integer"
|
||||
}
|
||||
}
|
||||
},
|
||||
"github_com_MeshCore-Beacon_beacon-server_internal_api.ScopeStats": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"hourly": {
|
||||
"description": "packetCount by hour, oldest first; hours with none omitted",
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/github_com_MeshCore-Beacon_beacon-server_internal_api.ScopeHour"
|
||||
}
|
||||
},
|
||||
"name": {
|
||||
"description": "normalized scope name e.g. \"#bc\"",
|
||||
"type": "string"
|
||||
|
||||
Reference in New Issue
Block a user