qdrant-scaling-qps
Ajuda seu agente a fazer o Qdrant responder mais rápido a buscas. É útil quando você precisa processar muitas consultas por segundo.
O que ela faz
Este guia ajuda a aumentar a quantidade de buscas que o Qdrant consegue fazer por segundo. Ele foca em otimizar o sistema para lidar com mais requisições simultâneas, o que é diferente de fazer cada busca individualmente mais rápida.
Quando usar
- ✓Quando você precisa que seu sistema responda a mais buscas ao mesmo tempo.
- ✓Se as buscas estão lentas porque muitas pessoas estão usando o sistema de uma vez.
- ✓Ao configurar o Qdrant para lidar com um grande volume de requisições.
Exemplo do que pedir para a IA
“Como faço para o Qdrant aguentar mais buscas por segundo?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Para aumentar o número de buscas por segundo, você pode ajustar configurações para que o Qdrant use menos recursos em cada busca individual, como agrupar buscas ou usar menos partes do banco de dados por vez. Se isso não for suficiente, você pode adicionar mais máquinas para dividir o trabalho.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add github/awesome-copilot --skill qdrant-scaling-qpsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/qdrant-scaling/scaling-qps/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Escalando para Vazão de Consultas (QPS)
Escalar a vazão significa lidar com mais consultas paralelas por segundo. Isso é diferente de latência - vazão e latência são direções de ajuste opostas e não podem ser otimizadas simultaneamente no mesmo nó.
Alta vazão favorece segmentos menores e mais numerosos para que cada consulta toque menos sobrecarga.
Ajuste de Desempenho para RPS Mais Alto
- Use menos segmentos, maiores (
default_segment_number: 2) Maximizando a vazão - Habilite a quantização com
always_ram=truepara reduzir o IO de disco Quantização - Use a API de busca em lote para amortizar a sobrecarga Busca em lote
Minimizar o Impacto de Cargas de Trabalho de Atualização
- Configure o controle de vazão de atualização (v1.17+) para evitar que buscas não otimizadas degradem leituras Busca de baixa latência
- Defina
optimizer_cpu_budgetpara limitar as CPUs de indexação (por exemplo,2em um nó de 8 CPUs reserva 6 para consultas) - Configure o fan-out de leitura atrasado (v1.17+) para latência de cauda Fan-outs atrasados
Escala Horizontal para Vazão
Se um único nó estiver saturado de CPU após aplicar o ajuste acima, escale horizontalmente com réplicas de leitura.
- Réplicas de shard atendem consultas de shards replicados, distribuindo a carga de leitura entre os nós
- Cada réplica adiciona capacidade de consulta independente sem re-shard
- Use
replication_factor: 2+e direcione leituras para réplicas Implantação distribuída
Veja também Escala Horizontal para orientação geral sobre escala horizontal.
Gargalos de I/O de Disco
Se não for possível manter todos os vetores na RAM, o I/O de disco pode se tornar o gargalo para a vazão. Neste caso:
- Atualize para IOPS provisionado ou NVMe local primeiro. Veja o impacto do desempenho do disco na busca de vetores no artigo de desempenho de disco
- Use
io_uringno Linux (kernel 5.11+) artigo io_uring - No caso de vetores quantizados, prefira o re-scoring global em vez do re-scoring por segmento para reduzir leituras de disco. Exemplo no tutorial
- Configure um número maior de threads de busca para paralelizar leituras de disco. O padrão é
cpu_count - 1, que é ideal para busca baseada em RAM, mas pode ser muito baixo para busca baseada em disco. Veja referência de configuração - Se ainda saturado, escale horizontalmente (cada nó adiciona IOPS independentes)
O Que NÃO Fazer
- Não espere otimizar vazão e latência simultaneamente no mesmo nó
- Não use muitos segmentos pequenos para cargas de trabalho de vazão (aumenta a sobrecarga por consulta)
- Não escale horizontalmente quando limitado por IOPS sem também atualizar o nível do disco
- Não execute com mais de 90% de RAM (evicção de cache do SO = degradação severa de desempenho)
Perguntas frequentes
Qual a diferença entre velocidade da busca (latência) e quantidade de buscas por segundo (throughput)?
Latência é o tempo que uma única busca leva para ser respondida. Throughput é quantas buscas o sistema consegue responder em um segundo. Otimizar um pode piorar o outro.
O que são 'segmentos' e por que ter menos é melhor para mais buscas por segundo?
Segmentos são como arquivos onde os dados são organizados. Ter menos segmentos, mas maiores, significa que o Qdrant precisa acessar menos arquivos para cada busca, o que é mais eficiente quando o objetivo é responder a muitas buscas rapidamente.
O que é 'escala horizontal'?
Escala horizontal significa adicionar mais máquinas (ou instâncias do Qdrant) para distribuir o trabalho. Isso é útil quando uma única máquina não consegue mais lidar com todas as requisições, mesmo após otimizações.
Detalhes
Descrição original do autor
Guides Qdrant query throughput (QPS) scaling. Use when someone asks 'how to increase QPS', 'need more throughput', 'queries per second too low', 'batch search', 'read replicas', or 'how to handle more concurrent queries'.
repo: github/awesome-copilot
Popularidade
- Estrelas no GitHub
- 40 mil
- Posição no ranking
- #5313
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
acquire-codebase-knowledge
Ajuda seu agente a entender e documentar um projeto de código existente. É útil para novas pessoas entrarem no projeto ou para ter uma visão geral da arquitetura.
github/awesome-copilot
acreadiness-assess
Faz seu agente avaliar a prontidão de um projeto para IA e gerar um relatório. É útil para entender o quão bem um projeto está preparado para usar ferramentas de IA.
github/awesome-copilot
acreadiness-generate-instructions
Ajuda seu agente a criar instruções para ferramentas de IA baseadas em uma avaliação. É útil para melhorar a forma como a IA interage com o código e fecha lacunas identificadas.
github/awesome-copilot
acreadiness-policy
Faz seu agente ajudar a definir ou aplicar políticas para avaliação de projetos de IA. É útil para padronizar a forma como os projetos são avaliados e garantir conformidade.
github/awesome-copilot
Skills parecidas
clickhouse-io
Ajuda seu agente a otimizar consultas e esquemas no banco de dados ClickHouse. Ele aplica as melhores práticas para cargas de trabalho analíticas de alta performance. Use quando consultas analíticas demoram muito.
affaan-m/ECC
scientific-db-pubmed-database
Ajuda seu agente a buscar artigos científicos na área biomédica. É útil para pesquisas que precisam de informações médicas específicas.
affaan-m/ECC
scientific-db-uspto-database
Permite ao agente consultar dados oficiais de patentes e marcas registradas dos EUA. É útil para pesquisas de propriedade intelectual.
affaan-m/ECC