## Redis
Envoy可以做為Redis代理,在集群中的實例之間對命令進行分區。在這種模式下,Envoy的目標是保持可用性和分區容錯的一致性。將Envoy與Redis集群進行比較時,這是重點。Envoy的緩存設計的不足夠強大,這意味著它不會嘗試協調不一致的數據,無法保持全局一致的群集成員關系視圖。
Redis項目提供了與Redis相關的分區的全面參考。請參閱“[分區](https://redis.io/topics/partitioning):如何在多個Redis實例之間分割數據”。
**Envoy Redis的特點**:
- [Redis協議](https://redis.io/topics/protocol)編解碼
- 基于Hash散列的分區
- Ketama發行
- 詳細的命令統計
- 主動和被動健康檢查
**未來計劃增強特性**:
- 補充時間統計
- 斷路
- 請求分散命令
- 復制
- 內置重試
- 跟蹤
- 哈希標記
### 配置
有關過濾器配置的詳細信息,請參閱[Redis代理過濾器](../../Configurationreference/Networkfilters/Redisproxy.md)配置參考。
配置相應集群所定義的[Hash環負載平衡](../../v1APIreference/Clustermanager/Cluster.md)。
如果需要進行主動健康檢查,則應該對群集使用[Redis健康檢查](../../Configurationreference/Clustermanager/Healthchecking.md)配置。
如果需要被動健康檢查,還要配置[異常檢測](../../v1APIreference/Clustermanager/Cluster.md)。
為了進行被動健康檢查,將超時,命令超時和連接關閉映射連接到5xx。來自Redis的所有其他響應被視為成功。
### 支持的命令
在協議級別,支持管道。不是MULTI(事務塊)。盡可能使用流水線來獲得最佳性能。
在命令級別,Envoy僅支持可靠地散列到服務器的命令。因此,所有支持的命令都包含一個key。受支持的命令在功能上與原始Redis命令相同,除非可能出現故障。
有關每個命令用法的詳細信息,請參閱官方的[Redis命令參考](https://redis.io/commands)。
| 命令 | 組 |
| :------- | :------- |
| DEL | Generic |
| DUMP | Generic |
| EXISTS | Generic |
| EXPIRE | Generic |
| EXPIREAT | Generic |
| PERSIST | Generic |
| PEXPIRE | Generic |
| PEXPIREAT | Generic |
| PTTL | Generic |
| RESTORE | Generic |
| TOUCH | Generic |
| TTL | Generic |
| TYPE | Generic |
| UNLINK | Generic |
| GEOADD | Geo |
| GEODIST | Geo |
| GEOHASH | Geo |
| GEOPOS | Geo |
| HDEL | Hash |
| HEXISTS | Hash |
| HGET | Hash |
| HGETALL | Hash |
| HINCRBY | Hash |
| HINCRBYFLOAT | Hash |
| HKEYS | Hash |
| HLEN | Hash |
| HMGET | Hash |
| HMSET | Hash |
| HSCAN | Hash |
| HSET | Hash |
| HSETNX | Hash |
| HSTRLEN | Hash |
| HVALS | Hash |
| LINDEX | List |
| LINSERT | List |
| LLEN | List |
| LPOP | List |
| LPUSH | List |
| LPUSHX | List |
| LRANGE | List |
| LREM | List |
| LSET | List |
| LTRIM | List |
| RPOP | List |
| RPUSH | List |
| RPUSHX | List |
| EVAL | Scripting |
| EVALSHA | Scripting |
| SADD | Set |
| SCARD | Set |
| SISMEMBER | Set |
| SMEMBERS | Set |
| SPOP | Set |
| SRANDMEMBER | Set |
| SREM | Set |
| SSCAN | Set |
| ZADD | Sorted Set |
| ZCARD | Sorted Set |
| ZCOUNT | Sorted Set |
| ZINCRBY | Sorted Set |
| ZLEXCOUNT | Sorted Set |
| ZRANGE | Sorted Set |
| ZRANGEBYLEX | Sorted Set |
| ZRANGEBYSCORE | Sorted Set |
| ZRANK | Sorted Set |
| ZREM | Sorted Set |
| ZREMRANGEBYLEX | Sorted Set |
| ZREMRANGEBYRANK | Sorted Set |
| ZREMRANGEBYSCORE | Sorted Set |
| ZREVRANGE | Sorted Set |
| ZREVRANGEBYLEX | Sorted Set |
| ZREVRANGEBYSCORE | Sorted Set |
| ZREVRANK | Sorted Set |
| ZSCAN | Sorted Set |
| ZSCORE | Sorted Set |
| APPEND | String |
| BITCOUNT | String |
| BITFIELD | String |
| BITPOS | String |
| DECR | String |
| DECRBY | String |
| GET | String |
| GETBIT | String |
| GETRANGE | String |
| GETSET | String |
| INCR | String |
| INCRBY | String |
| INCRBYFLOAT | String |
| MGET | String |
| MSET | String |
| PSETEX | String |
| SET | String |
| SETBIT | String |
| SETEX | String |
| SETNX | String |
| SETRANGE | String |
| STRLEN | String |
### 失敗模型
如果Redis拋出一個錯誤,我們把這個錯誤作為響應傳遞給這個命令。 Envoy將錯誤數據類型的Redis響應視為正常響應,并將其傳遞給調用者。
Envoy也可以產生自己的錯誤來回應客戶。
| 錯誤 | 含義 |
| :------- | :------- |
| no upstream host | 哈希環負載均衡器在為Key選擇的環位置上沒有可用的主機。 |
| upstream failure | 后端在超時期限內沒有響應或關閉連接。 |
| invalid request | 命令由于數據類型或長度而被命令拆分器的第一階段拒絕。 |
| unsupported command | 該命令不被Envoy識別,因此不能被服務,因為它不能被散列到后端服務器。 |
| finished with n errors | 對響應進行求和的分段命令(例如,DEL)將返回接收到的錯誤的總數。 |
| upstream protocol error | 碎片命令接收到意外的數據類型或后端以不符合Redis協議的響應進行響應。 |
| wrong number of arguments for command | 特定的命令檢查Envoy參數的數量是正確的。 |
在MGET的情況下,無法提取單獨Key所產生錯誤響應。例如,如果我們獲取五個Keys和兩個Keys的后端超時,我們會得到一個錯誤的響應代替每個值。
```
$ redis-cli MGET a b c d e
1) "alpha"
2) "bravo"
3) (error) upstream failure
4) (error) upstream failure
5) "echo"
```
### 返回
- [架構介紹](../Architectureoverview.md)
- [簡介](../../Introduction.md)
- [首頁目錄](../../README.md)
- 首頁
- 簡介
- 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跟蹤?