メトリッククイックリファレンス

このページでは、トラフィック制御フローの段階別に構成されたNetFUNNELのリアルタイムモニタリングおよび統計で使用されるすべてのメトリックに関する包括的なクイックリファレンスを提供します。各メトリックの意味と全体のトラフィック制御プロセスでの位置を迅速に理解するために使用してください。

トラフィック制御フロー概要

次のダイアグラムは、全体のトラフィック制御フローと各メトリックが測定される位置を示します：

トラフィックフローの段階別メトリック

ステップ1: リクエスト到着

メトリック	リアルタイムモニタリング	統計	単位
進入リクエスト量	デフォルト: 進入リクエスト量 クラシック: 進入リクエスト量	進入リクエスト	TPS
すべてのリクエスト量	(表示されない)	全体リクエスト数	TPS

進入リクエスト量:

• 定義: 1秒あたりの平均進入リクエスト数で、特定の時間ウィンドウ内で1秒あたりのリクエスト数(TPS)で測定されます
• 簡単に言うと: 1秒に平均的に何人のユーザーがサービスに初めてアクセスしようと試みたかを示します
• わかること: NetFUNNELがなかった場合に実際にサービスに到達した純粋なトラフィック量を推定でき、トラフィック制御が適用される前の純粋な需要を把握するのに役立ちます
• 解釈: 高い値は、多くのユーザーが同時にサービスにアクセスしようとしていることを示します。このメトリックはトラフィックの需要側面を表します - サービスを使用しようとする人数。各リクエストは、待機室が適用されたサービスに進入しようとする新しいユーザーを表します
• 主要なインサイト: これはシステムに入る生の需要です。高い値は、より多くの同時アクセス試行を意味します。これらのリクエストの一部は、進入許容数の閾値未満であれば待機室を迂回でき、進入許容数を超過すると他のリクエストは待機室に移動します

すべてのリクエスト量:

⚠️ 重要: 範囲が異なる2つの「全体リクエスト数」メトリックがあります：

1. プロジェクト/セグメントレベル全体リクエスト数:

   • 定義: NetFUNNELエージェントが作成したすべてのトラフィック制御API呼び出しの平均TPS。これには以下が含まれます: 初期進入リクエスト、再進入リクエスト、Alive Noticeリクエスト、完了リクエスト
   • 簡単に言うと: アプリケーションとNetFUNNELサーバー間の総トラフィック制御通信量を示します
   • わかること: 全体のトラフィック制御通信負荷を理解し、トラフィック制御運用のための容量計画を立てるのに役立ちます

2. NetFUNNELサーバーレベル全体リクエスト数:

   • 定義: NetFUNNELサーバーに対するすべてのタイプのAPIリクエストの平均TPSで、トラフィック制御リクエスト、データクエリリクエスト、管理APIリクエスト、およびその他のすべてのAPI呼び出しを含みます
   • 簡単に言うと: NetFUNNELサーバーがすべての作業で1秒あたりに処理する総リクエスト数を示します
   • わかること: サーバーエンジニアの観点から総システム負荷を把握でき、NetFUNNELサーバーレベルですべてのAPI呼び出しおよびトラフィック制御作業を含む全体のワークロードを理解するのに役立ちます

核心事項:

• リアルタイム: 現在の需要表示 - 今何人のユーザーが進入を試みているか
• 統計: 初期進入リクエストの過去平均表示

ステップ2: 進入許容数の決定

メトリック	リアルタイムモニタリング	統計	単位
進入許容数	進入許容数	進入許容	-
現在のユーザー数	デフォルト: 現在のユーザー数 クラシック: 現在のユーザー数	ユーザー	名
現在の使用率	デフォルト: 現在の使用率 クラシック: 現在の使用率	(表示されない)	%

進入許容数:

• 定義: サービスの同時アクティブユーザー数を制限する設定された制限値で、測定時点のスナップショットとして表示されます
• 簡単に言うと: サービスに同時に使用できる最大ユーザー数を表し、どの時点でも許可される最大同時ユーザー数を示します
• わかること: 他のメトリックが記録されたときに適用されていた容量制限値を把握でき、容量調整決定に必要なコンテキストを提供します

現在のユーザー数:

