Event

Supertype: Observation

Definition: Observation that is a discrete piece of information from a piece of equipment.

Version Info

IntroducedDeprecatedUpdated
1.0  

Documentation

Description

It provides the information and data reported from a piece of equipment for those DataItem entities defined with DataItem::category as EVENT in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

Figure Event Example shows Event type examples. It also shows an example for when the Observation::result is not available (dataItemId=d1_asset_rem).

Event Example

Note: See event-example for the XML representation of the same example.

The following Section Value Properties of Event lists the additional and/or updated attributes for Event.

Inherited Properties

NameTypeIntDepMultiplicityDescription
compositionId ID1.40..1 identifier of the Composition entity defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request. associated with the data reported for the Observation.
dataItemId ID1.01

unique identifier of the DataItem associated with this Observation.

Observation::dataItemId MUST match the associated DataItem::id defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

name string1.00..1

name of the DataItem associated with this Observation.

Observation::name MUST match the associated DataItem::name defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

sequence integer1.01

number representing the sequential position of an occurrence of an observationobserved value of a property at a point in time. in the data buffer of an agentsoftware that collects data published from one or more piece(s) of equipment, organizes that data in a structured manner, and responds to requests for data from client software systems by providing a structured response in the form of a response document that is constructed using the semantic data model of a Standard. .

Observation::sequence MUST have a value represented as an unsigned 64-bit value from 1 to \(2^{64}-1\).

subType DataItemSubTypeEnum1.20..1

subtype of the DataItem associated with this Observation.

Observation::subType MUST match the associated DataItem::subType defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

timestamp datetime1.01 most accurate time available to a piece of equipment that represents the point in time that the data reported was measured.
type DataItemTypeEnum1.01

type of the DataItem associated with this Observation.

Observation::type MUST match the associated DataItem::type defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

units UnitEnum1.00..1

units of the DataItem associated with this Observation.

Observation::units MUST match the associated DataItem::units defined in the MTConnectDevices Response Documentresponse document published by an MTConnect Agent in response to a probe request..

isUnavailable boolean (Default: true)1.01

when true, Observation::result is indeterminate.

Note 1 to entry: In XML, when isUnavailable is true, the XML CDATA of the Observation MUST be UNAVAILABLE. ```xml

<Execution dataItemId=”…” …>UNAVAILABLE</Execution>


> Note 2 to entry: In *JSON*, when `isUnavailable` is `true`, the *JSON* `value` of the `Observation` **MUST** be `UNAVAILABLE`.
```json
  "Execution" : [ { "dataItemId": "..." ..., "value": "UNAVAILABLE" } ]
result string1.00..1

observationobserved value of a property at a point in time. of the Observation entity.

The default value type for Observation::result is string.

Note 1 to entry: in XML the Observation::result is the CDATA of the Observation elementconstituent part or a basic unit of identifiable and definable data..

<Execution dataItemId="..." ...>READY</Execution>

Note 2 to entry: in JSON the Observation::result is the member value of the Observation object.

"Execution" : [ { "dataItemId": "..." ..., "value": "READY" } ]

Inherited Relations

NameTypeIntDepMultiplicityDescription
isObservationOf Component1.00..*
isObservationOf Agent1.00..*
isObservationOf DataItem1.00..*

Properties

NameTypeIntDepMultiplicityDescription
resetTriggered ResetTriggeredEnum1.40..1

identifies when a reported value has been reset and what has caused that reset to occur for those DataItem entities that may be periodically reset to an initial value.

resetTriggered MUST only be provided for the specific occurrence of a DataItem reported in the MTConnectStreams Response Documentresponse document published by an MTConnect Agent in response to a current request or a sample request. when the reset occurred.

type EventEnum1.01

Subclasses

