Elasticsearch:Use o plug-in de limitação de cluster (aliyun-qos)

Versão V7.10 mais recente

Outras versões

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.limiter.enabled": true
  }
}

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.ratelimit.enabled": "true"
  }
}

Método

Versão V7.10 mais recente

Outras versões

Definir o parâmetro limiter como false

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.limiter.enabled": false
  }
}

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.ratelimit.enabled": "false"
  }
}

Definir o parâmetro limiter como null

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.limiter.enabled": null
  }
}

PUT _cluster/settings
{
  "persistent": {
    "apack.qos.ratelimit.enabled": null
  }
}

Parâmetro

Descrição

Valor

action

A ação a ser limitada. Utilizada para restringir diferentes tipos de solicitações.

• write: solicitações de gravação de documentos, incluindo operações index e create.

• update: solicitações de atualização de documentos.

• delete: solicitações de exclusão de documentos.

• search: solicitações de consulta.

• search_shards: solicitações para consultar o número total de shards de um índice.

limiter_type

O tipo de limitação. Três categorias são suportadas: taxa, concorrência e limites por solicitação.

• rate: limite de taxa. Aceita apenas números inteiros.

• qps: taxa de consultas. Aceita apenas números inteiros.

• tps: taxa de gravação. Aceita apenas números inteiros.

• throughput: throughput de dados. Suportado apenas para ações write, update e delete. As unidades incluem GB, MB e KB. O valor máximo é 2 GB.

• thread_count: limita o número de solicitações simultâneas.

• concurrent_count: concorrência de solicitações, calculada com base nas operações específicas de uma solicitação. Por exemplo, search_shards.concurrent_count:20 permite no máximo 20 consultas simultâneas a shards.

• max_per_request: número máximo de operações de determinado tipo dentro de uma única solicitação. Por exemplo, update.max_per_request:10 permite no máximo 10 operações de atualização em uma única solicitação Bulk.

• max_size_per_request: tamanho máximo de uma única solicitação. Suportado apenas para ações write, update e delete.

threshold

O limiar de limitação.

Um número inteiro maior ou igual a -1.

Alguns tipos aceitam strings com unidades. Para mais detalhes, consulte a descrição de limiter_type.

tagName

O nome da tag.

• node: nome do nó atual.

• is_master: indica se o nó atual é um nó mestre. O valor correspondente da tag é true ou false.

• index: nome do índice. Para múltiplos índices, use um array. Se um alias for fornecido, ele será resolvido para o nome real do índice. Esta tag está disponível apenas para subclasses de IndicesRequest.

• shard: nome do shard, no formato index[id], por exemplo, test[0]. Esta tag está disponível apenas para subclasses de ReplicationRequest.

• index_in_url: string do índice extraída da URL. Se um alias for fornecido, esta tag preserva o alias. Disponível apenas para subclasses de IndicesRequest.

tagValue

O valor da tag.

Uma string ou um array de strings. Ao usar um array, a tag corresponde a qualquer valor contido nele. São suportadas correspondência exata, correspondência por prefixo com curinga e todos os valores. Exemplos:

• Correspondência exata: "abc"

• Correspondência por prefixo: "ab*"

• Todos os valores: "**"

  O uso de um valor curinga define um limitador padrão, o que significa que um limitador específico é gerado para qualquer valor dessa tag. Por exemplo, ao especificar index:"**",search.tps:1, a taxa de pesquisa de cada índice é limitada a 1 por padrão, em vez de limitar a taxa total de pesquisa a 1.

priority

A prioridade do limitador.

Um número inteiro. Valor padrão: 0.

Um valor maior indica maior prioridade. Quando uma solicitação corresponde a vários limitadores padrão, apenas aquele com a maior prioridade entra em vigor.

params

Parâmetros avançados.

watchMode: especifica se o modo de observação deve ser ativado. Valores válidos: true e false (padrão). Quando definido como true, o Elasticsearch registra as contagens de solicitações rejeitadas nas métricas, mas não aplica os limites. Isso permite visualizar o efeito de uma regra antes de aplicá-la, evitando configurações incorretas. Para mais informações sobre as APIs, consulte a seção de perguntas frequentes.

Ações

Versão V7.10 mais recente

Outras versões

Obter todas as configurações de limitador

GET /_qos/limiter

GET /_qos/_ratelimit

Obter uma única configuração de limitador especificada

GET /_qos/limiter/<limiterName>

GET /_qos/_ratelimit/<limiterName>

Obter múltiplas configurações de limitador especificadas. Separe os nomes dos limitadores com vírgulas (,). Curingas não são suportados.

GET /_qos/limiter/<limiterName1,limiterName2>

GET /_qos/_ratelimit/<limiterName1,limiterName2>

Ações

Versão V7.10 mais recente

Outras versões

Excluir uma única configuração de limitador especificada

DELETE /_qos/limiter/<limiterName>

DELETE /_qos/_ratelimit/<limiterName>

Excluir múltiplas configurações de limitador especificadas. Separe os nomes dos limitadores com vírgulas (,). Curingas não são suportados.

DELETE /_qos/limiter/<limiterName1,limiterName2>

DELETE /_qos/_ratelimit/<limiterName1,limiterName2>