MINARA
リファレンス環境変数

システムリソースメトリクス

システムリソースメトリクス (ダッシュボードの System ステータス行)

MINARA_SYSTEM_METRICS_DISABLED

MINARA_SYSTEM_METRICS_DISABLED

  • 制御対象: gateway がプロセス + システムのリソース使用量(CPU、メモリ、空きディスク、サンドボックスフォルダーのサイズ、ネットワークスループット、トークンスループット)をサンプリングし、/v1/system-metrics エンドポイントをライブデータとともに公開するかどうか。エンドポイントはどちらの場合も登録されたままです。無効化されると { disabled: true } を返し、web UI はその行を非表示にします。
  • 使用箇所: src/metrics/index.ts の start()。
  • 設定するタイミング: リソースの限られたオペレーターホスト、テスト実行、または 5 秒のサンプリング tick + サンドボックスディレクトリのウォークを実行すべきでない環境。
  • デフォルト: 空(コレクター有効)。
  • 形式: 1 で無効化します。それ以外(未設定を含む)はコレクターを有効のままにします。
  • MINARA_SYSTEM_METRICS_DISABLED=1
  • 設定の所在: ユーザー向け設定ではありません

SYSTEM_METRICS_TOKEN_SESSION_WINDOW

SYSTEM_METRICS_TOKEN_SESSION_WINDOW

  • 制御対象: 「Tokens/sec」のヘッドライン数値に寄与する、最も最近アクティブだったチャットセッションの数。コレクターは入力 / 出力トークン + 実時間の持続時間のセッションごとの集計を保持します。各スナップショットで、最も最近アクティブな上位 N セッションが平均化されるため、アイドルな Agent の数値は、古いアイドルセッションで薄められた生涯平均ではなく、現在のパフォーマンスを反映します。
  • 使用箇所: src/metrics/token-collector.ts の snapshot()。
  • 設定するタイミング: より厳密な「今この瞬間」の値には低く(例: 3)、単一セッションの外れ値に反応しにくい滑らかな数値には高く(例: 10)します。
  • デフォルト: 5。
  • 形式: 正の整数。
  • SYSTEM_METRICS_TOKEN_SESSION_WINDOW=5
  • 設定の所在: ユーザー向け設定ではありません

目次