envoy 中文参考文档
  • 首页
  • 简介
    • Envoy是什么
    • 架构介绍
      • 术语
      • 线程模型
      • 监听器
      • L3/L4网络过滤器
      • HTTP连接管理
      • HTTP过滤器
      • HTTP路由
      • gRPC
      • WebSocket支持
      • 集群管理
      • 服务发现
      • 健康检查
      • 连接池
      • 负载均衡
      • 异常检测
      • 熔断
      • 全局限速
      • TLS
      • 统计
      • 运行时配置
      • 跟踪
      • TCP代理
      • 访问日志
      • MongoDB
      • DynamoDB
      • Redis
      • 热重启
      • 动态配置
      • 初始化
      • 逐出
      • 脚本
    • 部署
    • 业界对比
    • 获得帮助
    • 历史版本
  • 编译安装
    • 编译
    • 参考配置
    • 演示沙箱
      • 前端代理
      • Zipkin跟踪
      • Jaeger跟踪
      • gRPC桥接
      • 构建Envoy Docker镜像
    • 工具
  • 配置参考
    • V1 API 概述
    • V2 API 概述
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP连接管理器
      • 路由匹配
      • 流量转移/分流
      • HTTP头部操作
      • HTTP头部清理
      • 统计
      • 运行时设置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • 故障注入
      • DynamoDB
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • 速率限制
      • 路由
      • Lua
    • 集群管理
      • 统计
      • 运行时设置
      • 集群发现服务
      • 健康检查
      • 熔断
    • 访问日志
    • 限速服务
    • 运行时配置
    • 路由表检查工具
  • 运维管理
    • 命令行选项
    • 热重启
    • 管理接口
    • 统计概述
    • 运行时配置
    • 文件系统
  • 自定义扩展示例
  • V1 API参考
    • 监听器
    • 网络过滤器
      • TLS客户端身份认证
      • Echo
      • HTTP连接管理
      • Mongo代理
      • 速率限制
      • Redis代理
      • TCP代理
    • HTTP路由配置
      • 虚拟主机
      • 路由
      • 虚拟集群
      • 速率限制配置
      • 路由发现服务
    • HTTP过滤器
      • 缓存
      • CORS过滤器
      • DynamoDB
      • 故障注入
      • gRPC HTTP/1.1 桥接
      • gRPC-JSON 转码过滤器
      • gRPC-Web 过滤器
      • 健康检查
      • Lua
      • 速率限制
      • 路由
    • 集群管理
      • 集群
        • 健康检查
        • 熔断
        • TLS上下文
        • 异常值检测
        • HASH环负载均衡配置
      • 异常检测
      • 集群发现服务
      • 服务发现服务
    • 访问日志
    • 管理接口
    • 限速服务
    • 运行时配置
    • 跟踪
  • V2 API参考
    • 启动引导
    • 监听&监听发现
    • 集群&集群发现
    • 服务发现
    • 健康检查
    • HTTP路由管理&发现
    • TLS配置
    • 通用的类型
    • 网络地址
    • 协议选项
    • 发现API
    • 限速组件
    • 过滤器
      • 网络过滤器
        • TLS客户端身份认证
        • HTTP连接管理
        • Mongo代理
        • 速率限制
        • Redis代理
        • TCP代理
      • HTTP过滤器
        • 缓存
        • 故障注入
        • 健康检查
        • Lua
        • 速率限制
        • 路由
        • gRPC-JSON转码器
      • 常见访问日志类型
      • 常见故障注入类型
  • FAQ
    • Envoy有多快?
    • 我在哪里获得二进制文件?
    • 我如何设置SNI?
    • 如何设置区域感知路由?
    • 我如何设置Zipkin跟踪?
Powered by GitBook
On this page
  • 服务发现
  • LbEndpoint
  • LocalityLbEndpoints
  • ClusterLoadAssignment
  • ClusterLoadAssignment.Policy
  • 返回

Was this helpful?

  1. V2 API参考

服务发现

Previous集群&集群发现Next健康检查

Last updated 5 years ago

