badpixxel/paddock-redis

Paddock - Redis Extension

5.x-dev 2026-08-19 11:01 UTC

Requires

• php: ^8.1
• ext-redis: *
• badpixxel/paddock-core: ^5.0

Requires (Dev)

• badpixxel/php-sdk: ^3.0
• symfony/flex: ^2.0

MIT

Published on Packagist.org on 2026-08-19 09:01 UTC

README

Paddock component for Redis servers monitoring: connexion, latency, server infos and memory usage.

Requirements

• PHP ^8.1 with ext-redis (phpredis)
• badpixxel/paddock-core ^5.0
• Symfony ^5.4|^6.4|^7.4|^8.0

Installation

composer require badpixxel/paddock-redis

Register the bundle (auto with Flex, otherwise in config/bundles.php):

BadPixxel\Paddock\System\Redis\PaddockRedisBundle::class => ['all' => true],

Configuration

Default target server comes from the REDIS_URL environment variable:

REDIS_URL="redis://[user[:password]@]host[:port][/database]"

rediss:// scheme enables TLS. Any track may target another server with the url option.

Collectors

Code	Keys	Description
redis-ping	latency	Round-trip latency in ms
redis-info	any INFO key (redis_version, connected_clients…)	Server infos
redis-memory	used (% of maxmemory), used_mb, max_mb	Memory usage

Default Track

redis-health-checker — enabled when REDIS_URL is defined: server answers to ping, latency below 50ms (warning) / 500ms (error), exposed as redis_latency metric.

Tracks Examples

tracks:
    cache-server:
        collector:      redis-info
        description:    "[CACHE] Check Redis Server"
        options:
            url:        "redis://cache.local:6379"
        rules:
            redis_version:      { rule: version, gte: { error: "7.0" } }
            connected_clients:  { lt: { warning: 500, error: 1000 } }
            evicted_keys:       { eq: "0" }

    cache-memory:
        collector:      redis-memory
        description:    "[CACHE] Check Redis Memory"
        rules:
            used:               { lt: { warning: 80, error: 95 } }

Development

make up          # sf5 → sf8 containers + redis:7
make verify      # composer update + grumphp (travis, csfixer, phpstan) + phpunit, in all containers

Tests require a live Redis server (REDIS_URL), provided by docker compose and by the CI service.