NameIntDep
ActivationCount1.8 
ActiveAxes1.1 
ActivePowerSource2.3 
ActuatorState1.2 
AdapterSoftwareVersion1.7 
AdapterURI1.7 
Alarm1.01.1
AlarmLimit1.72.5
AlarmLimits2.3 
Application1.6 
AssetAdded2.6 
AssetChanged1.2 
AssetCount2.0 
AssetRemoved1.3 
AssociatedAssetId2.6 
Availability1.1 
AxisCoupling1.1 
AxisFeedrateOverride1.3 
AxisInterlock1.3 
AxisState1.3 
BatteryState2.1 
BindingState2.7 
Block1.0 
BlockCount1.4 
CharacteristicPersistentId2.2 
CharacteristicStatus2.2 
ChuckInterlock1.3 
ChuckState1.3 
ClockTime1.2 
CloseChuck1.3 
CloseDoor1.3 
Code1.01.1
ComponentData2.2 
CompositionState1.4 
ConnectionStatus1.7 
ControlLimit1.72.5
ControlLimits2.3 
ControllerMode1.0 
ControllerModeOverride1.4 
CoupledAxes1.2 
CycleCount1.8 
DateCode1.5 
DeactivationCount1.8 
Depth2.7 
DeviceAdded1.7 
DeviceChanged1.7 
DeviceRemoved1.7 
DeviceUuid1.5 
Direction1.0 
DoorState1.1 
EmergencyStop1.1 
EndOfBar1.3 
EquipmentMode1.4 
Execution1.0 
FeatureMeasurement2.2 
FeaturePersisitentId2.2 
Firmware1.6 
FixtureAssetId2.7 
FixtureId2.0 
FunctionalMode1.3 
Hardness1.4 
Hardware1.6 
HostName2.1 
InterfaceState1.3 
LeakDetect2.1 
Library1.6 
Line1.01.4
LineLabel1.4 
LineNumber1.4 
LoadCount1.8 
LocationAddress2.3 
LocationNarrative2.4 
LocationSpatialGeographic2.3 
LockState1.8 
MTConnectVersion1.7 
MaintenanceList2.0 
Material1.4 
MaterialChange1.3 
MaterialFeed1.3 
MaterialLayer1.5 
MaterialLoad1.3 
MaterialRetract1.3 
MaterialUnload1.3 
MeasurementType2.2 
MeasurementUnits2.2 
MeasurementValue2.2 
Message1.1 
Network1.6 
NetworkPort2.1 
OpenChuck1.3 
OpenDoor1.3 
OperatingMode2.0 
OperatingSystem1.6 
OperatorId1.3 
PalletId1.2 
PartChange1.3 
PartCount1.0 
PartCountType2.0 
PartDetect1.5 
PartGroupId1.7 
PartId1.1 
PartIndex2.5 
PartKindId1.7 
PartNumber1.41.7
PartProcessingState1.8 
PartStatus1.7 
PartUniqueId1.7 
PathFeedrateOverride1.3 
PathMode1.1 
PowerState1.1 
PowerStatus1.01.1
ProcessAggregateId1.7 
ProcessKindId1.7 
ProcessOccurrenceId1.7 
ProcessState1.8 
ProcessTime1.5 
Program1.0 
ProgramComment1.3 
ProgramEdit1.3 
ProgramEditName1.3 
ProgramHeader1.3 
ProgramLocation1.5 
ProgramLocationType1.5 
ProgramNestLevel1.5 
RotaryMode1.1 
RotaryVelocityOverride1.3 
Rotation1.6 
SensorAttachment1.7 
SensorState2.2 
SerialNumber1.4 
SpecificationLimit1.72.5
SpecificationLimits2.3 
SpindleInterlock1.3 
SwingAngle2.7 
SwingDiameter2.7 
SwingRadius2.7 
TaskAssetId2.7 
Thickness2.4 
ToolAssetId1.2 
ToolCuttingItem2.3 
ToolGroup1.5 
ToolId1.11.2
ToolNumber1.2 
ToolOffset1.4 
ToolOffsets2.2 
TransferCount1.8 
Translation1.6 
Uncertainty2.2 
UncertaintyType2.2 
UnloadCount1.8 
User1.4 
ValveState1.8 
Variable1.5 
Variable  
WaitState1.5 
Wire1.4 
WorkOffset1.4 
WorkOffsets2.2 
WorkOffsets  
WorkholdingId1.1 

Back to top

Copyright © 2017-2026 Association for Manufacturing Technology (AMT). All rights reserved. MTConnect® is a trademark of AMT. Terms of Use.

MTConnect SysML Model V2.7