Was this helpful?

服务发现

LbEndpoint

EndPoint是指Envoy可以将流量路由到的端口。

{
  "endpoint": "{...}",
  "metadata": "{...}",
  "load_balancing_weight": "{...}"
}
  • endpoint () 上游主机标识符

  • metadata () 负载均衡端口元数据是指可用于为请求选择群集中的端口。过滤器名称应该指定为envoy.lb。一个bool类型的键值对例子为canary,提供上游主机的可选canary状态。这可以在路由的ForwardAction metadata_match字段中匹配,以在集群负载平衡中考虑的端口子集。

  • load_balancing_weight () 上游主机的可选负载平衡权重,范围为1~128. 在某些内置Envoy负载平衡器中,会使用负载平衡权重。端口的负载平衡权重除以本地所有端口权重的总和,以获得端口的所占通信量百分比。然后这个百分比再由来自LocalityLbEndpoints的端点的本地负载平衡权重加权。如果没有指定,每个主机被假定在一个地方具有相同的权重。

    注意:当前128的限制是有些随意,但是考虑当前实现的性能问题而使用,若解决这个问题是可以取消这个限制。

LocalityLbEndpoints

一组端口归属一个局部负载均衡器。一个本地可以有多个局部负载均衡器,通常只有在不同的组之间需要负载平衡权重或不同的优先级时,才会使用多个组。

{
  "locality": "{...}",
  "lb_endpoints": [],
  "load_balancing_weight": "{...}",
  "priority": "..."
}
  • 必须为相同优先级的所有局部端口组指定权重,若不指定,则认为每个局部在群集中具有相同的权重。

    注意:当前128的限制是有些随意,但是考虑当前实现的性能问题而使用,若解决这个问题是可以取消这个限制。

  • 一般情况下,Envoy只会选择最高优先级(0)的端口。如果该优先级的所有端口不可用/不健康,Envoy将快速故障恢复至下一个最高优先级的端口组。

    优先级应该配置为从0(最高)到N(最低),中间没有间隔。

ClusterLoadAssignment

从RDS中获取的路由,映射到单个集群或者使用RDS集群权重实现跨集群的流量拆分。

使用EDS,每个集群都有独立的LB进行处理,将在集群内的产生局部LB,即在一个局部主机之间具有更细粒度的LB。对于给定的集群,主机的有效权重是其load_balancing_weight乘以其局部的LB权重load_balancing_weight。

{
  "cluster_name": "...",
  "endpoints": [],
  "policy": "{...}"
}

ClusterLoadAssignment.Policy

负载平衡策略设置。

{
  "drop_overload": "..."
}
  • 注意:v2 API与v1 API存在差异,在v1中被称为维护模式。

返回

locality () 标识上游主机运行的位置。

lb_endpoints () 所属的端口组配置。

load_balancing_weight () 可选:配置每个端口组的优先级、region、zone、sub_zone权重,范围1~128。一个端口组的负载均衡权重除以相同优先级的所有权重之和,获得该端口组的承载业务有效百分比。

priority () 可选:此局部负载均衡端口组的优先级。如果未指定,则默认为最高优先级(0)。

cluster_name (, REQUIRED) 集群的名称。如果在集群中指定,则是service_name值。

endpoints () 对应的局部端口组列表。

policy () 负载均衡策略设置。

drop_overload () 应该丢弃的流量(0-100)的百分比。如果上游主机无法从down机中恢复,或者无法进行自动调整,则需要对上游主机进行保护,因此需要修整整个传入流量以保护它们。

LocalityLbEndpoints proto
Locality
UInt32Value
uint32
ClusterLoadAssignment proto
string
EdsClusterConfig
ClusterLoadAssignment.Policy proto
double
上一级
首页目录
LbEndpoint proto
Endpoint
Metadata
UInt32Value
LbEndpoint
LocalityLbEndpoints
ClusterLoadAssignment
ClusterLoadAssignment.Policy
LbEndpoint
LocalityLbEndpoints
ClusterLoadAssignment.Policy