rebuild platform metrics

Author: root

Note.md

@@ -150,4 +150,8 @@ ports tab 不稳定，经常打开显示  somethins wrong
 addons 的 netdata restart 报错
 Server Terminal  退出连接后再重连，就会失败
 
-crontab list 保存不住
+crontab list 保存不住
+
+去掉所有与 docker.sock 的强依赖与硬编码
+
+平台metrics 的读取查询与对服务器 metrics 的查询，是不是后端代码应该分离

backend/docs/openapi/api.yaml

@@ -331,6 +331,25 @@ components:
                 message:
                     type: string
             type: object
+        MonitorMetricLatestResponse:
+            properties:
+                availableNetworkInterfaces:
+                    items:
+                        type: string
+                    type: array
+                cadenceSeconds:
+                    type: integer
+                selectedNetworkInterface:
+                    type: string
+                series:
+                    items:
+                        $ref: '#/components/schemas/MonitorMetricSeries'
+                    type: array
+                targetId:
+                    type: string
+                targetType:
+                    type: string
+            type: object
         MonitorMetricSeriesResponse:
             properties:
                 availableNetworkInterfaces:
@@ -5958,6 +5977,71 @@ paths:
             summary: Get monitor target status
             tags:
                 - Monitoring
+    /api/monitor/targets/{targetType}/{targetId}/latest:
+        get:
+            description: Returns the most recent observed metric point for a monitor target at the managed-agent collection cadence. targetType accepts server, app, container, or platform. series accepts cpu, memory, disk, disk_usage, network, or network_traffic depending on target type.
+            operationId: get_api_monitor_targets_targettype_targetid_latest
+            parameters:
+                - description: monitor target type
+                  in: path
+                  name: targetType
+                  required: true
+                  schema:
+                    enum:
+                        - server
+                        - app
+                        - container
+                        - platform
+                    type: string
+                - description: monitor target ID; platform uses appos-core for AppOS host metrics
+                  in: path
+                  name: targetId
+                  required: true
+                  schema:
+                    type: string
+                - description: network interface for network series; use all or omit for aggregate
+                  in: query
+                  name: networkInterface
+                  required: false
+                  schema:
+                    type: string
+                - description: metric series alias
+                  in: query
+                  name: series
+                  required: false
+                  schema:
+                    enum:
+                        - cpu
+                        - memory
+                        - disk
+                        - disk_usage
+                        - network
+                        - network_traffic
+                    type: string
+            responses:
+                "200":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/MonitorMetricLatestResponse'
+                    description: OK
+                "400":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/MonitorErrorResponse'
+                    description: Bad Request
+                "401":
+                    content:
+                        application/json:
+                            schema:
+                                $ref: '#/components/schemas/MonitorErrorResponse'
+                    description: Unauthorized
+            security:
+                - bearerAuth: []
+            summary: Get latest monitor target metrics
+            tags:
+                - Monitoring
     /api/monitor/targets/{targetType}/{targetId}/series:
         get:
             description: Returns metric series for a monitor target. targetType accepts server, app, container, or platform. series accepts cpu, memory, disk, disk_usage, network, or network_traffic depending on target type. Use startAt and endAt together for a custom RFC3339 range.

backend/docs/openapi/ext-api.yaml

@@ -127,6 +127,25 @@ components:
           type: string
         maxBytes:
           type: integer
+    MonitorMetricLatestResponse:
+      type: object
+      properties:
+        targetType:
+          type: string
+        targetId:
+          type: string
+        cadenceSeconds:
+          type: integer
+        series:
+          type: array
+          items:
+            $ref: '#/components/schemas/MonitorMetricSeries'
+        availableNetworkInterfaces:
+          type: array
+          items:
+            type: string
+        selectedNetworkInterface:
+          type: string
     MonitorMetricSeriesResponse:
       type: object
       properties:
@@ -4440,6 +4459,70 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/MonitorErrorResponse'
+  /api/monitor/targets/{targetType}/{targetId}/latest:
+    get:
+      tags: [Monitoring]
+      summary: Get latest monitor target metrics
+      description: "Returns the most recent observed metric point for a monitor target at the managed-agent collection cadence. targetType accepts server, app, container, or platform. series accepts cpu, memory, disk, disk_usage, network, or network_traffic depending on target type."
+      operationId: get_api_monitor_targets_targettype_targetid_latest
+      parameters:
+        - name: targetType
+          in: path
+          description: "monitor target type"
+          required: true
+          schema:
+            type: string
+            enum:
+              - "server"
+              - "app"
+              - "container"
+              - "platform"
+        - name: targetId
+          in: path
+          description: "monitor target ID; platform uses appos-core for AppOS host metrics"
+          required: true
+          schema:
+            type: string
+        - name: networkInterface
+          in: query
+          description: "network interface for network series; use all or omit for aggregate"
+          required: false
+          schema:
+            type: string
+        - name: series
+          in: query
+          description: "metric series alias"
+          required: false
+          schema:
+            type: string
+            enum:
+              - "cpu"
+              - "memory"
+              - "disk"
+              - "disk_usage"
+              - "network"
+              - "network_traffic"
+      security:
+        - bearerAuth: []
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MonitorMetricLatestResponse'
+        "401":
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MonitorErrorResponse'
+        "400":
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MonitorErrorResponse'
   /api/monitor/targets/{targetType}/{targetId}/series:
     get:
       tags: [Monitoring]

backend/docs/openapi/group-matrix.yaml

@@ -410,6 +410,7 @@ groups:
       - GET /api/monitor/overview
       - GET /api/monitor/servers/{id}/container-telemetry
       - GET /api/monitor/targets/{targetType}/{targetId}
+      - GET /api/monitor/targets/{targetType}/{targetId}/latest
       - GET /api/monitor/targets/{targetType}/{targetId}/series
     nativeSurface: []
     sources: