Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, descrevemos como a instância do Memorystore para Valkey se comporta durante o escalonamento.
É possível escalonar a capacidade da instância das seguintes maneiras:
É possível mudar o número de fragmentos da instância. Isso é chamado de escalonamento horizontal. É possível escalonar uma instância horizontalmente de uma das seguintes maneiras:
Escalonamento horizontal: aumenta a capacidade da instância, o que dá a ela mais memória e capacidade de processamento para lidar com um volume maior de dados ou tráfego. A capacidade da instância é determinada pelo número de fragmentos nela.
Ao escalonar horizontalmente sua instância, o aplicativo pode lidar com uma demanda maior sem degradação de desempenho. Para escalonar horizontalmente uma instância, adicione
fragmentos a ela.
Reduzir a escala: diminua a capacidade da instância, o que reduz o poder de processamento e a quantidade de memória disponível para armazenar dados. Isso acontece quando as demandas de dados do aplicativo diminuem e você precisa reduzir o uso de recursos para economizar custos. Para escalonar uma instância, reduza o número de fragmentos nela.
É possível mudar o tipo de nó da instância. Isso é chamado de escalonamento vertical.
É possível escalonar uma instância verticalmente de uma das seguintes maneiras:
Escalonar verticalmente: aumentar a capacidade da instância. A capacidade da instância é determinada pelo tipo de nó dela. Para aumentar a escala de uma instância,
mude o tipo de nó para um maior. Por exemplo, faça o escalonamento vertical da instância de um tipo de nó standard-small para um tipo de nó highmem-medium.
Redução vertical: diminua a capacidade da instância. Para reduzir uma instância, mude o tipo de nó para um menor. Por exemplo, reduza o escalonamento da instância de um tipo de nó highmem-medium para um tipo de nó standard-small.
Impacto do escalonamento
Durante uma operação de escalonamento, a disponibilidade da instância não é afetada.
No entanto, quando você muda o número de fragmentos na instância, o Memorystore para Valkey reequilibra o espaço de chaves da instância. Isso pode causar um aumento na latência durante a operação de escalonamento.
Além disso, o impacto do escalonamento vertical da instância ao mudar o tipo de nó
é semelhante ao que acontece com uma operação de manutenção.
Cenários de falha
Se você encontrar um erro durante a operação de escalonamento, provavelmente é devido a um dos seguintes cenários:
Você quer atualizar a contagem de fragmentos da sua instância, mas não tem memória livre suficiente para o tipo de nó shared-core-nano.
Para resolver esse problema, aumente a escala da instância ou libere memória dos nós dela. Para liberar memória, faça o seguinte:
Substitua IP_ADDRESS e PORT_NUMBER pelos valores que você anotou na etapa anterior.
Anote o endereço IP e o número da porta de um nó que não tem
espaço livre suficiente. O ID desse nó corresponde a um ID que aparece no erro.
Para se conectar a esse nó, use o seguinte comando:
valkey-cli -h IP_ADDRESS -p PORT_NUMBER
Substitua IP_ADDRESS e PORT_NUMBER pelos valores
anotados na etapa anterior.
No prompt, insira o comando info memory.
Na saída, aparecem valores para os parâmetros used_memory e maxmemory. used_memory é a quantidade de memória usada pelo nó, e maxmemory é a quantidade de memória disponível para ele.
Divida o valor do parâmetro used_memory pelo valor do parâmetro maxmemory e verifique se o quociente é maior que 98%.
Digite o comando info memory novamente. Na saída, o valor do parâmetro used_memory é menor.
Divida o valor do parâmetro used_memory pelo valor do parâmetro maxmemory e verifique se o quociente agora é menor que 98%.
Se não for, exclua mais chaves.
Para outros nós que não têm espaço livre suficiente, repita as etapas 4 a 11
deste procedimento.
Você fez o escalonamento para uma contagem de fragmentos menor que não tem capacidade para armazenar todas as chaves que o Memorystore para Valkey armazena na instância original. Para resolver isso, faça o escalonamento para uma contagem de fragmentos maior que possa
conter todas as chaves armazenadas. Para mais informações sobre como aumentar o número de
fragmentos da sua instância, consulte Aumentar a contagem de fragmentos.
Você fez o escalonamento para um tipo de nó menor que não tem capacidade para armazenar todos os dados que o Memorystore para Valkey armazena no tipo de nó original. Se isso acontecer, o Memorystore para Valkey vai fornecer um tipo de nó recomendado para reduzir escala vertical verticalmente.
Você atualizou o tipo de nó da instância e substituiu as configurações padrão do tipo de nó original ou essas configurações já foram substituídas. No entanto, o novo tipo de nó escalonado não é compatível com os valores das configurações padrão ou as configurações não são válidas para o tipo de nó. Se isso acontecer, o Memorystore para Valkey vai retornar um erro. Para resolver isso, modifique
as configurações manualmente para que sejam válidas para o novo tipo de nó.
Você escalonou a instância durante um período de alta pressão de gravação (por exemplo, durante um teste de carga). Para resolver isso, faça o escalonamento durante períodos de baixo tráfego de instâncias.
Práticas recomendadas
Para ajudar você a dimensionar a capacidade da instância e aumentar a velocidade e a confiabilidade do escalonamento, faça isso durante períodos de baixo tráfego, sempre que possível. Para saber como monitorar o tráfego da instância, consulte Monitorar instâncias.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# About scaling instance capacity\n\nThis page describes how your Memorystore for Valkey instance behaves\nduring scaling.\n\nYou can scale the capacity for your instance in the following ways:\n\n- You can change the number of shards for your instance. This is *horizontal\n scaling*. You can scale an instance horizontally in one of the following ways:\n\n - **Scale out**: increase the capacity of your instance, which gives the\n instance more memory and processing power to handle a larger volume of data or\n traffic. Your instance's capacity is determined by the number of shards in\n your instance.\n\n By scaling your instance out, your application can handle an increased\n demand without performance degradation. To scale an instance out, add\n shards to the instance.\n - **Scale in**: reduce the capacity of your instance, which decreases both the\n processing power and the amount of memory available to store data. This occurs\n when your application's data demands decrease and you need to lower your\n resource usage to save costs. To scale an instance in, reduce the number of\n shards in the instance.\n\n | **Note:** If you specify **Cluster Mode Disabled** when you [create an instance](/memorystore/docs/valkey/create-instances#create_an_instance), then Memorystore for Valkey doesn't partition the instance, but hosts it on a single shard. Therefore, horizontal scaling doesn't apply for the instance.\n- You can change the node type for your instance. This is *vertical scaling*.\n You can scale an instance vertically in one of the following ways:\n\n - **Scale up** : increase the capacity of your instance. Your instance's capacity is determined by your instance's node type. To scale an instance up, change the node type to a larger node type. For example, scale your instance up from a `standard-small` node type to a `highmem-medium` node type.\n - **Scale down** : reduce the capacity of your instance. To scale an instance\n down, change the node type to a smaller node type. For example, scale your\n instance down from a `highmem-medium` node type to a `standard-small` node\n type.\n\n | **Important:** If you want to scale the node type\n | for your instance down, and you haven't overwritten the default settings for\n | the original node type, then Memorystore for Valkey modifies\n | the default settings to those of the scaled node type.\n\n| **Note:** For more information about the different types and sizes of shards and nodes, see [Instance and node specification](/memorystore/docs/valkey/instance-node-specification). To learn more about scaling a Memorystore for Valkey instance, see [Scale instance capacity](/memorystore/docs/valkey/scale-instance-capacity).\n\nImpact of scaling\n-----------------\n\nDuring a scaling operation, the availability of your instance isn't impacted.\nHowever, when you change the number of shards in your instance, Memorystore for Valkey rebalances the instance's keyspace. This\nmight cause increased latency during the scaling operation.\n\nAlso, the impact of scaling your instance vertically by changing the node type\nis similar to what happens with a [maintenance](/memorystore/docs/valkey/about-maintenance) operation.\n\nFailure scenarios\n-----------------\n\nIf you encounter an error during the scaling operation, then it's likely because\nof one of the following scenarios:\n\n- You want to update the shard count for your instance, but you don't have\n enough free memory for the `shared-core-nano` node type for your instance.\n\n To resolve this issue, you can either [scale your instance up](/memorystore/docs/valkey/scale-instance-capacity#scale_the_node_type) or free memory from the nodes of\n your instance. To free memory, do the following:\n 1. [Connect to a Memorystore for Valkey instance](/memorystore/docs/valkey/connect-instance).\n 2. To get details about the instance, including the IP address and port number, use the [`gcloud memorystore instances describe`](/sdk/gcloud/reference/memorystore/instances/describe) command.\n 3. Make a note of the IP address and port number of the instance.\n 4. To get information about the nodes of the instance, use the following\n command:\n\n ```\n valkey-cli -h IP_ADDRESS -p PORT_NUMBER cluster nodes\n ```\n\n Replace \u003cvar translate=\"no\"\u003eIP_ADDRESS\u003c/var\u003e and \u003cvar translate=\"no\"\u003ePORT_NUMBER\u003c/var\u003e with the values that\n you noted in the previous step.\n 5. Make a note of the IP address and port number of a node that doesn't have\n enough free space. This node's ID matches an ID that appears in the error.\n\n 6. To connect to this node, use the following command:\n\n ```\n valkey-cli -h IP_ADDRESS -p PORT_NUMBER\n ```\n\n Replace \u003cvar translate=\"no\"\u003eIP_ADDRESS\u003c/var\u003e and \u003cvar translate=\"no\"\u003ePORT_NUMBER\u003c/var\u003e with the values\n that you noted in the previous step.\n 7. At the prompt, enter the `info memory` command.\n\n In the output, values for the `used_memory` and `maxmemory` parameters appear. `used_memory` is how much memory the node uses and `maxmemory` is how much\n memory is available for the node.\n 8. Divide the value of the `used_memory` parameter by the value of the\n `maxmemory` parameter, and verify that the quotient is greater than 98%.\n\n 9. To free up space for the node, [delete some of the node's keys](https://valkey.io/commands/del/).\n\n 10. Enter the `info memory` command again. In the output, the value of the\n `used_memory` parameter is smaller.\n\n 11. Divide the value of the `used_memory` parameter by the value of the\n `maxmemory` parameter, and verify that the quotient is now less than 98%.\n If it isn't, then delete more keys.\n\n 12. For any other nodes that don't have enough free space, repeat steps 4 - 11\n of this procedure.\n\n | **Caution** : We recommend that you use the `shared-core-nano` node type for development or testing purposes only. If you run Memorystore for Valkey in a production environment, then we recommend using the `standard-small`, `highmem-medium`, or `highmem-xlarge` node types. For more information about these node types, see [Choose a node type](/memorystore/docs/valkey/instance-node-specification#choose-node-type).\n- You scaled to a smaller shard count that doesn't have the capacity to hold\n all of the keys that Memorystore for Valkey stores in the\n original instance. To resolve this, scale to a larger shard count that can\n hold all of the stored keys. For more information about increasing the number of\n shards for your instance, see [Scale the shard count](/memorystore/docs/valkey/scale-instance-capacity#scale_the_shard_count).\n\n- You scaled to a smaller node type that doesn't have the capacity to hold all\n of the data that Memorystore for Valkey stores in the original\n node type. If this occurs, then Memorystore for Valkey\n provides you with a recommended node type to scale down vertically.\n\n- You updated the node type for your instance, and either you overwrite the\n default [settings](/memorystore/docs/valkey/supported-instance-configurations)\n for the original node type or these settings are overwritten already. However,\n the new, scaled node type either doesn't support the values for the\n default settings or the settings aren't valid for the node type. If this occurs,\n then Memorystore for Valkey returns an error. To resolve this, modify\n the settings manually so that they're valid for the new node type.\n\n- You scaled your instance during a period of high write pressure (for example,\n during load testing). To resolve this, scale during periods of low instance\n traffic.\n\n- You have a slot which contains a large key, and you want to migrate this key\n to another node. However, this node doesn't have sufficient memory to support\n the key. As a result, you can't update your instance. To resolve this, reduce\n the size of the key and retry the update operation.\n\n- The slot number that a node of an instance owns isn't known, but only the slot\n range is known. Memorystore for Valkey returns an error message. If this occurs,\n then reduce the size of the key and retry the update operation.\n\nBest practices\n--------------\n\nTo help you scale the capacity for your instance, and to increase the speed and\nreliability of scaling your instance, scale it during low periods of traffic,\nwhenever you can. To learn how to monitor instance traffic, see [Monitor instances](/memorystore/docs/valkey/monitor-instances)."]]
