mirror of
https://github.com/ClusterCockpit/cc-backend
synced 2024-09-21 03:47:26 +02:00
175 lines
6.2 KiB
Go
175 lines
6.2 KiB
Go
// Copyright (C) NHR@FAU, University Erlangen-Nuremberg.
|
|
// All rights reserved.
|
|
// Use of this source code is governed by a MIT-style
|
|
// license that can be found in the LICENSE file.
|
|
package schema
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
"time"
|
|
)
|
|
|
|
// BaseJob is the common part of the job metadata structs
|
|
//
|
|
// Common subset of Job and JobMeta. Use one of those, not this type directly.
|
|
|
|
type BaseJob struct {
|
|
Cluster string `json:"cluster" db:"cluster" example:"fritz"`
|
|
SubCluster string `json:"subCluster" db:"subcluster" example:"main"`
|
|
Partition string `json:"partition,omitempty" db:"partition" example:"main"`
|
|
Project string `json:"project" db:"project" example:"abcd200"`
|
|
User string `json:"user" db:"user" example:"abcd100h"`
|
|
State JobState `json:"jobState" db:"job_state" example:"completed" enums:"completed,failed,cancelled,stopped,timeout,out_of_memory"`
|
|
Tags []*Tag `json:"tags,omitempty"`
|
|
RawEnergyFootprint []byte `json:"-" db:"energy_footprint"`
|
|
RawFootprint []byte `json:"-" db:"footprint"`
|
|
RawMetaData []byte `json:"-" db:"meta_data"`
|
|
RawResources []byte `json:"-" db:"resources"`
|
|
Resources []*Resource `json:"resources"`
|
|
EnergyFootprint map[string]float64 `json:"energyFootprint"`
|
|
Footprint map[string]float64 `json:"footprint"`
|
|
MetaData map[string]string `json:"metaData"`
|
|
ConcurrentJobs JobLinkResultList `json:"concurrentJobs"`
|
|
Energy float64 `json:"energy"`
|
|
ArrayJobId int64 `json:"arrayJobId,omitempty" db:"array_job_id" example:"123000"`
|
|
Walltime int64 `json:"walltime,omitempty" db:"walltime" example:"86400" minimum:"1"`
|
|
JobID int64 `json:"jobId" db:"job_id" example:"123000"`
|
|
Duration int32 `json:"duration" db:"duration" example:"43200" minimum:"1"`
|
|
SMT int32 `json:"smt,omitempty" db:"smt" example:"4"`
|
|
MonitoringStatus int32 `json:"monitoringStatus,omitempty" db:"monitoring_status" example:"1" minimum:"0" maximum:"3"`
|
|
Exclusive int32 `json:"exclusive" db:"exclusive" example:"1" minimum:"0" maximum:"2"`
|
|
NumAcc int32 `json:"numAcc,omitempty" db:"num_acc" example:"2" minimum:"1"`
|
|
NumHWThreads int32 `json:"numHwthreads,omitempty" db:"num_hwthreads" example:"20" minimum:"1"`
|
|
NumNodes int32 `json:"numNodes" db:"num_nodes" example:"2" minimum:"1"`
|
|
}
|
|
|
|
// Job struct type
|
|
//
|
|
// This type is used as the GraphQL interface and using sqlx as a table row.
|
|
//
|
|
// Job model
|
|
// @Description Information of a HPC job.
|
|
type Job struct {
|
|
StartTime time.Time `json:"startTime"`
|
|
BaseJob
|
|
ID int64 `json:"id" db:"id"`
|
|
StartTimeUnix int64 `json:"-" db:"start_time" example:"1649723812"`
|
|
}
|
|
|
|
// JobMeta struct type
|
|
//
|
|
// When reading from the database or sending data via GraphQL, the start time
|
|
// can be in the much more convenient time.Time type. In the `meta.json`
|
|
// files, the start time is encoded as a unix epoch timestamp. This is why
|
|
// there is this struct, which contains all fields from the regular job
|
|
// struct, but "overwrites" the StartTime field with one of type int64. ID
|
|
// *int64 `json:"id,omitempty"` >> never used in the job-archive, only
|
|
// available via REST-API
|
|
//
|
|
|
|
type JobLink struct {
|
|
ID int64 `json:"id"`
|
|
JobID int64 `json:"jobId"`
|
|
}
|
|
|
|
type JobLinkResultList struct {
|
|
Items []*JobLink `json:"items"`
|
|
Count int `json:"count"`
|
|
}
|
|
|
|
// JobMeta model
|
|
// @Description Meta data information of a HPC job.
|
|
type JobMeta struct {
|
|
ID *int64 `json:"id,omitempty"`
|
|
Statistics map[string]JobStatistics `json:"statistics"`
|
|
BaseJob
|
|
StartTime int64 `json:"startTime" db:"start_time" example:"1649723812" minimum:"1"`
|
|
}
|
|
|
|
const (
|
|
MonitoringStatusDisabled int32 = 0
|
|
MonitoringStatusRunningOrArchiving int32 = 1
|
|
MonitoringStatusArchivingFailed int32 = 2
|
|
MonitoringStatusArchivingSuccessful int32 = 3
|
|
)
|
|
|
|
var JobDefaults BaseJob = BaseJob{
|
|
Exclusive: 1,
|
|
MonitoringStatus: MonitoringStatusRunningOrArchiving,
|
|
}
|
|
|
|
type Unit struct {
|
|
Base string `json:"base"`
|
|
Prefix string `json:"prefix,omitempty"`
|
|
}
|
|
|
|
// JobStatistics model
|
|
// @Description Specification for job metric statistics.
|
|
type JobStatistics struct {
|
|
Unit Unit `json:"unit"`
|
|
Avg float64 `json:"avg" example:"2500" minimum:"0"` // Job metric average
|
|
Min float64 `json:"min" example:"2000" minimum:"0"` // Job metric minimum
|
|
Max float64 `json:"max" example:"3000" minimum:"0"` // Job metric maximum
|
|
}
|
|
|
|
// Tag model
|
|
// @Description Defines a tag using name and type.
|
|
type Tag struct {
|
|
Type string `json:"type" db:"tag_type" example:"Debug"`
|
|
Name string `json:"name" db:"tag_name" example:"Testjob"`
|
|
ID int64 `json:"id" db:"id"`
|
|
}
|
|
|
|
// Resource model
|
|
// @Description A resource used by a job
|
|
type Resource struct {
|
|
Hostname string `json:"hostname"`
|
|
Configuration string `json:"configuration,omitempty"`
|
|
HWThreads []int `json:"hwthreads,omitempty"`
|
|
Accelerators []string `json:"accelerators,omitempty"`
|
|
}
|
|
|
|
type JobState string
|
|
|
|
const (
|
|
JobStateRunning JobState = "running"
|
|
JobStateCompleted JobState = "completed"
|
|
JobStateFailed JobState = "failed"
|
|
JobStateCancelled JobState = "cancelled"
|
|
JobStateStopped JobState = "stopped"
|
|
JobStateTimeout JobState = "timeout"
|
|
JobStatePreempted JobState = "preempted"
|
|
JobStateOutOfMemory JobState = "out_of_memory"
|
|
)
|
|
|
|
func (e *JobState) UnmarshalGQL(v interface{}) error {
|
|
str, ok := v.(string)
|
|
if !ok {
|
|
return fmt.Errorf("SCHEMA/JOB > enums must be strings")
|
|
}
|
|
|
|
*e = JobState(str)
|
|
if !e.Valid() {
|
|
return errors.New("SCHEMA/JOB > invalid job state")
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func (e JobState) MarshalGQL(w io.Writer) {
|
|
fmt.Fprintf(w, "\"%s\"", e)
|
|
}
|
|
|
|
func (e JobState) Valid() bool {
|
|
return e == JobStateRunning ||
|
|
e == JobStateCompleted ||
|
|
e == JobStateFailed ||
|
|
e == JobStateCancelled ||
|
|
e == JobStateStopped ||
|
|
e == JobStateTimeout ||
|
|
e == JobStatePreempted ||
|
|
e == JobStateOutOfMemory
|
|
}
|