节点接入
节点注册、认证、UUID 和流量上报。
获取节点接入授权码
供受信任的日志或节点集成组件读取主控配置中的节点接入授权码。接口不使用用户登录认证,而是要求请求头携带日志服务共享密钥;此接口返回敏感值,不应向浏览器、普通客户端或非受信任网络暴露。
转发请求到已连接的节点 Agent
将请求体和查询参数转发给已连接的节点 Agent,并等待该 Agent 的回调结果。调用方必须提供日志服务密钥、目标节点和事件名称;请求体会按原始字节读取后进行 Base64 编码再转发。
上报新接入节点
供 Agent 在接入主控时上报节点 UUID 的系统集成接口。接口使用 `es-pwd` 请求头校验,不使用用户登录令牌;节点 IP 由服务端从请求来源获取,不读取请求体。若 UUID 或来源 IP 已匹配既有节点,会创建节点差量同步和全局配置同步任务;否则新增或更新待接入节点记录。
查询节点流量趋势
查询指定节点在时间范围内的发送和接收流量,需要登录用户身份。开始时间包含在范围内,结束时间不包含在范围内;跨度不超过 24 小时时返回 5 分钟原始记录,超过 24 小时按小时聚合,超过 7 天按天聚合。
上报节点流量
供节点或受控采集程序批量上报网卡流量的系统集成接口。接口通过 `es-pwd` 请求头校验,不使用用户登录令牌;每条记录以当前服务端时间写入。请求体必须是非空数组。
查询待接入节点
分页查询待初始化节点。默认第 1 页、每页 10 条;`limit=0` 时返回全部记录。响应中的 `count` 是待初始化节点总数。业务参数错误仍返回 HTTP 200,请依据 `code` 判断结果。
待初始化节点 POST 未实现
虽然路由注册了 POST 方法,但 PendingNodeAPI 没有实现 post 方法。当前 Python 主控会由 Flask 返回 HTTP 405 Method Not Allowed;此接口不接受请求参数或请求体,不能用于创建或执行待初始化节点。
删除待初始化节点
删除一个或多个待初始化节点。路径参数可使用英文逗号分隔多个节点 ID。每个 ID 必须为数字且必须存在;业务校验失败仍返回 HTTP 200,请依据响应中的 `code` 和 `msg` 判断结果。
上报节点 UUID
节点与主控之间的系统集成接口。使用 `es-pwd` 校验内部日志密码后,将指定节点的 UUID 写入节点记录。该接口返回纯文本,不使用标准 JSON 响应封装。