.. _auto_hpcjob_status_history:

*HPC JOB STATUS HISTORY*
========================

Fetches the full status-transition history for a given HPC job and returns a structured dataset of state changes (from, to, timestamp, duration) alongside a human-readable summary of the current job status. Use this worker to audit job lifecycle, debug stuck jobs, or feed status timelines into dashboards and reports.

When to use
-----------

Tagged: ``hpc``, ``job_monitoring``, ``job_status``, ``simulations``, ``state_transition``, ``status_history``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - HPC Job
     - hpcjob_id
     - remote_lookup
     - —
     - ✓
     - The HPC job to inspect; resolved via remote lookup against the hpcjobs datatype — provide the internal record ID or the scheduler job ID for the target job.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Status History
     - status_history
     - dataset
     - Tabular dataset where each row represents one status transition, with columns: 'from' (previous state), 'to' (new state), 'time' (ISO-8601 timestamp of the transition), and 'duration' (human-readable time spent in the 'from' state, e.g. '2h 15m').
   * - Status
     - status
     - string
     - Human-readable summary string reporting the total number of transitions found, the job name, and the current live status of the job (e.g. 'Found 4 status transitions for job 42 (crash_run_01). Current status: RUNNING').

Disciplines
-----------

- platform.dashboard
- platform.job_submission

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>hpcjob_status_history</code>. Schema hash: <code>3f0fc8a80ebe</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>