Skip to content

Commit

Permalink
feat: add configer provider info report interface
Browse files Browse the repository at this point in the history
  • Loading branch information
bilosikia committed Nov 11, 2024
1 parent fd95ac6 commit c906d7f
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 3 deletions.
7 changes: 5 additions & 2 deletions config_server/protocol/v2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,11 +233,14 @@ Server:返回FetchPipelineConfigResponse
![image](https://github.com/alibaba/ilogtail/assets/1827594/c409c35c-2a81-4927-bfd2-7fb321ef1ca8)

### 配置状态上报

Client:这个版本的配置状态上报中修改了version的定义,-1仍然表示删除,0作为保留值,其他值都是合法version,只要version不同Client都应该视为配置更新。此外参考OpAMP增加了配置应用状态上报的字段,能反应出下发的配置是否生效。

Server:这些信息是Agent状态的一部分,可选保存。与通过Event上报可观测信息不同的是,作为状态信息没有时间属性,用户可通过接口可获取即刻状态,而不需要选择时间窗口合并事件。

上报配置状态支持两种方式:
1. 在心跳 request 中将配置最新状态带上。适合不区分全量/非全量心跳的实现,和 configer server 心跳/流水线不拆分的实现。
2. 通过 ReportConfigRequest 接口上报。适合对状态更新实时性要求比较高,心跳/流水线拆分的实现。

### 预定义命令

Client: 通过request的flag传递,定义了FullStatus,表明本条信息为全量状态
Expand All @@ -259,4 +262,4 @@ Client: 当HeartbeatResponse中的code为0时,Agent应该正常处理下发的
### 辅助信息
在command\_info, command\_detail, config\_info, config\_detail中,都预留了extra字段,可以用于传递一些额外的用户自定义的辅助信息。\

注意:extra字段仅作传递辅助信息使用,不会对管控行为造成任何影响。
注意:extra字段仅作传递辅助信息使用,不会对管控行为造成任何影响。
17 changes: 16 additions & 1 deletion config_server/protocol/v2/agentV2.proto
Original file line number Diff line number Diff line change
Expand Up @@ -166,8 +166,23 @@ message FetchConfigResponse {
repeated ConfigDetail config_details = 3; // config detail
}

// API: /Agent/ReportPipelineConfig/
// API: /Agent/ReportInstanceConfig/
// Agent request to ConfigServer, report status of the config
message ReportConfigRequest {
bytes request_id = 1;
bytes instance_id = 2; // Agent's unique identification
repeated ConfigInfo config_infos = 3; // Config status info
}

// ConfigServer response to Agent's request
message ReportConfigResponse {
bytes request_id = 1;
CommonResponse commonResponse = 2;
}

message CommonResponse
{
int32 status = 1;
bytes errorMessage = 2;
}
}

0 comments on commit c906d7f

Please sign in to comment.