qdrant-performance-indexing-optimization

name	qdrant-performance-indexing-optimization
description	Diagnoses and fixes slow Qdrant indexing and data ingestion. Use when someone reports 'uploads are slow', 'indexing takes forever', 'optimizer is stuck', 'HNSW build time too long', or 'data uploaded but search is bad'. Also use when optimizer status shows errors, segments won't merge, or indexing threshold questions arise.

What to Do When Qdrant Indexing Is Too Slow

Qdrant does NOT build HNSW indexes immediately. Small segments use brute-force until they exceed indexing_threshold_kb (default: 20 MB). Search during this window is slower by design, not a bug.

• Understand the indexing optimizer Indexing optimizer

Uploads/Ingestion Too Slow

Use when: upload or upsert API calls are slow. Identify bottleneck: client-side (network, batching) vs server-side (CPU, disk I/O)

For client-side, optimize batching and parallelism:

• Use batch upserts (64-256 points per request) Points API
• Use 2-4 parallel upload streams

For server-side, optimize Qdrant configuration and indexing strategy:

• Create more shards (3-12), each shard has an independent update worker Sharding
• Create payload indexes before HNSW builds (needed for filterable vector index) Payload index

Suitable for initial bulk load of large datasets:

• Disable HNSW during bulk load (set indexing_threshold_kb very high, restore after) Collection params