hpcflow.sdk.monitoring.models#

Typed monitoring data and conversion of the existing JSON file formats.

Dataclasses are used throughout monitoring. Dictionaries remain appropriate for dynamic scheduler arguments, counters, and indexes keyed by run ID.

Functions

to_json

Convert models to the existing JSON schema, including historical sequences.

Classes

ActionRunState

A run's engine state and its position in the task/element/iteration layout.

ActionStatus

An action attempt's display state within an iteration.

ActionSummary

Compact action counts, grouped patterns, and timing observations for one part.

ElementGroup

Elements of one task sharing the same ordered iteration/action/attempt states.

IterationActionState

A named, immutable step in a grouped element's iteration pattern.

JobObservation

Scheduler state for a whole job or individual zero-based array elements.

JobRecord

Saved scheduler context and reference for one successfully submitted jobscript.

ProcessIdentity

PID and creation time used to distinguish a submitter from a later reused PID.

ProcessReference

A direct job's process ID and original command, without a workflow object.

RegistryData

Registry records, a fresh-ID counter, and IDs freed by explicit unregistering.

SubmissionRecord

One registered submission part, its job references, and latest observations.

TerminalStateCache

Terminal action states shared by parts of one workflow submission.

WorkflowHeaderToken

File identity and stat values used to avoid reparsing an unchanged store header.

WorkflowKey

Workflow path and persistent ID used to share loads and reject replaced stores.