Configurações do Memcached suportadas

Esta página fornece uma lista dos parâmetros de configuração do Memcached do Memorystore for Memcached modificáveis e não modificáveis, bem como os valores predefinidos dos parâmetros.

Parâmetros de configuração modificáveis

Pode modificar os seguintes parâmetros quando cria ou atualiza uma instância do Memorystore for Memcached. A atualização de parâmetros requer que altere e aplique os parâmetros em dois passos separados. Para mais informações sobre como alterar estas configurações, consulte o artigo Configurar instâncias do Memcached.

Parâmetro Valores aceitáveis Valor predefinido Descrição
listen-backlog (-b) 1-10000 1024 Comprimento ajustável da fila de pendências de ligação. O backlog é o número de pedidos de ligação de rede colocados em fila para serem processados pelo Memcached.
disable-flush-all (-F) true, false falso Se disable-flush-all for definido como true, o comando flush-all Memcached de código aberto é desativado. A modificação desta configuração incrementa o contador cmd_flush. No entanto, não ocorre realmente uma descarga.
disable-watch (-W) true, false falso Versão 1.6.15 ou posterior do Memcached. Se for definido como true, este parâmetro desativa a utilização de comandos do relógio. Os observadores permitem-lhe estabelecer ligação ao Memcached e inspecionar o que está a acontecer internamente. As obtenções, as mutações, os eventos de ligação, etc., podem ser observados através de watch <fetchers|mutation|evictions|connevents|deletions>.
max-item-size (-I) 524288-134217728 (bytes) 1048576 O parâmetro Memcached max-item-size define o limite de tamanho máximo para os itens armazenados na instância. Está sujeita a algumas restrições adicionais:
  • max-item-size tem de ser igual ou superior a slab_chunk_max. slab_chunk_max está definido como 524 288 bytes (512 KiB), e o Memorystore para Memcached não suporta a alteração deste valor. Por conseguinte, o valor mínimo de max-item-size é de 524 288 bytes, em oposição ao mínimo suportado pelo Memcached de código aberto (1024 bytes).
  • max-item-size tem de ser divisível por slab_chunk_max (524288 bytes).
  • max-item-size não pode ser superior a metade do tamanho total alocado da cache (o parâmetro -m).
slab-min-size (-n) 1-1024 (bytes) 48 Define o tamanho mínimo do item e o tamanho da menor placa do Memcached.
slab-growth-factor (-f) 1,01-100,00 1,25 slab-growth-factor é o multiplicador usado para calcular o tamanho dos blocos/placas do Memcached. Diminuir este valor pode melhorar a eficiência da utilização de memória, mas depende do tamanho dos itens a armazenar e da memória disponível da instância.
protocol (-B) auto, ascii automático O protocolo de associação. Designa o protocolo que os clientes que tentam estabelecer ligação ao servidor têm de usar. O Auto suporta o protocolo binário e ASCII.
disable-cas (-C) true, false falso Se disable-cas estiver definido como true, as operações de verificação e definição (CAS) estão desativadas. A desativação das operações CAS usa menos 8 bytes para cada item na cache. O Memcached usa a operação CAS para atualizar os dados de um item se não tiverem sido atualizados desde a última obtenção.
disable-evictions (-M) true, false falso Se estiver definido como true, quando não houver memória, o Memcached devolve um erro em vez de remover itens. A instância não aceita gravações até que a memória fique disponível.
max-reqs-per-event (-R) 1-1000 20 Limita o número de pedidos por evento que uma única ligação de cliente pode fazer. Depois de o cliente exceder este valor, o servidor dá prioridade a outros clientes antes de continuar a processar o pedido do cliente original.
reserved-memory-percent 0,0 a 50,0 10,0 Define a memória reservada da instância para a percentagem especificada para aumentar a quantidade de espaço disponível para a sobrecarga de memória. Esta definição também reduz a memória da cache na mesma percentagem. As instâncias criadas antes de 25 de outubro de 2021 têm um valor predefinido de 0. Para mais informações, consulte o artigo Práticas recomendadas de gestão de memória.

Opções alargadas suportadas

Parâmetro Valores aceitáveis Valor predefinido Descrição
track_sizes true, false falso (desativado) Se track-sizes estiver definido como true, os utilizadores podem executar o comando Memcached stats sizes. Não recomendamos a ativação desta configuração em ambientes de produção.
watcher_logbuf_size 0-2097151 (kibibytes) 262144 O tamanho da memória intermédia de gravação por visitante ativo associado. A alteração desta configuração ajusta o tamanho do buffer de registo do comando watch. Para evitar perder registos, aumente o watcher_logbuf_size quando estiver cheio.
worker_logbuf_size 48-524288 (kibibytes) 65536 Controla o tamanho da memória intermédia para cada trabalhador ativo. O processo em segundo plano lê a partir destes buffers.
lru_crawler true, false true (ativado) A configuração lru_crawler ativa um processo em segundo plano que analisa as páginas e remove os itens usados menos recentemente (LRU) dessas páginas. Este processo não requer muita CPU nem memória. Uma vez que está ativado, o processo é executado no momento do lançamento até definir lru_crawler como false.
idle_timeout 0 a 86 400 segundos 0 (desativado) A predefinição é 0 (desativado). Esta configuração define o tempo em segundos que os clientes podem ficar inativos antes de expirar o tempo limite e serem desligados.
lru_maintainer true, false true (ativado) Ativada por predefinição. lru_maintainer é um processo em segundo plano que determina a antiguidade do acesso aos itens para os ordenar corretamente por "menos usados recentemente" (lru).
maxconns_fast true, false falso (desativado) Gerencia a forma como o Memcached processa novas ligações quando é atingido o número máximo de clientes. Quando maxconns-fast está definido como false, as associações que excedem o limite máximo de associações são adicionadas a uma fila. Quando maxconns-fast está definido como true, as ligações que excedem o limite máximo de ligações são ignoradas e é apresentada uma mensagem de erro.
hash_algorithm jenkins, murmur3, xxh3 murmur3 Designa o algoritmo hash que a instância usa. Apenas as instâncias que usam a versão 1.6.15 ou superior do Memcached podem usar a configuração xxh3.

Parâmetros de configuração não modificáveis

A tabela seguinte apresenta os parâmetros de configuração do Memcached que não pode modificar com o Memorystore para Memcached e os valores predefinidos dos parâmetros. Para mais detalhes, consulte a lista de parâmetros de configuração do Memcached nativo.

Parâmetro Valor predefinido
porta (-p) 11211
memory-limit (-m) O Memorystore define este valor para corresponder à memória configurada para cada nó na configuração do nó da instância. Esta configuração não é modificável. No entanto, pode adicionar memória reservada com a configuração de memória reservada indicada acima.
threads (-t) O Memorystore define este valor para corresponder ao número de CPUs de cada nó de instância.
conn-limit (-c) 65 000 por nó
verboso (-v) verdadeiro
slab_automove true (ativado)
slab_reassign true (ativado)
enable-largepages (-L) falso (desativado)
lock-memory (-k) falso (desativado)
expirezero-does-not-evict Não suportado. Descontinuado no Memcached 1.4.35.
slab_chunk_max 524288 bytes
moderno true (ativado)

O que se segue?