• 定義: サービス進入とサービス終了の間でサービスを実際に積極的に使用しているユーザー数で、測定時点のスナップショット値として表示されます
• 簡単に言うと: 測定時点に実際にサービスを使用中のユーザー数を示します
• わかること: 進入許容数と実際のユーザー数を比較して現在の容量活用度を評価でき、容量調整が必要かどうかを判断するのに役立ちます
• 計算: リクエストがPASSを受け、サービスに進入するときに**+1**、リクエストがサービスを終了するときに**-1**（明示的なキー返却）
• 重要な関係: この値は進入許容数と直接関連しています。NetFUNNELの核心原則は、現在のユーザー数を進入許容数未満に維持することです。現在のユーザー数が進入許容数に接近すると、NetFUNNELはPASS応答の発行を停止し、代わりにWAIT応答を送信してリクエストを待機室に送ります

現在の使用率:

• 定義: 現在使用中の進入許容数の割合で、測定時点に（現在のユーザー数 / 進入許容数 × 100）で計算されます
• 簡単に言うと: 許可された最大容量の何パーセントが現在アクティブユーザーによって使用されているかを示します
• わかること: 容量活用効率を評価でき、高い割合は制限がほぼ満杯であることを示し、低い割合は追加のユーザーを受け入れることができる余裕容量があることを知らせます
• 解釈: 100%は進入許容数が完全に活用されていることを意味し、~80%は進入許容数が100%に近いか100%である可能性を示します（モニタリング解像度の制限により）。50%は約半分の進入許容数が利用可能であることを意味し、<50%はかなりの進入許容数が利用可能であることを意味します
• モニタリング解像度の考慮事項: NetFUNNELサーバーは非常に多くのリクエストをリアルタイムで高速に処理します。モニタリングシステムの解像度がこの高速処理速度に追いつけない場合があります。したがって、現在のユーザー数の割合が約80%に見える場合、20%の余裕進入許容数があると解釈せず、システムが100%進入許容数に近いか100%で動作している可能性が高いと解釈する必要があります

モニタリング解像度の制限

NetFUNNELの高速リクエスト処理により、モニタリング解像度がすべての高速状態変更をキャプチャできない場合があります。現在のユーザー数の割合80%は、効果的に100%進入許容数活用として処理する必要があります。それに応じて進入許容数の調整を計画してください。

核心事項:

• NetFUNNELは現在のユーザー数と進入許容数を比較してPASSまたはWAITを決定
• 現在のユーザー数 < 進入許容数 → PASS（直接進入）
• 現在のユーザー数 ≥ 進入許容数 → WAIT（待機室に移動）

ステップ3: 待機室

メトリック	リアルタイムモニタリング	統計	単位
待機 ユーザー数	デフォルト: 待機 ユーザー数 クラシック: 待機 ユーザー数	待機者	名
待機時間	デフォルト: 待機時間 クラシック: 待機時間	待機時間	秒
待機状態	デフォルト: 待機状態 クラシック: 待機状態	(表示されない)	—
予想離脱ユーザー数	デフォルト: 予想離脱ユーザー数 クラシック: 予想離脱ユーザー数	(表示されない)	名

待機 ユーザー数:

• 定義: 待機室で待機中のユーザー数の平均値で、特定の時間ウィンドウ内で計算されます
• 簡単に言うと: 測定期間中、平均的に何人のユーザーが待機室で待機していたかを示します
• わかること: システムに対する需要圧力をモニタリングでき、待機中のユーザー数の変化を追跡して容量調整が必要かどうかを判断し、待機時間を短縮するのに役立ちます
• 解釈: これは現在の待機 ユーザー数であり、過去平均ではありません。高い値が必ずしも問題を意味するわけではありません - 待機時間と一緒に考慮してください。進入リクエスト量が利用可能な進入許容数（進入許容数 - 現在のユーザー）を超過すると、待機 ユーザー数が増加します
• 他のメトリックとの関係: 待機 ユーザー数は進入リクエスト速度（需要）の影響を受け、進入許容数によって制限されます。全体像のために待機時間と一緒に評価される必要があります
• 予想離脱ユーザー数の参照: 待機 ユーザー数には、ブラウザを閉じたか接続が切断されたユーザー（予想離脱ユーザー数）が含まれます。実際に活発に待機中のユーザー数は、おおよそ（待機 ユーザー数 - 予想離脱ユーザー数）です。進入許容数計画決定のために待機 ユーザー数を解釈する際、予想離脱ユーザー数を考慮してください

待機 ユーザー数の解釈

待機 ユーザー数が高いだけでは問題を示しません。待機時間と一緒に考慮してください。待機 ユーザー数が大きくても待機時間が短ければ、ユーザーは長く待機しません。両方とも高い場合は、進入許容数を増やす必要があるかもしれません。

待機時間:

