リファレンス環境変数
システムリソースメトリクス
システムリソースメトリクス (ダッシュボードの 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
- 設定の所在: ユーザー向け設定ではありません