Predixy 中文版

Predixy is a high performance and fully featured proxy for redis sentinel and redis cluster

Features

• High performance and lightweight.
• Multi-threads support.
• Works on Linux, OSX, BSD, Windows(Cygwin).
• Supports Redis Sentinel, single/multi redis group[s].
• Supports Redis Cluster.
• Supports redis block command, eg:blpop, brpop, brpoplpush.
• Supports scan command, even multi redis instances.
• Multi-keys command support: mset/msetnx/mget/del/unlink/touch/exists.
• Multi-databases support, means redis command select is avaliable.
• Supports redis transaction, limit in Redis Sentinel single redis group.
• Supports redis Scripts, script load, eval, evalsha.
• Supports redis Pub/Sub.
• Multi-DataCenters support, read from slaves.
• Extend AUTH, readonly/readwrite/admin permission, keyspace limit.
• Log level sample, async log record.
• Log file auto rotate by time and/or file size.
• Stats info, CPU/Memory/Requests/Responses and so on.
• Latency monitor.

Build

Predixy can be compiled and used on Linux, OSX, BSD, Windows(Cygwin). Requires C++11 compiler.

It is as simple as:

$ make

To build in debug mode:

$ make debug

Some other build options:

• CXX=c++compiler, default is g++, you can specify other, eg:CXX=clang++
• EV=epoll|poll|kqueue, default it is auto detect according by platform.
• MT=false, disable multi-threads support.
• TS=true, enable predixy function call time stats, debug only for developer.

For examples:

$ make CXX=clang++
$ make EV=poll
$ make MT=false
$ make debug MT=false TS=true

Install

Just copy src/predixy to the install path

$ cp src/predixy /path/to/bin

Configuration

See below files:

• predixy.conf, basic config, will refrence below config files.
• cluster.conf, Redis Cluster backend config.
• sentinel.conf, Redis Sentinel backend config.
• auth.conf, authority control config.
• dc.conf, multi-datacenters config.
• latency.conf, latency monitor config.

Running

$ src/predixy conf/predixy.conf

With default predixy.conf, Predixy will listen at 0.0.0.0:7617 and proxy to Redis Cluster 127.0.0.1:6379. In general, 127.0.0.1:6379 is not running in Redis Cluster mode. So you will look mass log output, but you can still test it with redis-cli.

$ redis-cli -p 7617 info

More command line arguments:

$ src/predixy -h

Testing

Run all tests using the Makefile target:

$ make test

This will automatically start predixy, run the test suite, and stop predixy when done. The tests use uv for dependency management to ensure consistent Python and package versions across environments.

Stats

Like redis, predixy use INFO command to give stats.

Show predixy running info and latency monitors

redis> INFO

Show latency monitors by latency name

redis> INFO Latency <latency-name>

A latency monitor example:

LatencyMonitorName:all
            latency(us)   sum(us)           counts
<=          100              3769836            91339 91.34%
<=          200               777185             5900 97.24%
<=          300               287565             1181 98.42%
<=          400               185891              537 98.96%
<=          500               132773              299 99.26%
<=          600                85050              156 99.41%
<=          700                85455              133 99.54%
<=          800                40088               54 99.60%
<=         1000                67788               77 99.68%
>          1000               601012              325 100.00%
T            60              6032643           100001
The last line is total summary, 60 is average latency(us)

Show latency monitors by server address and latency name

redis> INFO ServerLatency <server-address> [latency-name]

Reset all stats and latency monitors, require admin permission.

redis> CONFIG ResetStat

Benchmark

predixy is fast, how fast? more than twemproxy, codis, redis-cerberus

See wiki benchmark

License

Copyright (C) 2017 Joyield, Inc. <joyield.com#gmail.com>

All rights reserved.

License under BSD 3-clause "New" or "Revised" License

WeChat:cppfan