Cette page présente différents problèmes, les messages d'erreur associés et les étapes de dépannage pour les résoudre.
Problèmes de connectivité
Si votre instance Memorystore pour Redis rencontre des problèmes de connectivité, vérifiez les problèmes décrits dans cette section pour voir si l'un d'eux est à l'origine du problème.
Si un problème de cette section ne correspond pas à votre problème, connectez-vous à l'un de vos nœuds Redis via Telnet et exécutez des commandes Redis pour voir si l'instance répond.
Si le nœud ne répond pas, vérifiez si l'un des problèmes de mise en réseau est à l'origine du blocage de la connexion réseau de votre nœud. Si aucune de ces solutions ne résout le problème, contactez Cloud Customer Care.
Vous provisionnez des ressources dans différents réseaux VPC.
Pour vous connecter à une instance Memorystore pour Redis à partir d'une ressource Google Cloud , telle qu'une VM Compute Engine, vous devez provisionner les ressources sur le même réseau VPC autorisé que l'instance.
Toute tentative de connexion Telnet à une instance à partir d'une ressource située dans une autre région ou un autre réseau VPC génère le message d'erreur suivant :
telnet: Unable to connect to remote host: Connection timed out
Vous supprimez un appairage de réseaux VPC.
Lorsque vous créez une instance Memorystore pour Redis, vous créez un appairage de VPC entre votre réseau VPC et un réseau VPC Google interne.
L'appairage de réseaux utilise le format suivant :
redis-peer-############
Si cet appairage de réseaux est supprimé, toute tentative de connexion Telnet à l'instance génère le message d'erreur suivant :
telnet: Unable to connect to remote host: Connection timed out
Pour rétablir l'appairage de réseaux supprimé, créez une autre instance. Ensuite, supprimez cette instance. Votre instance d'origine dispose désormais de l'appairage de réseaux dont elle a besoin.
Vous créez des règles de pare-feu qui bloquent les adresses IP de votre instance.
Si vous créez des règles de pare-feu de sortie qui bloquent le port (6379) ou l'adresse IP de votre instance Memorystore pour Redis, vous risquez de rencontrer des problèmes de connectivité. Ne créez pas de règles de pare-feu de réseau qui bloquent la plage d'adresses IP de votre instance.
Vous avez des connexions qui ne répondent pas
Nous vous recommandons vivement de configurer votre application cliente pour détecter les connexions qui ne répondent pas à Memorystore pour Redis. Lorsqu'une connexion qui ne répond pas est détectée, le client doit la réinitialiser. Pour créer une application résiliente, nous vous recommandons les configurations client suivantes :
- Configurez les paramètres TCP keep-alive : définissez les paramètres
TCP keepalive time,TCP keepalive intervaletTCP keepalive probesde sorte que les clients détectent et suppriment de manière proactive les connexions qui ne répondent pas, même lorsqu'elles sont inactives. Par exemple, si vous définissez le paramètreTCP keepalive timesur 30 secondes,TCP keepalive intervalsur 10 secondes etTCP keepalive probessur 3, les clients réinitialisent les connexions inactives qui ne répondent pas dans un délai d'une minute. - Configurez les délais avant expiration TCP de l'utilisateur : définissez ce délai avant expiration dans vos clients pour réinitialiser les connexions qui ont des requêtes en attente et qui ne répondent plus. Par exemple, si vous définissez le délai avant expiration sur 15 secondes, les clients réinitialisent les connexions qui ne répondent pas et qui ont des requêtes en attente après 15 secondes.
Memorystore pour Redis rejette les nouvelles tentatives de connexion
Lorsque vous activez le chiffrement en transit, chaque niveau de capacité Memorystore pour Redis applique une limite de connexion maximale. Si votre instance atteint cette limite, Memorystore pour Redis rejette les nouvelles tentatives de connexion.
Pour résoudre ce problème, effectuez l'une des opérations suivantes :
- Faites évoluer votre instance vers un niveau de capacité compatible avec le nombre de connexions requis.
- Réduisez le nombre total de connexions en établissant et en réutilisant des connexions de longue durée.
Vous pouvez surveiller le nombre de connexions actives à l'aide de la métrique redis.googleapis.com/clients/connected. Si Memorystore pour Redis rejette les nouvelles tentatives de connexion, mais que votre nombre de connexions est inférieur à la limite maximale, recherchez les erreurs dans les journaux côté client (tels que les journaux stunnel).
Memorystore pour Redis supprime les connexions existantes
Pour les instances qui exécutent Redis version 6.x ou antérieure avec le chiffrement en transit activé, Memorystore pour Redis effectue une rotation de ses certificats côté serveur tous les 180 jours. Cette rotation peut entraîner l'interruption des connexions de l'instance pendant quelques secondes.
Pour résoudre ce problème, configurez votre application cliente pour qu'elle se reconnecte automatiquement en réessayant de se connecter avec un intervalle exponentiel entre les tentatives. Si vous mettez à niveau l'instance vers Redis version 7.0 ou ultérieure, Memorystore pour Redis ne supprime pas les connexions lors de la rotation de ses certificats.
Problèmes d'utilisation du processeur
Cette section décrit les problèmes d'utilisation du processeur que votre instance Memorystore pour Redis peut rencontrer.
Votre instance présente une latence élevée ou ne répond pas.
Si votre instance Memorystore pour Redis présente une latence élevée ou ne répond pas, ces problèmes peuvent être dus à l'utilisation des commandes Redis suivantes, qui consomment beaucoup de ressources :
Ces commandes peuvent entraîner une pression importante du processeur sur l'instance. Nous vous recommandons de ne pas exécuter la commande KEYS dans les environnements de production. Utilisez plutôt SCAN, car cette commande utilise moins de ressources que KEYS.
L'utilisation de LRANGE pour interroger l'ensemble ou un grand sous-ensemble de votre espace de clés peut nécessiter des ressources de processeur élevées. Pour résoudre ce problème, nous vous recommandons de réduire le nombre de clés de l'ensemble de clés que vous interrogez en une seule opération.
L'utilisation d'un script Lua complexe avec EVAL peut également entraîner une utilisation élevée du processeur. Nous vous recommandons d'utiliser des scripts Lua moins complexes.
HGETALL et ZRANGE peuvent renvoyer un grand nombre de clés, ce qui peut avoir un impact négatif sur les performances de votre serveur. Au lieu de HGETALL, nous vous recommandons d'exécuter la commande HSCAN. De plus, avant d'utiliser ZRANGE, nous vous recommandons de limiter la taille de la plage que vous utilisez pour une requête.
Avant d'exécuter une commande gourmande en ressources, vérifiez la taille des structures de données interrogées par la commande pour vous assurer qu'elle ne provoque pas de latence.
Si votre instance présente une latence élevée ou ne répond pas, procédez comme suit :
- Vérifiez vos journaux côté client pour voir si des commandes consommant beaucoup de ressources ont été exécutées. Si oui, notez la date et l'heure.
- Utilisez Cloud Monitoring pour afficher la métrique
redis.googleapis.com/stats/cpu_utilization. Vérifiez si les périodes d'utilisation élevée du processeur coïncident avec les périodes d'exécution des commandes gourmandes en ressources.
Le tampon de sortie de votre instance manque d'espace.
Si la mémoire tampon de sortie de votre instance Memorystore pour Redis manque d'espace, procédez comme suit :
- Définissez une valeur plus petite pour le paramètre
maxmemory-gb. - Utilisez la règle
allkeys-lrumaxmemory.
Lorsque la mémoire de votre instance est pleine et qu'une nouvelle écriture arrive, Memorystore pour Redis supprime des clés pour faire de la place à l'écriture, en fonction de la règle maxmemory de votre instance. La règle allkeys-lru supprime les clés les moins récemment utilisées (LRU) de l'ensemble de clés.
Nous vous recommandons de surveiller la métrique maxmemory et la mémoire utilisée de votre instance. Cela vous permet de savoir si votre instance atteint la capacité d'instance provisionnée.
De plus, en réduisant la valeur du paramètre maxmemory-gb, vous obtenez plus d'espace pour la surcharge.
Les métriques externes sont manquantes pour votre instance
Si votre instance présente une utilisation élevée du processeur ou si ses ressources sont épuisées (par exemple, en raison d'un trop grand nombre de connexions), elle peut ne pas fonctionner correctement et les métriques externes peuvent être manquantes.
Isoler la source de la latence de votre instance
Pour déterminer si la latence que vous rencontrez provient de votre instance, de votre application cliente ou de votre environnement réseau, utilisez l'outil redis-cli pour exécuter un test de latence continu.
Pour isoler la source de la latence de votre instance, procédez comme suit :
Connectez-vous à une VM Compute Engine située dans la même région et le même réseau VPC que votre instance.
Si ce n'est pas déjà fait, installez l'outil
redis-clisur votre VM.Pour les VM basées sur Debian ou Ubuntu, exécutez la commande suivante :
sudo apt-get install redis-toolsPour les VM basées sur RHEL ou CentOS, exécutez la commande suivante :
sudo yum install redis
Pour mesurer la latence de l'instance en millisecondes, exécutez la commande suivante :
redis-cli --latency -h IP_ADDRESS -p PORT
Si l'authentification Redis ou le chiffrement en transit sont activés sur votre instance, veillez à ajouter les options d'authentification (
-a) ou TLS (--tls) requises.Effectuez les remplacements suivants :
- IP_ADDRESS : adresse IP de votre instance.
- PORT : numéro de port réservé à votre instance. En règle générale, ce numéro de port est 6379.
Laissez la commande s'exécuter pendant quelques minutes. L'outil ping le serveur en continu et calcule les valeurs de latence minimale, maximale et moyenne.
Pour arrêter la commande et afficher les résultats, appuyez sur
Ctrl+C.
Si le résultat de la commande génère une latence moyenne constamment faible (généralement 1 milliseconde ou moins), l'instance est opérationnelle et répond rapidement.
Si la commande affiche une latence constamment faible, mais que votre application cliente subit toujours des retards, les problèmes suivants peuvent être à l'origine de la latence :
- Réseau : le trafic acheminé entre différentes régions ou zones entre votre client et l'instance peut entraîner des retards réseau importants.
- Client : une utilisation élevée du processeur ou de la mémoire sur le client, des pools de connexions épuisés ou des goulots d'étranglement de la logique d'application peuvent augmenter le délai aller-retour total rencontré par le client.
Problèmes de Mise en réseau
Cette section décrit les problèmes de mise en réseau que votre instance peut rencontrer.
Vous avez épuisé la plage d'adresses IP allouée ou une route en conflit existe.
Lorsque vous créez des ressources dans la plage d'adresses IP dédiée à Memorystore pour Redis, vous risquez d'épuiser toutes les adresses IP. Il est également possible qu'une route soit en conflit avec l'adresse IP de l'instance Memorystore pour Redis que vous essayez de créer.
Ces problèmes entraînent l'affichage du message d'erreur suivant :
The IP ranges for the connection do not have enough available IPs. Allocate a
new range or expand existing range and try again.
Pour résoudre ce problème, allouez des adresses IP supplémentaires ou supprimez l'écart de conflit de routage. Pour plus d'informations, consultez la section Épuisement de la plage d'adresses IP.
Vous n'avez pas établi de connexion d'accès aux services privés pour votre réseau.
Si votre instance Memorystore pour Redis utilise le mode de connexion d'accès aux services privés, mais qu'aucune connexion d'accès aux services privés n'existe pour votre réseau, vous pouvez recevoir le message d'erreur suivant :
Google private service access is not enabled. Enable private service access and
try again
Pour résoudre ce problème, établissez une connexion d'accès aux services privés.
Vous supprimez l'appairage de réseaux pour la connexion d'accès aux services privés.
Lorsque vous établissez une connexion d'accès aux services privés, Memorystore pour Redis crée une connexion d'appairage de réseaux appelée servicenetworking-googleapis-com. Cette connexion apparaît sur la page Appairage de réseaux VPC de votre projet.
Si vous supprimez l'appairage de réseaux, le message d'erreur suivant s'affiche pour les instances existantes :
telnet: Unable to connect to remote host: Connection timed out
De plus, si vous supprimez l'appairage de réseaux et que vous créez une instance, le message d'erreur suivant s'affiche :
Private services access is not configured correctly. For steps on how to
verify the connection, check the documentation.
Pour résoudre ce problème, créez une connexion d'accès aux services privés entre votre réseau et le réseau d'accès aux services privés en exécutant la commande suivante :
gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=RESERVED_RANGE_NAME --network=VPC_NETWORK --project=PROJECT_ID
Vous utilisez des paramètres en conflit.
Si vous utilisez à la fois le paramètre --reserved-ip-range et le paramètre --connect-mode=private-service-access, vous recevez le message d'erreur suivant :
Reserved IP range is not supported for --connect-mode private services access
Vous ne pouvez pas utiliser les deux paramètres en même temps, car Memorystore pour Redis n'est pas compatible avec le paramètre --reserved-ip-range pour le mode de connexion d'accès aux services privés.
Pour résoudre ce problème, effectuez l'une des opérations suivantes :
- Utilisez le paramètre
--reserved-ip-rangeavec le paramètre--connect-mode=direct-peering. - N'utilisez pas le paramètre
--reserved-ip-range.
Vous dépassez le quota de sous-réseaux de votre projet.
Le nombre de sous-réseaux que vous pouvez créer dans votre projetGoogle Cloud est limité. Si vous dépassez ce quota, vous recevez l'un des messages d'erreur suivants :
Internal network quota exceeded. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
ou
Unable to create instance. Network quota limit has been reached. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
Pour résoudre ce problème, remplissez le formulaire qui s'affiche dans les messages d'erreur ou contactez Cloud Customer Care.
Vous n'associez pas votre projet de service à votre projet hôte.
Si vous utilisez un VPC partagé et que vous n'associez pas votre projet de service à votre projet hôte, le message d'erreur suivant s'affiche :
Invalid network name <network-name>. Project <project-name> referenced is not the host project for <service-project-name>.
Pour résoudre ce problème, associez votre projet de service à votre projet hôte.
Vous créez une instance dans un projet de service avec le mode de connexion par appairage direct et vous désignez un réseau VPC partagé.
Si vous créez une instance Memorystore pour Redis dans un projet de service et que vous désignez un réseau VPC partagé du projet hôte pour l'instance, vous ne pouvez pas utiliser le mode de connexion par appairage direct.
Par défaut, le mode de connexion est défini sur l'appairage direct. Si vous tentez d'utiliser ce mode de connexion lors de la création d'une instance et que vous choisissez également un réseau VPC partagé du projet hôte comme valeur du paramètre --network, le message d'erreur suivant s'affiche :
Authorized_network must exist in the same project as redis instance
Pour résoudre ce problème, effectuez l'une des opérations suivantes :
- Lorsque vous créez votre instance, utilisez le mode de connexion d'accès aux services privés
(--connect-mode=private-service-access). - Choisissez un réseau VPC autorisé qui se trouve dans le même projet que votre instance.
Vous utilisez une plage d'adresses IP pour Compute Engine à laquelle Memorystore pour Redis ne peut pas accéder.
Vous ne pouvez pas accéder à votre instance Memorystore pour Redis à partir d'une VM Compute Engine dont l'adresse IP se trouve dans la plage 172.17.0.0/16.
Cette plage est réservée à un composant interne.
Pour résoudre ce problème, accédez à votre instance à partir d'une VM Compute Engine dont l'adresse IP se trouve dans une autre plage.
Problèmes de connexion à votre instance à partir d'autres ressources Google Cloud
Cette section décrit les problèmes que votre instance Memorystore pour Redis peut rencontrer lorsque d'autres ressources tentent de s'y connecter.
Vous ne pouvez pas vous connecter à votre instance à partir d'environnements sans serveur qui nécessitent un connecteur d'accès au VPC sans serveur.
Si vous ne parvenez pas à vous connecter à votre instance Memorystore pour Redis à l'aide de l'un des environnements sans serveur nécessitant un connecteur d'accès au VPC sans serveur, vérifiez si vous avez configuré ce connecteur pour votre environnement. Pour en savoir plus, consultez Exigence concernant le connecteur d'accès au VPC sans serveur.
Vous ne pouvez pas vous connecter à votre instance depuis un cluster Google Kubernetes Engine (GKE)
Pour vous connecter à votre instance Memorystore pour Redis à partir d'un cluster GKE, vous devez activer l'aliasing d'adresses IP/VPC natif sur le cluster.
Le plus simple est d'activer l'alias d'adresse IP/VPC natif lors de la création du cluster. Dans la section des options avancées, sélectionnez VPC natif. Pour en savoir plus, consultez Créer un cluster de VPC natif.
Problèmes liés à Identity and Access Management (IAM)
Cette section décrit les problèmes IAM que votre instance Memorystore pour Redis peut rencontrer.
Vous souhaitez restaurer une liaison de stratégie supprimée pour un compte de service.
Memorystore pour Redis utilise les comptes de service suivants pour gérer vos instances :
service-PROJECT_NUMBER@service-networking.service-PROJECT_NUMBER@cloud-redis.
Si vous supprimez les liaisons de stratégie pour ces comptes de service, vous ne pourrez pas créer d'instances.
Si vous essayez de créer une instance Memorystore pour Redis à l'aide de la Google Cloud CLI, le message d'erreur suivant peut s'afficher :
(gcloud.redis.instances.create) FAILED_PRECONDITION: A required IAM policy might be missing. Please run this command:"gcloud projects add-iam-policy-binding YOUR_PROJECT_ID --member='serviceAccount:service-YOUR_PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'" and try again.
Pour rétablir la liaison de stratégie pour le compte de service service-networking, exécutez la commande suivante. Remplacez VARIABLES par les valeurs appropriées.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@service-networking.' --role='roles/servicenetworking.serviceAgent'
Pour rétablir la liaison de stratégie pour le compte de service cloud-redis, exécutez la commande suivante. Remplacez VARIABLES par les valeurs appropriées.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'
Problèmes de délai avant expiration de l'opération
Les problèmes suivants entraînent l'absence de réponse d'une instance Redis et/ou des délais avant expiration des opérations d'instance/de nœud.
Problèmes de partition réseau
Il arrive que les ressources Google Cloud ne puissent pas communiquer entre les zones d'une même région en raison d'une erreur de partition réseau sur les serveurs Google Cloud. Cela peut entraîner une perte de connexion de l'instance et renvoyer une erreur de délai d'attente.
Une fois que Google Cloud a résolu l'erreur de partition réseau pour la région ou la zone où votre instance est provisionnée, la connectivité devrait reprendre normalement.
Dans ce cas, un message d'erreur de connectivité tel que le suivant peut s'afficher :
telnet: Unable to connect to remote host: Connection timed out
Si vous ne parvenez pas à identifier la cause de l'erreur de délai d'expiration, contactez l'assistanceGoogle Cloud .
Projet de service et projet hôte ne faisant pas partie du même périmètre de contrôle de service VPC
Si vous utilisez un VPC partagé et un périmètre de contrôle de service VPC, et que votre opération de création d'instance Redis expire, cela peut indiquer que votre projet de service et votre projet hôte ne se trouvent pas dans le même périmètre de service. Votre projet de service et votre projet hôte doivent se trouver dans le même périmètre pour que votre instance Redis puisse communiquer avec les clients se connectant via le réseau VPC partagé.
Pour vérifier la présence de ce problème, consultez les journaux d'audit de votre instance Redis pour rechercher l'erreur suivante :
violationReason: "NETWORK_NOT_IN_SAME_SERVICE_PERIMETER"
Pour résoudre ce problème, placez votre réseau hôte et votre réseau de service dans le même périmètre de service.
Résoudre les problèmes d'importation et d'exportation
Cette section décrit certains problèmes courants que vous pouvez rencontrer lors de l'utilisation de l'importation et de l'exportation pour Memorystore pour Redis.
Les boutons d'importation et d'exportation sont désactivés dans la console Google Cloud
Problème : l'utilisateur connecté à la console ne dispose pas des autorisations redis.instances.import et/ou redis.instances.export requises pour importer et/ou exporter des fichiers RDB.
Solution : accordez les autorisations à l'utilisateur et actualisez la page des détails de l'instance.
L'opération d'importation est terminée, mais les données n'ont pas été restaurées.
Si une opération d'importation se termine, mais que les données ne sont pas restaurées, commencez par rechercher un message d'erreur dans la console Google Cloud ou sur la ligne de commande, puis résolvez les problèmes décrits dans le message d'erreur.
En cas d'échec pendant le processus d'importation, l'instance est récupérée à l'aide d'un fichier RDB vide. Vous pouvez essayer de restaurer les données en important à nouveau le même fichier RDB ou en utilisant un autre fichier RDB.
L'importation a échoué, car le fichier RDB était trop volumineux.
Si le message d'erreur "La taille d'un fichier d'importation RDB gs://bucket/object.rdb dépasse la mémoire maximale de 10 Go" s'affiche, vous devez augmenter la taille de votre instance et relancer l'importation. Vous pouvez également essayer d'importer un fichier RDB plus petit dans votre instance.
Résoudre les problèmes liés à Google Cloud CLI
Si vous rencontrez un problème où une commande gcloud CLI n'est pas disponible ou si la commande se comporte différemment de ce qui est documenté, essayez de mettre à jour gcloud CLI :
gcloud components update
Arrêter toutes les commandes et connexions en cours pour une instance Redis
Memorystore pour Redis étant un produit géré par Google, certaines commandes sont bloquées dans votre instance Redis afin de fournir un environnement sûr et fiable. L'une des commandes restreintes est CLIENT, qui inclut CLIENT KILL, permettant d'arrêter les commandes.
Si une commande Redis consomme une grande utilisation du processeur ou de la RAM et affecte votre environnement de production, vous devez redémarrer l'instance (pour les configurations de niveau de base), ou basculer vers une instance dupliquée (pour les configurations de niveau Standard). Cette opération de redémarrage/basculement interrompt toutes les commandes en cours d'exécution sur le serveur Redis et met fin à toutes les connexions en cours.
Vous trouverez ci-dessous les commandes permettant d'effectuer des redémarrages ou des basculements pour chaque configuration de Memorystore pour Redis.
Arrêter des commandes dans des instances Memorystore pour Redis de niveau standard
gcloud redis instances failover INSTANCE_NAME --data-protection-mode=limited-data-loss
Arrêter des commandes dans des instances Memorystore pour Redis de niveau de base
Le seul moyen d'effectuer un redémarrage d'une instance Memorystore pour Redis consiste à modifier sa configuration, par exemple un scaling à la hausse. Vous trouverez ci-dessous un exemple de commande que vous pouvez exécuter pour redémarrer votre instance.
gcloud redis instances update INSTANCE_NAME --region REGION_ID --size NUMBER_GB
Après avoir mis à l'échelle votre instance à une autre taille, vous pouvez exécuter une autre opération de scaling pour la ramener à la taille d'origine.
Problèmes liés aux règles d'administration avec le partage restreint au domaine
Il existe un problème connu pour lequel la règle d'administration iam.allowedPolicyMemberDomains provoque des erreurs lorsqu'elle est utilisée avec des instances Memorystore pour Redis qui utilisent le format de compte de service PROJECT_NUMBER-compute@.
Selon la date de création de votre instance, Memorystore pour Redis utilise l'un des deux formats de compte de service. Pour identifier le format du compte de service de votre instance, consultez Format du compte de service Memorystore pour Redis.
Lorsque ce problème se produit, le message d'erreur suivant peut s'afficher : One or
more users named in the policy do not belong to a permitted customer.
Selon la règle de votre organisation et si vous pouvez recréer votre instance, vous pouvez résoudre cette erreur à l'aide de l'une des options suivantes :
Recréez votre instance : les anciennes instances utilisent le format de compte de service
PROJECT_NUMBER-compute@, qui est souvent bloqué par les règles de partage avec restriction de domaine. Les instances nouvellement créées utilisent un format de compte de service moderne compatible avec la plupart des règles d'administration.Si votre règle d'administration bloque tous les domaines externes, cette option ne fonctionne pas. Pour contourner la règle, vous devez utiliser la deuxième option.
Forcer l'accès au compte : si vous ne pouvez pas recréer votre instance pour obtenir le nouveau format de compte de service, ou si la règle de votre organisation bloque le nouveau domaine de compte de service, vous devez contourner la règle en forçant l'accès au compte pour votre projet. Pour en savoir plus, consultez Forcer l'accès au compte.