Configuration du Cache
Optimisez votre cache pour des performances et une fiabilité maximales.
Voir la Configuration
- Accédez à votre instance de cache
- Cliquez sur l'onglet Configuration
- Consultez les paramètres actuels
Mise à l'Échelle
Taille du cluster (nombre de shards)
Le nombre de shards est fixé à la création et ne peut pas être modifié par la suite. Changer le nombre de shards nécessite de migrer les données vers une nouvelle instance.
Classe de stockage
La classe de stockage (standard ou performance) est fixée à la création et ne peut pas être modifiée par la suite. Créez une nouvelle instance si vous avez besoin d'une classe de stockage différente.
Augmenter la Taille
Passez à une flaveur ou classe de calcul plus grande :
- Allez sur votre instance de cache
- Cliquez sur Modifier
- Sélectionnez une classe d'instance plus grande
- Cliquez sur Enregistrer
Les opérations de mise à l'échelle sont effectuées avec un temps d'arrêt minimal (< 30 secondes).
Classes de Calcul
Les instances de cache utilisent des classes de calcul avec un ratio CPU:RAM fixe. Vous configurez les ressources à l'aide de curseurs dans les limites de la classe.
| Classe | Ratio CPU:RAM | CPU Max | RAM Max | Description |
|---|---|---|---|---|
| Eco | 1:2 | 3 cores | 6 Go | Développement et tests |
| Standard | 1:4 | 15 cores | 58 Go | Production générale |
| Production | 1:4 | 6 cores | 28 Go | Production critique avec ressources dédiées |
Exemple de ressources pour la classe Standard (ratio 1:4) :
| CPU | Mémoire |
|---|---|
| 1 vCPU | 4 Go |
| 2 vCPU | 8 Go |
| 4 vCPU | 16 Go |
| 8-15 vCPU | 32-58 Go |
Gestion du Stockage
Chaque shard Valkey utilise un volume persistant. Le stockage reste alloué lorsque l'instance est arrêtée.
Augmenter le Stockage
- Allez sur votre instance de cache
- Cliquez sur Modifier
- Augmentez la taille du stockage
- Cliquez sur Enregistrer
Les augmentations de stockage s'appliquent immédiatement sans temps d'arrêt.
Le stockage ne peut être qu'augmenté, pas diminué.
Gestion de la Mémoire
Politique de Mémoire Maximale
Configurez le comportement quand la mémoire est pleine :
| Politique | Comportement |
|---|---|
noeviction | Retourne des erreurs quand plein |
allkeys-lru | Évince les clés les moins récemment utilisées |
volatile-lru | Évince les clés LRU avec TTL uniquement |
allkeys-random | Évince des clés aléatoires |
volatile-random | Évince des clés aléatoires avec TTL |
volatile-ttl | Évince les clés avec le TTL le plus court |
Recommandé : allkeys-lru pour les cas d'usage de cache.
Utilisation Mémoire
Vérifier la mémoire actuelle :
redis-cli -h host -a password INFO memory
Métriques clés :
used_memory- Mémoire totale allouéeused_memory_peak- Mémoire maximale utiliséemaxmemory- Limite de mémoire
Optimisation Mémoire
1. Définir un TTL sur Toutes les Clés
// Toujours définir une expiration
await redis.set('key', 'value', 'EX', 3600);
// Ne pas stocker les données indéfiniment
await redis.set('key', 'value'); // Mauvais
2. Utiliser des Structures de Données Efficaces
// Stocker des données utilisateur
// Moins efficace - plusieurs clés
await redis.set('user:1:name', 'John');
await redis.set('user:1:email', '[email protected]');
// Plus efficace - un seul hash
await redis.hset('user:1', {
name: 'John',
email: '[email protected]'
});
3. Compresser les Grandes Valeurs
const zlib = require('zlib');
// Stocker compressé
const compressed = zlib.gzipSync(JSON.stringify(largeData));
await redis.set('key', compressed);
// Récupérer et décompresser
const data = zlib.gunzipSync(await redis.getBuffer('key'));
Gestion des Connexions
Limites de Connexion
Les limites de connexion dépendent de votre classe de calcul et des ressources allouées. Plus de ressources permettent plus de connexions.
| Classe | CPU | Connexions Max Approximatives |
|---|---|---|
| Eco | 0.5-1 vCPU | 100-200 |
| Eco | 2-3 vCPU | 200-500 |
| Standard | 1 vCPU | 500 |
| Standard | 2+ vCPU | 1000 |
| Production | 2-6 vCPU | 1000-2000+ |
Surveiller les Connexions
redis-cli -h host -a password INFO clients
Métriques clés :
connected_clients- Connexions actuellesblocked_clients- Clients en opérations bloquantesmaxclients- Maximum autorisé
Bonnes Pratiques de Connexion
Utiliser le Pooling de Connexions
// Node.js avec ioredis (pooling intégré)
const redis = new Redis({
host: 'host',
password: 'password',
lazyConnect: true
});
// Python avec pool de connexions
pool = redis.ConnectionPool(max_connections=20)
r = redis.Redis(connection_pool=pool)
Définir des Timeouts
const redis = new Redis({
connectTimeout: 5000,
commandTimeout: 5000,
keepAlive: 10000
});
Gérer les Déconnexions
redis.on('error', (err) => {
console.error('Erreur de connexion Redis :', err);
});
redis.on('close', () => {
console.log('Connexion Redis fermée');
});
redis.on('reconnecting', () => {
console.log('Reconnexion à Redis...');
});
Persistance
Chaque shard Valkey utilise un volume persistant avec des snapshots RDB périodiques. Valkey gère automatiquement la planification des snapshots — vous n'avez pas besoin de configurer les paramètres RDB ou AOF.
La planification et la restauration de sauvegardes gérées ne sont pas disponibles. Les snapshots RDB sur le volume persistant de l'instance ne remplacent pas une sauvegarde externe.
Optimisation des Performances
Log Lent
Surveiller les commandes lentes :
# Obtenir les 10 dernières commandes lentes
redis-cli SLOWLOG GET 10
# Configurer le seuil (microsecondes)
CONFIG SET slowlog-log-slower-than 10000
Surveillance de la Latence
# Surveillance continue de la latence
redis-cli --latency
# Historique de latence
redis-cli --latency-history
Buffer de Sortie Client
Pour pub/sub et opérations bloquantes :
client-output-buffer-limit normal 0 0 0
client-output-buffer-limit replica 256mb 64mb 60
client-output-buffer-limit pubsub 32mb 8mb 60
Sécurité
Gestion des Mots de Passe
Changer le mot de passe d'une instance existante :
- Allez sur votre instance de cache
- Cliquez sur Modifier
- Entrez le nouveau mot de passe
- Cliquez sur Enregistrer
- Mettez à jour les configurations de vos applications avec le nouveau mot de passe
Laissez le champ mot de passe vide lors de la modification pour conserver le mot de passe actuel.
Authentification
L'authentification par mot de passe est optionnelle pour les connexions internes mais requise lorsque l'accès public est activé.
Pour activer/désactiver l'authentification :
- Allez dans les paramètres du cache
- Activez/Désactivez Authentification
- Enregistrez les modifications
Vous ne pouvez pas activer l'accès public sans authentification. Le système impose cette restriction pour la sécurité.
Accès Réseau
Par défaut, les instances de cache sont accessibles uniquement depuis :
- Les conteneurs du même projet
- Le réseau interne du projet
Accès Public
Activez l'accès externe à votre cache :
- Allez dans les paramètres du cache
- Activez Accès Public
- Configurez la Liste d'IPs Autorisées — ajoutez chaque CIDR autorisé et une note optionnelle (100 caractères max) pour identifier son usage
Lorsque activé :
- Une gateway dédiée est créée
- Le port 6379 est exposé
- Seules les IPs autorisées peuvent se connecter
- L'authentification est requise
Configurez toujours la liste d'IPs autorisées lors de l'activation de l'accès public. N'exposez jamais votre cache sans restrictions d'IP. Les connexions publiques ne sont pas chiffrées — TLS n'est pas disponible pour Valkey.
TLS
TLS n'est pas supporté pour les instances Valkey. Les connexions utilisent du TCP non chiffré. Gardez les charges sensibles sur des réseaux privés.
Restrictions de Commandes
Certaines commandes dangereuses sont désactivées :
FLUSHALL
FLUSHDB
DEBUG
CONFIG (opérations d'écriture)
SHUTDOWN
Valkey Admin
Besoin de parcourir vos clés, d'exécuter des commandes ou de surveiller les clés chaudes depuis une interface web ? Consultez Valkey Admin — un add-on optionnel activable depuis le formulaire du cache, sans coût supplémentaire.
Surveillance
Métriques Intégrées
Accès via l'onglet Métriques :
| Métrique | Description |
|---|---|
| Utilisation Mémoire | Mémoire actuelle vs. max |
| Connexions | Nombre de connexions actives |
| Opérations/sec | Commandes traitées |
| Taux de Hits | Pourcentage de hits cache |
| I/O Réseau | Octets entrants/sortants |
Métriques Clés à Surveiller
| Métrique | Sain | Alerte |
|---|---|---|
| Utilisation mémoire | < 80% | > 90% |
| Taux de hits | > 80% | < 50% |
| Connexions | < 80% limite | Proche limite |
| Latence | < 1ms | > 10ms |
Alertes
Configurez des alertes pour :
- Utilisation mémoire > 80%
- Nombre de connexions > 80% limite
- Latence élevée (> 10ms)
- Augmentation du taux d'erreur
Maintenance
Rotation des Mots de Passe
- Allez sur votre instance de cache et cliquez sur Modifier
- Entrez le nouveau mot de passe et cliquez sur Enregistrer
- Mettez à jour les configurations des applications avec le nouveau mot de passe
- Déployez les applications
- Vérifiez les connexions
Vider les Données
FLUSHDB et FLUSHALL sont désactivées par défaut dans SailOps par sécurité. Si vous devez effacer les données en cache, supprimez et recréez l'instance de cache, ou contactez le support pour activer ces commandes temporairement.
Nettoyage des Clés
Trouver et supprimer les anciennes clés :
# Trouver les clés correspondant à un pattern
redis-cli -h host -a password KEYS "session:*"
# Scanner les grandes clés
redis-cli -h host -a password --bigkeys
Dépannage
Utilisation Mémoire Élevée
-
Vérifier les clés sans TTL :
redis-cli DEBUG OBJECT key -
Trouver les grandes clés :
redis-cli --bigkeys -
Revoir la politique mémoire
-
Envisager une mise à l'échelle
Performances Lentes
-
Vérifier le log lent :
redis-cli SLOWLOG GET 10 -
Surveiller la latence :
redis-cli --latency -
Vérifier le nombre de connexions
-
Vérifier les opérations bloquantes
Erreurs de Connexion
- Vérifier les détails de connexion
- Vérifier les limites de connexion
- Revoir la configuration client
- Vérifier les fuites de connexion
Taux d'Éviction Élevé
Si les clés sont évincées trop souvent :
- Passer à une instance plus grande
- Revoir les paramètres TTL
- Optimiser les structures de données
- Envisager le partitionnement des données