← All types
ProductionOb Object

MetricState

A metric definition describing a trackable measurement

Fields

id

MetricID!Non-null

Unique identifier

Associated device ID

Resolved device name (read-only)

Associated work centre ID — enables filtering and cross-machine comparison

Resolved work centre (via DataLoader)

name

String!Non-null

Machine-readable metric name (e.g. door_open, ink_level)

Human-readable display name

Description of what this metric measures

Metric kind (gauge, counter, status, rate)

Possible values (4)
GAUGE

Instantaneous value that can go up or down (temperature, speed, ink level)

COUNTER

Monotonically increasing cumulative value (total impressions, error count)

STATUS

Discrete state as a numeric value (0/1 for door open/closed, online/offline)

RATE

Computed rate of change (pages per minute, waste per hour)

Measurement unit (CUSTOM when using a vertical-specific unit)

Possible values (39)
NONE

No unit

PERCENT

Percentage (0-100)

RATIO

Ratio (0.0-1.0)

BOOLEAN

Boolean (0 or 1)

COUNT

Generic count

PIECES

Discrete pieces/items

MILLIMETERS

Millimeters

METERS

Meters

INCHES

Inches

FEET

Feet

METERS_PER_MINUTE

Meters per minute

FEET_PER_MINUTE

Feet per minute

UNITS_PER_MINUTE

Units per minute (generic)

UNITS_PER_HOUR

Units per hour (generic)

CELSIUS

Degrees Celsius

FAHRENHEIT

Degrees Fahrenheit

KELVIN

Kelvin

BAR

Bar

PSI

Pounds per square inch

KILOPASCAL

Kilopascal

GRAMS

Grams

KILOGRAMS

Kilograms

POUNDS

Pounds

MILLILITERS

Milliliters

LITERS

Liters

SQUARE_METERS

Square meters

SQUARE_FEET

Square feet

MILLISECONDS

Milliseconds

SECONDS

Seconds

MINUTES

Minutes

HOURS

Hours

VOLTS

Volts

AMPS

Amperes

WATTS

Watts

KILOWATT_HOURS

Kilowatt-hours

BYTES

Bytes

KILOBYTES

Kilobytes

MEGABYTES

Megabytes

CUSTOM

Vertical-specific or user-defined unit — provide the unit name in customUnit

Vertical-specific unit name when unit is CUSTOM (e.g. SHEETS, BOTTLES)

Display-friendly unit label — returns customUnit for CUSTOM, otherwise the standard unit name

tags

[Dictionary!]!Non-null

Key-value metadata tags

Creation timestamp (ISO8601)

Last update timestamp (ISO8601)

Referenced by (3)
Exact type SDL
"""A metric definition describing a trackable measurement"""
type MetricState {
  """Unique identifier"""
  id: MetricID!
  """Associated device ID"""
  deviceId: DeviceID
  """Resolved device name (read-only)"""
  deviceName: String
  """
  Associated work centre ID — enables filtering and cross-machine comparison
  """
  workCenterId: WorkCenterID
  """Resolved work centre (via DataLoader)"""
  workCenter: WorkCenterState
  """Machine-readable metric name (e.g. door_open, ink_level)"""
  name: String!
  """Human-readable display name"""
  displayName: String
  """Description of what this metric measures"""
  description: String
  """Metric kind (gauge, counter, status, rate)"""
  kind: MetricKind!
  """Measurement unit (CUSTOM when using a vertical-specific unit)"""
  unit: MetricUnit!
  """Vertical-specific unit name when unit is CUSTOM (e.g. SHEETS, BOTTLES)"""
  customUnit: String
  """
  Display-friendly unit label — returns customUnit for CUSTOM, otherwise the standard unit name
  """
  resolvedUnitLabel: String!
  """Key-value metadata tags"""
  tags: [Dictionary!]!
  """Creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
}