mirror of
https://github.com/hanzokv/go.git
synced 2026-09-24 00:31:51 +00:00
zeekay
6994cf05aa
We do not use Redis. The client was a go-redis fork and still said so
everywhere: `package redis`, `redis.NewClient`, `redis://`, `extra/redisotel`.
Consumers wrote `redis.Client` against a Valkey-backed store called KV.
package redis -> package kv (93 decls)
redis.X -> kv.X (2,794 call sites)
"redis: …" errors -> "kv: …" (206)
extra/redis{otel,cmd,prometheus,census} -> extra/kv{otel,cmd,prometheus,census}
redis:// , rediss:// -> kv:// , kvs:// (ParseURL)
Redis*/*Redis* idents -> KV*/*KV*
REDIS_VERSION, REDIS_ENDPOINTS_CONFIG_PATH -> KV_*
I previously argued this rename was unsafe because much of it was "wire
contract". That was wrong, and the categorisation shows why: RESP command names
are GET/SET/HSET — they never contain the word. Of 5,771 occurrences only two
kinds were server-visible at all: the ParseURL scheme (we choose what we pass;
our configs already use kv://) and the CLIENT SETINFO lib-name label, which the
server merely records. Nothing here changes a byte of protocol.
Two things deliberately keep the old spelling:
RediSearch — names a specific external module the FT.* commands map to.
StoreDist — contains the letters by accident (sto-reDis-t), not the word.
Breaking for consumers by design: every import site must move redis.X -> kv.X.
Minor bump, never a major — this module stays v9 forever.
Prometheus Metric Collector
This package implements a prometheus.Collector
for collecting metrics about the connection pool used by the various kv clients.
Supported clients are kv.Client, kv.ClusterClient, kv.Ring and kv.UniversalClient.
Example
client := kv.NewClient(options)
collector := kvprometheus.NewCollector(namespace, subsystem, client)
prometheus.MustRegister(collector)
Metrics
| Name | Type | Description |
|---|---|---|
pool_hit_total |
Counter metric | number of times a connection was found in the pool |
pool_miss_total |
Counter metric | number of times a connection was not found in the pool |
pool_timeout_total |
Counter metric | number of times a timeout occurred when getting a connection from the pool |
pool_conn_total_current |
Gauge metric | current number of connections in the pool |
pool_conn_idle_current |
Gauge metric | current number of idle connections in the pool |
pool_conn_stale_total |
Counter metric | number of times a connection was removed from the pool because it was stale |