Skip to content

c1982/redis-traffic-stats

Repository files navigation

redis-traffic-stats

redis-traffic-stats is a live monitor and analyze RESP packets in your server. This tool does not touch Redis Server. Just monitors redis client request and response on the real time.

All redis stats exported as prometheus metrics so you can visualize analytics data on your favorite dashboard (like grafana).

Features:

  • Live Monitoring
  • Low CPU utilization
  • Prometheus Exporter
  • Basic-Auth protection
  • Top commands of count
  • Top command and keys count
  • No dependencies
  • No Redis performance degradation

Tasks:

  • Count commands and arguments
  • Count network traffic of command
  • Monitor Slow commands
  • Monitor big response

Installation

Usage

./redis-traffic-stats --interface=ens5 --addr=:9200 \
--password=pass \
--debug=false \
-s=: \
-r="[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}" \
--redisport=6379 \
--max=150 \
--slow-response-threshold=20ms
--snaplen=50000
Flag Default Usage
debug false Enable debug logs
interface empty Ethernet infreface name. eth0, ens5
redisport 6379 Redis server port number
addr :9200 http listener port for prometheus metrics
username admin Prometheus metrics username
password **** Prometheus metrics password
s empty Separator of keys (for split). If it empty does not split keys.
r empty Regex pattern of keys (for clean)
max 150 Maximum lookup size of key. If value -1 unlimited lookup.
slow-response-threshold 500 threshold for recording slow response. Millisecond
big-response-threshold 1500 threshold for recording slow response. Bytes
snap 2048 the maximum size to read for each packet (snaplen)

Grafana Dashboard

This easy way for dasboarding. You can upload to grafana this file.

Run test environment

docker-compose up

garafana:

http://localhost:3000/

prometheus:

http://localhost:9090/

Static Compilation

This tool require libpcap library (https://www.tcpdump.org/). You can embed dependencies on the compilation process. This helps for portability. Check the build command below

LDFLAGS='-l/usr/lib/libpcap.a' CGO_ENABLED=1 go build -ldflags '-linkmode external -extldflags -static' .

Troubleshooting

If you get an error about libpcap like below

./redis-traffic-stats: error while loading shared libraries: libpcap.so.0.8: cannot open shared object file: No such file or directory

install libpcap

for centos

yum install libpcap-devel

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Oğuzhan YILMAZ - @c1982 - [email protected]