• 定義: 待機室で待機中のすべてのユーザーが経験した待機時間の平均値で、特定の時間ウィンドウ内で計算されます
• 簡単に言うと: 測定期間中、ユーザーが平均的に何秒間待機したかを示します
• わかること: ユーザー体験を評価でき、待機時間が許容可能なレベルかどうかを判断し、進入許容数が需要に対して低すぎる設定になっているかを識別するのに役立ちます
• 解釈: このメトリックはユーザー体験の品質を表します - ユーザーが待機しなければならない時間。全体の文脈のために待機 ユーザー数と一緒に評価される必要があります。低い値は一般的により良いユーザー体験を示します
• 運用考慮事項: NetFUNNELはサーバーの内部状態（CPU、メモリ、I/O負荷）を直接モニタリングしません。代わりに間接指標を使用します。高い待機 ユーザー数および高い待機時間を観察するが、サーバーリソースが実際には未活用状態である場合、これは進入許容数が低すぎる設定になっている可能性を示唆します。より多くのトラフィックを受け入れる進入許容数がありますが、「ゲート」が狭すぎます。進入許容数を10-20%増加させることを検討してください

待機 ユーザー数 vs 待機時間

常に待機 ユーザー数と待機時間を一緒に考慮してください：

• 大きな待機 ユーザー数 + 短い待機時間 = 多くのユーザーだが迅速な処理
• 大きな待機 ユーザー数 + 長い待機時間 = 進入許容数が低すぎる設定の可能性（進入許容数の問題の可能性が高い）
• 小さな待機 ユーザー数 + 長い待機時間 = 進入許容数が保守的に低すぎる設定の可能性（非常に高い）

待機状態:

• 定義: 平均待機時間を事前定義された閾値基準で3つの状態レベル（Fast/Medium/Slow）に分類する視覚的インジケーター
• 簡単に言うと: 待機時間を円滑（Fast）/待機（Medium）/遅延（Slow）の3つの状態に分けて、迅速な状態概要を提供します
• わかること: 具体的な時間値を解釈する必要なく、待機条件に関する即座の視覚的インサイトを提供し、システムパフォーマンスを迅速に評価できます

予想離脱ユーザー数:

• 定義: 待機室に入室した後、ブラウザを閉じたか接続が切断されたユーザー数で、測定時点のスナップショット値として表示されます
• 簡単に言うと: 待機 ユーザー数に含まれるが、実際には待機していないユーザー数を示します
• わかること: 報告された待機 ユーザー数と実際に活発に待機中のユーザー数の違いを理解でき、より正確な進入許容数計画および待機列管理決定を下すのに役立ちます

ステップ4: サービス進入

メトリック	リアルタイムモニタリング	統計	単位
進入量	デフォルト: 進入量 クラシック: 進入量	(表示されない)	TPS

進入量:

• 定義: 1秒あたりの平均サービス進入ユーザー数で、特定の時間ウィンドウ内で1秒あたりのリクエスト数(TPS)で計算されます
• 簡単に言うと: 待機を経て入ってくるか、すぐに入場するかに関わらず、1秒あたり何人が実際にサービスに入場するかを示します
• わかること: NetFUNNELの効果を測定でき、実際のサービス進入速度（進入量）を初期需要（進入リクエスト量）と比較して、どれだけのトラフィック削減が達成されたかを把握するのに役立ちます
• 主要な違い: 進入リクエスト量は進入しようとするすべての試行（NetFUNNEL処理前）を表し、進入量はPASSを受け、サービスに進入するリクエストのみ（NetFUNNEL処理後）を表します
• 進入量の源泉: 進入量は2つの経路を通じて進入するリクエストを含みます: 1) 直接進入 - 即座にPASSを受ける初期リクエスト（進入許容数未満の場合）、2) 再進入 - 待機後にPASSを受ける待機室のリクエスト
• このメトリックが重要な理由: サービスが受ける実際の負荷を示します。NetFUNNELのトラフィック制御効果を示します。例えば、以前は100 RPSを受け、NetFUNNEL適用後は20 RPSの場合、サービス負荷は実際に1/5に減少しました

核心事項:

• リアルタイム進入量: PASSを受け、サービスに進入したリクエスト（直接進入 + 待機室からの再進入を含む）
• 統計: 統計表示では「進入リクエスト」は初期進入リクエスト（ステップ1: リクエスト到着）を意味し、サービス進入速度ではありません。詳細な説明は統計メトリックを参照してください

ステップ5: サービス使用

メトリック	リアルタイムモニタリング	統計	単位
処理時間	デフォルト: 処理時間 クラシック: (表示されない)	処理時間	秒

処理時間:

