如何获取Istio中Attribute Vocabulary数据及Envoy数据导出原理
Istio 1.7 属性词汇表(Attribute Vocabulary)数据链路与Envoy导出实现说明
基础定义对齐
基于Istio 1.7版本的公开设计文档:每套Istio部署都有其可识别的固定属性词汇表(Attribute Vocabulary),词汇覆盖范围由部署内接入的所有属性生产者共同决定;其中最核心的属性生产者为Envoy,专用Mixer适配器同样可参与属性生成。
本次问题对应的两个核心技术方向:
- 梳理Istio从Envoy、Mixer适配器侧获取属性词汇对应数据的完整实现流程
- 明确Envoy侧导出上述属性数据的具体技术细节
- 问题落地场景:开发日志采集类WASM插件时,可基于明确的属性规则,定义与Istio Telemetry V1日志能力完全对等的自定义日志采集规则
Istio 全链路属性数据获取实现流程
- 启动阶段的属性元信息注册
- Envoy在Sidecar启动流程中,通过内置的Istio网络过滤器,将自身可生成的属性列表、取值来源、数据类型同步上报到Mixer侧的全局属性注册表
- 独立部署的Mixer适配器在服务启动阶段,会严格遵循适配器接口规范,将自身可生成的属性元信息注册到全局属性注册表中,聚合形成当前部署环境下的完整属性词汇表
- 请求流转阶段的属性实时采集与传输
- 所有流经Envoy的入站、出站请求,会在请求处理的各个关键阶段(TCP握手完成、TLS身份校验、HTTP头部解析、路由规则匹配等)实时提取对应属性值
- Envoy会按照Mixer约定的请求属性报文格式,将当前请求关联的属性批量打包,通过gRPC通道发送给Mixer实例
- Mixer接收到属性报文后,会按照预先配置的路由规则,将属性分发到对应的适配器实例,完成策略校验、遥测数据输出等后续流程
- 运行时的衍生属性补全
- 部分无法从Envoy端直接获取的衍生属性,会由Mixer侧基于已收集的原始属性二次计算生成(比如请求来源的服务标签聚合属性、目标服务的所属命名空间属性)
- 补全后的全量属性集会作为所有适配器处理流程的统一输入,保证不同适配器拿到的属性维度完全一致
Envoy侧导出属性的具体技术实现细节
- 核心承载组件
- 所有属性提取逻辑全部封装在Envoy内置的
envoy.filters.network.http_connection_manager关联的Istio专属过滤器中,无独立外置采集组件
- 所有属性提取逻辑全部封装在Envoy内置的
- 可导出属性的取值来源
- 协议层原生字段:包括请求方法、响应码、请求路径、源/目的IP、TLS版本、请求/响应头的键值对内容
- 代理运行时状态:包括请求端到端处理耗时、连接复用状态、请求重试次数、匹配的上游集群名称
- 服务网格元信息:包括从Sidecar本地元数据接口获取的当前服务身份、请求路由匹配的目标服务身份、mTLS校验结果
- 报文传输规范
- 采用Mixer定义的二进制gRPC报文结构,属性以键值对形式存储:键为属性词汇表内的预定义字符串,值支持字符串、数值、时间戳、布尔值等多种数据类型
- 单请求维度的属性会归属于同一次gRPC会话,避免跨请求的属性值混淆
- WASM插件适配参考
- 开发具备同等日志采集能力的WASM插件时,可直接复用上述属性的取值来源规则,无需依赖Mixer组件即可在插件运行时完成同维度的属性提取
- 可直接匹配Telemetry V1版本的日志字段映射逻辑,将提取的属性值按照原有日志模板格式化输出,实现完全对等的采集能力
内容的提问来源于stack exchange,提问作者Seongpyo Hong
相关产品推荐
相关产品推荐

