Initial commit

reference/goedge 文档/NodeValueService.md

@@ -0,0 +1,122 @@
+# NodeValueService
+> 节点指标数据服务
+
+---
+
+## createNodeValue
+> 记录数据
+
+- 角色：`dns`, `user`, `node`
+- HTTP：`POST https://backend.dooki.cloud/NodeValueService/createNodeValue`
+- RPC：`rpc createNodeValue (CreateNodeValueRequest) returns (RPCSuccess);`
+
+**请求对象 (`CreateNodeValueRequest`)**
+
+```json
+{
+  "item": "string",
+  "valueJSON": "bytes",
+  "createdAt": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeValueService/createNodeValue" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## listNodeValues
+> 读取数据
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeValueService/listNodeValues`
+- RPC：`rpc listNodeValues (ListNodeValuesRequest) returns (ListNodeValuesResponse);`
+
+**请求对象 (`ListNodeValuesRequest`)**
+
+```json
+{
+  "role": "string",
+  "nodeId": "int64 // 节点ID",
+  "item": "string",
+  "range": "string"
+}
+```
+
+**响应对象 (`ListNodeValuesResponse`)**
+
+```json
+{
+  "nodeValues": "[]NodeValue"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeValueService/listNodeValues" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## sumAllNodeValueStats
+> 读取所有节点的最新数据
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeValueService/sumAllNodeValueStats`
+- RPC：`rpc sumAllNodeValueStats(SumAllNodeValueStatsRequest) returns (SumAllNodeValueStatsResponse);`
+
+**请求对象 (`SumAllNodeValueStatsRequest`)**
+
+```json
+{}
+```
+
+**响应对象 (`SumAllNodeValueStatsResponse`)**
+
+```json
+{
+  "totalTrafficBytesPerSecond": "int64",
+  "avgCPUUsage": "float",
+  "maxCPUUsage": "float",
+  "totalCPUCores": "int32",
+  "avgMemoryUsage": "float",
+  "maxMemoryUsage": "float",
+  "totalMemoryBytes": "int64",
+  "avgLoad1min": "float",
+  "maxLoad1min": "float",
+  "avgLoad5min": "float"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeValueService/sumAllNodeValueStats" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---