feat: v0.34 健康探针(Architecture B) + Agent v2.1 + 端口监控 + 告警联系人重构

- v0.31: AlertContact 重构(channel_type下拉+webhook_url替代三分立字段) - v0.32: Agent ProcessTop 增强(cmdline/user/cpu_pct/mem_pct) - v0.33: 端口监控 Tab(监听端口自动发现+down联动告警) - v0.34: 健康探针(Agent本地执行HTTP/TCP/Exec→结果随心跳上报) - Agent新增: ContextSwitch/FD/HealthProbe采集器 - 后端新增: health_probe handler + Agent model扩展 - HostMonitor新增Tab: 健康探针/端口监控
2026-06-24 19:18:10 +08:00
1 parent e1f75f0bc4
commit d656520428
@@ -1,149 +1,76 @@
-// Package task 的 client.go 实现与后端任务接口的 HTTP 交互。
-// 涵盖拉取待执行任务（poll）与回传执行结果（submit result）。
-// 仅依赖 Go 标准库，失败时返回错误，由调用方决定重试策略。
+// Package task 的 client.go 实现与后端任务/探针接口的 HTTP 交互。
+// 涵盖拉取待执行任务（poll）、回传执行结果（submit result）、拉取探针配置（poll probes）。
+// 通过共享 client 处理鉴权 + 重试，本文件仅负责业务路径和数据模型。
 //
 // 署名 Logan.Li
 package task

 import (
-	"bytes"
 	"context"
-	"encoding/json"
 	"fmt"
-	"io"
 	"log"
-	"net/http"
 	"net/url"
-	"strings"
-	"time"
+
+	"ezops/agent/client"
+	"ezops/agent/model"
 )

 const (
-	pollPath        = "/api/v1/agent/tasks/poll"      // 任务轮询接口
-	resultPathFmt   = "/api/v1/agent/tasks/%s/result" // 结果回传接口（含 task_id 占位）
-	httpTimeout     = 10 * time.Second                // 单次 HTTP 请求超时
-	clientUserAgent = "aiops-agent/1.0"               // 标识 Agent 版本
+	pollPath       = "/api/v1/agent/tasks/poll"
+	resultPathFmt  = "/api/v1/agent/tasks/%s/result"
+	probePath      = "/api/v1/agent/health-probes/config"
 )

-// Client 负责与后端任务接口通信。
+// Client 负责与后端任务/探针接口通信。
 type Client struct {
-	server     string
-	token      string
-	hostname   string
-	httpClient *http.Client
-	logger     *log.Logger
+	client   *client.Client
+	hostname string
+	logger   *log.Logger
 }

 // NewClient 创建任务客户端实例。
-//   - server:   AIOps 后端地址（如 http://localhost:8080）
-//   - token:    Bearer 认证令牌
-//   - hostname: 本机主机名，用于后端筛选该主机待执行的任务
-func NewClient(server, token, hostname string, logger *log.Logger) *Client {
-	return &Client{
-		server:     strings.TrimRight(server, "/"),
-		token:      token,
-		hostname:   hostname,
-		httpClient: &http.Client{Timeout: httpTimeout},
-		logger:     logger,
-	}
+func NewClient(cli *client.Client, hostname string, logger *log.Logger) *Client {
+	return &Client{client: cli, hostname: hostname, logger: logger}
 }

 // Poll 拉取当前主机待执行的任务列表。
-// 返回空切片表示暂无任务（后端返回空数组或 HTTP 204）。
 func (c *Client) Poll(ctx context.Context) ([]Task, error) {
-	// 构造带 hostname 查询参数的 URL
-	u := c.server + pollPath + "?hostname=" + url.QueryEscape(c.hostname)
-
-	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u, nil)
-	if err != nil {
-		return nil, fmt.Errorf("构造轮询请求失败: %w", err)
-	}
-	c.attachHeaders(req)
-
-	// 上下文已取消则直接返回，避免无意义请求
-	if err := ctx.Err(); err != nil {
-		return nil, err
-	}
-
-	resp, err := c.httpClient.Do(req)
-	if err != nil {
-		return nil, fmt.Errorf("轮询请求失败: %w", err)
-	}
-	defer resp.Body.Close()
-
-	// 204 No Content 或 200 空体均视为无任务
-	if resp.StatusCode == http.StatusNoContent {
-		return nil, nil
-	}
-	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
-		body, _ := io.ReadAll(io.LimitReader(resp.Body, 512))
-		return nil, fmt.Errorf("轮询响应异常: HTTP %d, body=%s", resp.StatusCode, string(body))
-	}
-
-	body, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return nil, fmt.Errorf("读取轮询响应失败: %w", err)
-	}
-
-	// 空响应体视为无任务
-	if len(bytes.TrimSpace(body)) == 0 {
-		return nil, nil
-	}
+	path := pollPath + "?hostname=" + url.QueryEscape(c.hostname)

 	var wrapper struct {
 		Code    int    `json:"code"`
 		Message string `json:"message"`
 		Data    []Task `json:"data"`
 	}
