Add query-rate windows (QPS) to /status recent_queries

オープン
#286 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
45/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
静か
技術スタック
python
領域
observability

調査の方向性

Read #231, #253, and #268 to understand the existing recent_queries implementation, the earlier timestamped query_log design, and the clock issue. Locate the /status handler and query tracking code, then check their tests. Done means recent_queries reports the requested rate windows, inter-arrival statistics, history span, and time since the last query using wall-clock timestamps.

索引モデルが issue の本文から書いたものです。

説明

performance

#231 adds recent_queries with mean and end-to-end p50/p95/p99 latency, but deliberately does not carry over the rate-tracking from #253:

  • queries_last_10s / _60s / _300s and the matching queries_per_second_*
  • inter_arrival_ms (mean/median/min/max/p95)
  • history_span_seconds, time_since_last_query_seconds

Reason for deferring: percentiles need only durations (which recent_query_times already stores), but rate windows need a timestamp per query, i.e. reverting recent_queries to #253's (timestamp, duration) query_log design. That is a real design change rather than a few lines, so it was left out of #231.

Value: it directly answers "is Solr slow because it is overloaded, or because something is wrong with it?" — currently approximated via solr_metrics.host.system_load_average / system_cpu_load and by sampling query_handler.requests twice.

If implemented, note #268's finding that perf_counter_ns is monotonic-since-boot and produced a nonsense time_since_last_query_seconds: 1.7e9 in production — use wall-clock time.time() for the timestamps.

主要言語
Python
スター
5
フォーク
4
PR マージ指標
30日以内にマージされた PR はありません

環境構築

  • Dockerfile または Docker Compose ファイルあり
  • プルリクエストのテンプレートなし
  • コントリビューションガイドなし

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

NCATSTranslator/NameResolution のほかの issue

NCATSTranslator/NameResolution の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。