mcpField
Q
qdrant-minimize-latency

qdrant-minimize-latency

github.com/qdrantデータ・データベース26541 回インストール1 日前に更新
リポジトリ

qdrant-minimize-latency について

qdrant-minimize-latencyは、単一クエリのレイテンシ削減に重点を置くQdrant向けの調整スキルです。セグメント数、メモリ内インデックス、クエリ設定、ストレージ、RAM管理を扱い、スループット最適化との違いも示します。

主な機能

  1. 01CPUコア数に合わせたセグメント調整
  2. 02量子化ベクトルとHNSWをRAMに保持
  3. 03再現率と引き換えにクエリを高速化
  4. 04ローカルNVMeストレージの利用
  5. 05RAM圧迫とバックグラウンド索引の管理

活用シーン

  1. 01単一クエリ処理のレイテンシ削減
  2. 02RAMに起因する遅延悪化の調査
  3. 03索引作成のピーク時間帯にQdrantを調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/qdrant/skills --skill qdrant-minimize-latency

インストール後、Claude Code で/qdrant-minimize-latencyを入力して読み込まれたか確認します。

詳細

クエリレイテンシのスケーリング

単一のクエリのレイテンシは、クエリ実行パス内で最も遅いコンポーネントによって決まります。スループットと相関することもありますが、常にそうとは限りません。スループットとレイテンシは、反対方向のチューニング目標です。

低レイテンシの最適化では、単一のクエリでリソースを最大限に活用することを目指します。一方、スループットの最適化では、並列に実行できるクエリ数を増やすため、クエリあたりのリソース使用量を最小限に抑えることを目指します。

レイテンシを下げるためのパフォーマンスチューニング

メモリ不足とレイテンシ

レイテンシにとって、RAM は最も重要なリソースです。ワーキングセットが利用可能な RAM を超えると、OS キャッシュの退避によって、深刻かつ継続的なレイテンシの低下が発生します。

  • まず RAM を垂直スケーリングで増やします。ワーキングセットが 80% を超える場合は特に重要です。
  • 量子化を使用します。スカラー量子化では 4 倍、バイナリー量子化では最大 32 倍削減できます[量子化](https://skills.qdrant.tech/md/documentation/manage-data/quantization/)
  • フィルタリングの頻度が低い場合は、ペイロードインデックスをディスクに移します。Qdrant 1.19 以降では memory: cold、1.18 以前では on_disk: true を指定します[ディスク上のペイロードインデックス](https://skills.qdrant.tech/md/documentation/manage-data/indexing/?s=on-disk-payload-index)
  • optimizer_cpu_budget を設定して、バックグラウンド最適化で使用する CPU を制限します
  • インデックス作成をスケジュールします。ピーク時間帯は indexing_threshold を高く設定します

レイテンシを抑えるための垂直スケーリング

RAM を増やし、CPU を高速化すると、レイテンシを直接削減できます。ノードのサイジングのガイドラインについては、[垂直スケーリング](../scaling-data-volume/vertical-scaling/SKILL.md)を参照してください。

避けるべきこと

  • 同じノードでレイテンシとスループットを同時に最適化できると期待しないでください
  • レイテンシに敏感なワークロードで、少数の大きなセグメントを使用しないでください(セグメントごとの検索に時間がかかります)
  • RAM 使用率を 90% 超にしないでください(キャッシュの退避による深刻なレイテンシ低下が数日続くことがあります)
  • パフォーマンスのデバッグ時に、オプティマイザーの状態を無視しないでください
  • 負荷テストをせずに RAM を減らさないでください(キャッシュの退避によって、レイテンシの問題が数日続くことがあります)

コメント