-	if err := json.Unmarshal(body, &wrapper); err != nil {
-		// 兼容裸数组格式
-		var tasks []Task
-		if err2 := json.Unmarshal(body, &tasks); err2 != nil {
-			return nil, fmt.Errorf("解析轮询响应失败: %w", err)
-		}
-		return tasks, nil
+	if err := c.client.DoJSON(ctx, "GET", path, nil, &wrapper); err != nil {
+		return nil, fmt.Errorf("任务轮询失败: %w", err)
 	}
 	return wrapper.Data, nil
 }

 // Submit 将任务执行结果回传至后端。
 func (c *Client) Submit(ctx context.Context, res Result) error {
-	payload, err := json.Marshal(res)
-	if err != nil {
-		return fmt.Errorf("序列化任务结果失败: %w", err)
-	}
-
-	u := c.server + fmt.Sprintf(resultPathFmt, url.PathEscape(res.TaskID))
-
-	req, err := http.NewRequestWithContext(ctx, http.MethodPost, u, bytes.NewReader(payload))
-	if err != nil {
-		return fmt.Errorf("构造回传请求失败: %w", err)
-	}
-	c.attachHeaders(req)
-
-	if err := ctx.Err(); err != nil {
-		return err
-	}
-
-	resp, err := c.httpClient.Do(req)
-	if err != nil {
-		return fmt.Errorf("回传请求失败: %w", err)
-	}
-	defer resp.Body.Close()
-	io.Copy(io.Discard, resp.Body)
-
-	if resp.StatusCode < 200 || resp.StatusCode >= 300 {
-		return fmt.Errorf("回传响应异常: HTTP %d", resp.StatusCode)
+	path := fmt.Sprintf(resultPathFmt, url.PathEscape(res.TaskID))
+	if err := c.client.DoJSON(ctx, "POST", path, res, nil); err != nil {
+		return fmt.Errorf("任务结果回传失败: %w", err)
 	}
 	return nil
 }

-// attachHeaders 统一设置公共请求头（鉴权、内容类型、UA）。
-func (c *Client) attachHeaders(req *http.Request) {
-	req.Header.Set("Content-Type", "application/json")
-	req.Header.Set("Accept", "application/json")
-	req.Header.Set("User-Agent", clientUserAgent)
-	if c.token != "" {
-		req.Header.Set("Authorization", "Bearer "+c.token)
+// PollProbes 拉取本机健康探针配置（v2.1）。
+func (c *Client) PollProbes(ctx context.Context) ([]model.ProbeConfig, error) {
+	path := probePath + "?hostname=" + url.QueryEscape(c.hostname)
+
+	var wrapper struct {
+		Code    int                `json:"code"`
+		Message string             `json:"message"`
+		Data    []model.ProbeConfig `json:"data"`
 	}
+	if err := c.client.DoJSON(ctx, "GET", path, nil, &wrapper); err != nil {
+		return nil, fmt.Errorf("探针配置拉取失败: %w", err)
+	}
+	if wrapper.Data == nil {
+		return []model.ProbeConfig{}, nil
+	}
+	return wrapper.Data, nil
 }