snxraven/peardata
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Updates
CI / test (push) Successful in 1m3s
Details
Release rolling / release (push) Has been cancelled
Details

Browse Source
This commit is contained in:
Raven Scott
2026-07-18 23:47:54 -04:00
parent e503e92dd4
commit 3fc0245b32
34 changed files with 834 additions and 197 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/SWAGGER_PLAN.md
+7 -6
View File
@@ -26,7 +26,7 @@ Verified: **2026-07-18** (static analysis of routes + collector emit sites; unit
| Data query (`/api/v*/data`) | v1–v3 | v1–v3 | Implemented (MVP grouping) |
| allmetrics export | shell / prometheus / json | shell / prometheus / json | Implemented (`prometheus_all_hosts` not separate) |
| Contexts | v1–v3 | **v2 + v3** (v1 missing) | Partial |
| Weights / search | v1–v3 | v2 + v3 MVP | Partial |
| Weights / search / logs | v1–v3 | v1–v3 weights + logs | Done (single-host) |
| Alerts | rich v1–v3 | core read paths | Partial |
| Cloud / claim / ACLK / bearer / WebRTC | many | none | Intentionally out of scope |
@@ -174,6 +174,7 @@ Legend:
| GET | `/api/v1/metric_correlations` | **skip** | Deprecated upstream |
| GET | `/api/v2/weights` | **done** | MC: `volume` / `ks2` / `anomaly-rate` / `value`; no window → `alerts` |
| GET | `/api/v3/weights` | **done** | Same; see [REST-API](./REST-API.md) + [user-guide/weights-api](../user-guide/weights-api.md). Multi-node `scope_nodes` / fleet aggregation still out of scope |
| GET | `/api/v1\|v2\|v3/logs` | **done** | PearData extension — anomaly / audit / journal (`queryLogs`); see [REST-API](./REST-API.md) + [user-guide/logs](../user-guide/logs.md) |
### B4. Nodes / info / health
@@ -326,10 +327,10 @@ const missing = STATIC_CHART_DEFS.filter(d => !c.includes(d.id)).map(d => d.id)
console.log(missing.length ? missing : 'all static charts referenced')
"
# 3) Live smoke (agent running on :19999)
curl -s http://127.0.0.1:19999/api/v1/charts | jq '.charts | keys | length'
curl -s 'http://127.0.0.1:19999/api/v3/data?chart=system.cpu&after=-60&points=30' | jq '.labels,.points'
curl -s 'http://127.0.0.1:19999/api/v3/allmetrics?format=prometheus' | head
# 3) Live smoke (agent running on :18888)
curl -s http://127.0.0.1:18888/api/v1/charts | jq '.charts | keys | length'
curl -s 'http://127.0.0.1:18888/api/v3/data?chart=system.cpu&after=-60&points=30' | jq '.labels,.points'
curl -s 'http://127.0.0.1:18888/api/v3/allmetrics?format=prometheus' | head
```
---
@@ -345,4 +346,4 @@ curl -s 'http://127.0.0.1:19999/api/v3/allmetrics?format=prometheus' | head
| Full swagger operation parity (72 ops) | **NO** (~38 matched; rest alias/skip/todo) |
| Cloud / WebRTC / DynCFG | **N/A by design** |
**Bottom line:** Every host metric chart PearData defines is collected. Every swagger endpoint required to *discover and scrape those metrics* is implemented on v1/v2/v3 as appropriate. Weights / Metric Correlations are **done** for single-host (`volume` / `ks2` / `anomaly-rate` / `value`). Remaining work is API alias completeness, deeper alert/function semantics, multi-node weight scope, and optional extra collectors — not missing core system metrics.
**Bottom line:** Every host metric chart PearData defines is collected. Every swagger endpoint required to *discover and scrape those metrics* is implemented on v1/v2/v3 as appropriate. Weights / Metric Correlations and Logs (`/api/v*/logs`) are **done** for single-host. Default REST port is **18888**. Remaining work is API alias completeness, deeper alert/function semantics, multi-node weight scope, and optional extra collectors — not missing core system metrics.