← All types
ProductionIn Input object

UpsertMetricInput

Input for creating or updating a metric

Fields

id

MetricIDOptional

ID for update; omit for create

Associated device ID

Associated work centre ID — links this metric to a specific machine or station

name

String!Required

Machine-readable metric name (required)

Human-readable display name

Description of what this metric measures

Metric kind (required)

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 (required). Use CUSTOM for vertical-specific units.

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). Required when unit is CUSTOM.

Key-value metadata tags

Referenced by (1)
Exact type SDL
"""Input for creating or updating a metric"""
input UpsertMetricInput {
  """ID for update; omit for create"""
  id: MetricID
  """Associated device ID"""
  deviceId: DeviceID
  """
  Associated work centre ID — links this metric to a specific machine or station
  """
  workCenterId: WorkCenterID
  """Machine-readable metric name (required)"""
  name: String!
  """Human-readable display name"""
  displayName: String
  """Description of what this metric measures"""
  description: String
  """Metric kind (required)"""
  kind: MetricKind!
  """Measurement unit (required). Use CUSTOM for vertical-specific units."""
  unit: MetricUnit!
  """
  Vertical-specific unit name when unit is CUSTOM (e.g. SHEETS, BOTTLES). Required when unit is CUSTOM.
  """
  customUnit: String
  """Key-value metadata tags"""
  tags: [DictionaryInput!]
}