• 定義: サービス進入からサービス終了までの平均時間継続期間で、特定の時間ウィンドウ内で収集されたデータの平均値として計算されます
• 簡単に言うと: ユーザーがサービスに入場した後、終了するまで平均的にどれくらい長くアクティブ状態で留まったかを示します
• わかること: サーバー負荷およびパフォーマンスの間接指標として機能し、処理時間の増加または減少に基づいて進入許容数の調整が必要かどうかを判断するのに役立ちます
• 統合タイプ別解釈: 正確な意味はNetFUNNELを適用する位置によって異なります：
  • コードベース統合例: 進入はユーザーがログインボタンをクリック（nfStart()トリガー）、終了はログイン完了およびメインページロード（nfStop()トリガー）、処理時間はログインロジック実行およびメインページロード時間
  • URLトリガー統合例: 進入はユーザーがイベントページURLにアクセス（待機室進入、その後PASS受信）、終了はイベントページ完全ロード、処理時間はイベントページロードおよびレンダリング時間
  • 普遍的な定義: 統合タイプに関係なく、処理時間は以下を表します: 「NetFUNNELによって保護されるサービスが実行するのにかかる時間。」
• このメトリックが重要な理由: NetFUNNELはサーバー内部状態（CPU、メモリ、I/O）を直接モニタリングしません。処理時間は以下の間接指標として機能します：
  1. サーバー負荷状態: 負荷が高いほど → 処理時間が長くなる → 処理時間の増加
  2. ユーザー体験: サービス完了のためにユーザーが待機する時間を直接反映
  3. 進入許容数調整基準: 処理時間のトレンドを使用して進入許容数を調整

核心事項:

• リアルタイム: 現在の平均処理時間表示
• 統計: 過去平均処理時間表示（リアルタイムと同じ計算方法）
• サーバー負荷およびパフォーマンスの間接指標
• 処理時間が増加すると、サーバーが過負荷状態である可能性がある
• タイムアウト設定の最適化に使用

ステップ6: サービス終了

メトリック	リアルタイムモニタリング	統計	単位
処理完了量	デフォルト: (表示されない) クラシック: 処理完了量	(表示されない)	TPS
完了率	デフォルト: 処理完了率 クラシック: 処理完了率	完了率(%)	%

処理完了量:

• 定義: 1秒あたりの平均明示的サービス終了数で、nfStop()呼び出しによる終了のみを集計し、特定の時間ウィンドウ内で1秒あたりのリクエスト数(TPS)で計算されます
• 簡単に言うと: ユーザーがサービスを完了し、明示的にキーを返却して終了する1秒あたりの平均回数を示します
• わかること: 統合品質およびユーザー行動を評価でき、処理完了量と進入量を比較して、2つの値が近ければ正常完了が多く、処理完了量が低ければセッション離脱や統合問題があることを識別するのに役立ちます
• 重要な区別: 処理完了量は明示的サービス終了のみを計算します。サービスが明示的にnfStop()を呼び出す場合（コードベース統合）または進入キーが明示的に返却される場合のみ含まれます。タイムアウトベースの終了、強制終了されたブラウザ/アプリセッション、ネットワークエラーまたは接続切断は含まれません
• この制限が存在する理由: 明示的終了のみを追跡することで、欠落したnfStop()呼び出しを識別し、統合問題を診断し、タイムアウト設定を最適化できます
• 例示シナリオ: 進入量が100 TPSで処理完了量が50 TPSの場合、進入したユーザーの半分だけが明示的に終了していることを示します。即座にタイムアウトを減らして進入許容数を迅速に解放し、長期的にnfStop()が適切に呼び出されない理由を調査する必要があります

処理完了量の分析

処理完了量が進入量よりはるかに低い場合、以下を調査してください：

• コードにnfStop()呼び出しが欠落していませんか？
• タイムアウトが長すぎて進入許容数が不必要に保持されていませんか？
• 明示的終了が発生しない場合、タイムアウト値を減らすことを検討してください

完了率:

• 定義: サービスに進入したユーザーの中で明示的に終了したユーザーの割合で、特定の時間ウィンドウ内で（処理完了量 / 進入量 × 100）で計算されます
• 簡単に言うと: サービスに進入したユーザーの中でnfStop()を呼び出して正常に完了したユーザーの割合を示します
• わかること: 統合品質を評価でき、高い割合（100%に近い）は適切なnfStop()実装を示し、低い割合（<80%）は欠落した呼び出しや統合問題があることを知らせ、注意が必要な部分を識別するのに役立ちます
• 解釈: 100%は進入したすべてのユーザーが明示的に終了したことを意味し、50%は進入したユーザーの半分だけが明示的に終了したことを意味し、低い値は明示的終了の欠落を示し、調査が必要です
• 運用対応: 低い完了率（<50-70%）、高い待機 ユーザー数、高い待機時間を観察する場合、即座にタイムアウト値を減らして進入許容数を迅速に解放し、待機 ユーザー数が継続的に長い場合は進入許容数の増加を検討し（サーバーリソースが許容する場合）、長期的に欠落したnfStop()呼び出しの根本原因を修正する必要があります

