pyfebiopt.monitoring.system_stats
=================================

.. py:module:: pyfebiopt.monitoring.system_stats

.. autoapi-nested-parse::

   System statistics helpers for the monitoring web UI.



Classes
-------

.. autoapisummary::

   pyfebiopt.monitoring.system_stats.SystemStatsCollector


Module Contents
---------------

.. py:class:: SystemStatsCollector(*, disk_limit: int = 4)

   Collect best-effort CPU, memory, and disk metrics.

   Configure stats collection limits.

   :param disk_limit: Maximum number of disks to report.


   .. py:attribute:: disk_limit


   .. py:property:: process_support
      :type: bool


      Return ``True`` when process inspection is available.


   .. py:method:: collect() -> dict[str, Any]

      Return a snapshot of host CPU, memory, and disk usage.



   .. py:method:: collect_processes(*, root: str | os.PathLike[str] | None = None) -> list[dict[str, Any]]

      Return lightweight process info filtered to those under ``root``.