activity_monitor

fireopal.activity_monitor(limit=1, offset=0, status=None)

Print a formatted table of metadata from previously submitted Fire Opal actions.

Use this function for quick, interactive inspection of recent job history directly in a terminal or notebook. Each row corresponds to one submitted action. For programmatic access to the same data (for example, to retrieve action IDs or build custom monitoring logic), use get_action_metadata() instead.

The following columns are printed to stdout:

  • Function — the client function that submitted the action (for example, "execute", "validate").
  • Status — the current status of the action (for example, "SUCCESS", "FAILURE", "IN_PROGRESS").
  • Created at (UTC) — creation timestamp formatted as "YYYY-MM-DD HH:MM:SS".
  • Updated at (UTC) — last-updated timestamp formatted as "YYYY-MM-DD HH:MM:SS".
  • Action ID — the unique identifier for the action.

If no actions match the specified filters, prints "No jobs found for the specified filter(s)." instead.

Parameters

  • limit (int , optional) – The number of actions to print. Cannot exceed 50. Defaults to 1.
  • offset (int , optional) – The number of recent actions to skip before starting to print, enabling pagination through results. Defaults to 0.
  • status (str or None , optional) – Filter actions by status (for example, "SUCCESS", "FAILURE", "IN_PROGRESS"). If None, prints actions of all statuses. Defaults to None.

Raises

QctrlArgumentsValueError – If limit exceeds 50.

Was this useful?