タイムアウトの最適化

サービスが一般的に1-2秒以内に完了するが、タイムアウトが20秒（デフォルト最大値）に設定されている場合、不必要な進入許容数保持を防ぐためにタイムアウトを1-2秒に調整してください。

核心事項:

• 明示的終了（nfStop()呼び出し）のみが処理完了量に含まれる
• タイムアウト終了は処理完了量に含まれないが、進入許容数を解放する
• 低い完了率（<80%）は欠落したnfStop()呼び出しを示す

追加メトリック

トラフィック制御作業

メトリック	リアルタイムモニタリング	統計	単位
迂回	(表示されない)	迂回	TPS
ブロック	(表示されない)	ブロック	TPS

迂回:

• 定義: セグメント無効化機能またはプロジェクト無効化機能を通じて待機を経ずにサービスに直接進入する1秒あたりの平均ユーザー数で、特定の時間ウィンドウ内で1秒あたりのリクエスト数(TPS)で計算されます
• 簡単に言うと: 一般的にセグメントまたはプロジェクトの無効化により、待機室を経由せずにサービスに直接進入するユーザー数を示します
• わかること: セグメントやプロジェクトが無効化されたときに迂回機能が意図通りに動作しているか確認でき、ユーザーがトラフィック制御なしでサービスにアクセスできることを検証するのに役立ちます

ブロック:

• 定義: 1秒あたりのBLOCK応答を受けたリクエストの平均速度。進入がブロックされたリクエストです
• 簡単に言うと: セグメントの進入状態がブロックモードに設定されたときにブロックされ、ブロック室に移動するユーザー数を示します
• わかること: ブロック機能が意図通りに動作しているか確認でき、ブロックモードが有効化されたときにユーザーがサービスアクセスを適切にブロックされているか検証するのに役立ちます
• 注意: 繰り返しリクエストブロック機能によってブロックされたリクエスト（302ステータスコード返却）は、このメトリックに含まれません

NetFUNNELサーバーレベルメトリック

メトリック	統計	単位
CPU占有率	CPU占有率(%)	%
すべてのリクエスト量（サーバーレベル）	全体リクエスト数	TPS
セッション	セッション	-
ブロック	ブロック	TPS

CPU占有率:

• 定義: 測定時点のCPU使用量をパーセンテージで表示した値で、スナップショット値として表示されます
• 簡単に言うと: 測定時点にNetFUNNELサーバーのCPU容量の何パーセントが使用されているかを示します
• わかること: NetFUNNELサーバー負荷状態を評価し、潜在的なパフォーマンス問題を識別でき、NetFUNNELサーバーが負荷状態か余裕容量があるかを判断するのに役立ちます

セッション:

• 定義: サービス進入からサービス完了までの完了したセッション数で、特定の時間ウィンドウ内で集計されます
• 簡単に言うと: 測定期間中に開始され、正常に完了したユーザーセッションの総数を示します
• わかること: サービス使用パターンと完了率を把握でき、全体のサービス状態とユーザー参加度を評価するのに役立ちます

すべてのリクエスト量（サーバーレベル）:

• 定義: NetFUNNELサーバーレベルでの1秒あたりの平均すべてのAPIリクエスト数で、管理作業、データクエリ、およびその他のすべてのAPI呼び出しを含み、特定の時間ウィンドウ内で計算されます
• 簡単に言うと: NetFUNNELサーバーが1秒に平均的に処理しなければならないすべての種類のリクエスト数を示します
• わかること: サーバーエンジニアの観点から総システム負荷を把握でき、すべてのAPI呼び出しおよびトラフィック制御作業を含むNetFUNNELサーバーレベルの全体ワークロードを理解するのに役立ちます

ブロック:

• 定義: 1秒あたりのBLOCK応答を受けたリクエストの平均速度。進入がブロックされたリクエストです
• 簡単に言うと: セグメントの進入状態がブロックモードに設定されたときにブロックされ、ブロック室に移動するユーザー数を示します
• わかること: ブロック機能が意図通りに動作しているか確認でき、ブロックモードが有効化されたときにユーザーがサービスアクセスを適切にブロックされているか検証するのに役立ちます
• 注意: 繰り返しリクエストブロック機能によってブロックされたリクエスト（302ステータスコード返却）は、このメトリックに含まれません