View a markdown version of this page

了解 v2 数据导出架构 - Amazon Monitron
v2 架构格式v2 架构参数

亚马逊 Monitron 不再向新客户开放。现有客户可以继续正常使用该服务。有关与亚马逊 Monitron 类似的功能，请参阅我们的博客文章。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

了解 v2 数据导出架构

每个测量数据、其相应的推理结果 connect/disconnect、网关和传感器 connect/disconnect 事件都以 JSON 格式导出为一个 Kinesis 数据流记录。

v2 架构格式

{
    "timestamp": "string",
    "eventId": "string",
    "version": "2.0",
    "accountId": "string",
    "projectName": "string",
    "projectId": "string",
    "eventType": "measurement|gatewayConnected|gatewayDisconnected|sensorConnected|sensorDisconnected|assetStateTransition",
    // measurement
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "serialNumber": "string",
        "make": "string",
        "model": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string",
            "rssi": number
        },
        "gateway": {
            "physicalId": "string"
        },
        "sequenceNo": number,
        "features": {
            "acceleration": {
                "band0To6000Hz": {
                    "xAxis": {
                        "rms": number
                    },
                    "yAxis": {
                        "rms": number
                    },
                    "zAxis": {
                        "rms": number
                    }
                },
                "band10To1000Hz": {
                    "totalVibration": {
                        "absMax": number,
                        "absMin": number,
                        "crestFactor": number,
                        "rms": number
                    },
                    "xAxis": {
                        "rms": number
                    },
                    "yAxis": {
                        "rms": number
                    },
                    "zAxis": {
                        "rms": number
                    }
                }
            },
            "velocity": {
                "band10To1000Hz": {
                    "totalVibration": {
                        "absMax": number,
                        "absMin": number,
                        "crestFactor": number,
                        "rms": number
                    },
                    "xAxis": {
                        "rms": number
                    },
                    "yAxis": {
                        "rms": number
                    },
                    "zAxis": {
                        "rms": number
                    }
                }
            },
            "temperature": number
        }
        "models": {
            "temperatureML": {
                "previousPersistentClassificationOutput": "string",
                "persistentClassificationOutput": "string",
                "pointwiseClassificationOutput": "string"
            },
            "vibrationISO": {
                "isoClass": "string",
                "mutedThreshold": "string",
                "previousPersistentClassificationOutput": "string",
                "persistentClassificationOutput": "string",
                "pointwiseClassificationOutput": "string"
            },
            "vibrationML": {
                "previousPersistentClassificationOutput": "string",
                "persistentClassificationOutput": "string",
                "pointwiseClassificationOutput": "string"
            }
        },
        "assetPositionId": "string"
    }
    
    // sensorConnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "serialNumber": "string",
        "make": "string",
        "model": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "string"
    }
    
    // sensorDisconnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "serialNumber": "string",
        "make": "string",
        "model": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "string"
    }
    
    // gatewayConnected
    "eventPayload": {
        "siteName": "string",
        "gatewayName": "string",
        "gatewayListURL": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "gateway": {
            "physicalId": "string"
        }
    }
    
    // gatewayDisconnected
    "eventPayload": {
        "siteName": "string",
        "gatewayName": "string",
        "gatewayListURL": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "gateway": {
            "physicalId": "string"
        }
    }
    
    // assetStateTransition
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "companyName": "string",
        "geoLocation": {
            "latitude": number,
            "longitude": number
        },
        "address": "string",
        "serialNumber": "string",
        "make": "string",
        "model": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetTransitionType": "measurement|userInput",
        "assetState": {
            "newState": "string",
            "previousState": "string"
        },
        "closureCode": {
            "failureMode": "string",
            "failureCause": "string",
            "actionTaken": "string",
            "resolvedModels": list<"string">
        },
        "assetPositionId": "string"
    }
}

v2 架构参数

Amazon Monitron Kinesis 数据导出架构 v2 包含以下架构参数。其中一些参数是对 v1 的更新，另一些参数是 v2 所独有的。例如，siteName 在 v1 中是一级参数。在 v2 中，它是二级参数，可以在 eventPayload 实体下找到。

timestamp

  • Amazon Monitron 服务接收测量数据时的时间戳（UTC 格式）

  • 类型：字符串

  • 模式：yyyy-mm-dd hh:mm:ss.SSS

eventId

  • 为每个测量数据分配的唯一数据导出事件 ID。可用于对收到的 Kinesis 流记录进行重复数据删除。

  • 类型：字符串

version

  • 架构版本

  • 类型：字符串

  • 值：1.0 或 2.0

accountId

  • 您的 Monitron 项目的 12 位数 AWS 账户 ID

  • 类型：字符串

projectName

应用程序和控制台中显示的项目名称。

类型：字符串

projectId

Amazon Monitron 项目的唯一 ID。

类型：字符串

eventType

  • 当前事件流。每个事件类型都有一个专用 eventPayload 格式。

  • 类型：字符串

  • 可能的值：measurement、gatewayConnected、gatewayDisconnected、sensorConnected、sensorDisconnected、assetStateTransition。

eventType: measurement

事件 Payload.features.acceleration.band0To6000Hz.xAxis.rms

  • 在 0–6000 Hz 频带内观测到的 x 轴上加速度的均方根

  • 类型：数字

  • 单位： m/s^2

事件 Payload.features.acceleration.band0To6000Hz.yAxis.rms

  • 在 0–6000 Hz 频带内观测到的 y 轴上加速度的均方根

  • 类型：数字

  • 单位： m/s^2

事件 Payload.features.acceleration.band0To6000Hz.zAxis.rms

  • 在 0–6000 Hz 频带内观测到的 z 轴上加速度的均方根

  • 类型：数字

  • 单位： m/s^2

事件 Payload.features.acceleration.band10To1000Hz.resultantVector.absMax

  • 在 10–1000 Hz 频带内观测到的绝对最大加速度

  • 类型：数字

  • 单位： m/s^2

事件 Payload.features.acceleration.band10To1000Hz.resultantVector.absMin

  • 在 10–1000 Hz 频带内观测到的绝对最小加速度

  • 类型：数字

  • 单位： m/s^2

事件 Payload.features.acceleration.band10To1000Hz.resultantVector.crestFactor

  • 在 10–1000 Hz 频带内观测到的加速度波峰因数

  • 类型：数字

事件 Payload.features.acceleration.band10To1000Hz.resultantVector.rms

  • 在 10–1000 Hz 频带内观测到的加速度的均方根

  • 类型：数字

  • m/s^2

事件 Payload.features.acceleration.band10To1000Hz.xAxis.rms

  • 在 10–1000 Hz 频带内观测到的 x 轴上加速度的均方根

  • 类型：数字

  • m/s^2

事件 Payload.features.acceleration.band10To1000Hz.yAxis.rms

  • 在 10–1000 Hz 频带内观测到的 y 轴上加速度的均方根

  • 类型：数字

  • m/s^2

事件 Payload.features.acceleration.band10To1000Hz.zAxis.rms

  • 在 10–1000 Hz 频带内观测到的 z 轴上加速度的均方根

  • 类型：数字

  • m/s^2

事件 Payload.features.temperature

  • 观测到的温度

  • 类型：数字

  • °C/degC

事件 Payload.features.velocity.band10To1000Hz.resultantVector.absMax

  • 在 10–1000 Hz 频带内观测到的绝对最大速度

  • 类型：数字

  • mm/s

事件 Payload.features.velocity.band10To1000Hz.resultantVector.absMin

  • 在 10–1000 Hz 频带内观测到的绝对最小速度

  • 类型：数字

  • mm/s

事件 Payload.features.velocity.band10To1000Hz.resultantVector.crestFactor

  • 在 10–1000 Hz 频带内观测到的速度波峰因数

  • 类型：数字

事件 Payload.features.velocity.band10To1000Hz.resultantVector.rms

  • 在 10–1000 Hz 频带内观测到的速度的均方根

  • 类型：数字

  • mm/s

事件 Payload.features.velocity.band10To1000Hz.xAxis.rms

  • 在 10–1000 Hz 频带内观测到的 x 轴上速度的均方根

  • 类型：数字

  • mm/s

事件 Payload.features.velocity.band10To1000Hz.yAxis.rms

  • 在 10–1000 Hz 频带内观测到的 y 轴上速度的均方根

  • 类型：数字

  • mm/s

事件 Payload.features.velocity.band10To1000Hz.zAxis.rms

  • 在 10–1000 Hz 频带内观测到的 z 轴上速度的均方根

  • 类型：数字

  • mm/s

事件 Payload.sequenceNo

  • 测量数据序列号

  • 类型：数字

事件 Payload.assetPositionId

  • 发送测量结果的传感器位置的标识符。

  • 类型：字符串

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

事件 Payload.serialNumber

  • 资产的序列号。

  • 类型：字符串

事件 Payload.make

  • 资产的品牌。

  • 类型：字符串

事件 Payload.model

  • 资产的模型。

  • 类型：字符串

eventType: sensorConnected

siteName

  • 应用程序中显示的站点名称

  • 类型：字符串

assetName

  • 应用程序中显示的资产名称

  • 类型：字符串

positionName

  • 应用程序中显示的传感器位置名称

  • 类型：字符串

assetPositionURL

  • 应用程序中显示的传感器 URL

  • 类型：字符串

physicalID

  • 发出测量数据的传感器的物理 ID

  • 类型：字符串

事件 Payload.assetPositionId

  • 状态发生变化的传感器位置的标识符。

  • 类型：字符串

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

事件 Payload.serialNumber

  • 资产的序列号。

  • 类型：字符串

事件 Payload.make

  • 资产的品牌。

  • 类型：字符串

事件 Payload.model

  • 资产的模型。

  • 类型：字符串

eventType: sensorDisconnected

siteName

  • 应用程序中显示的站点名称

  • 类型：字符串

assetName

  • 应用程序中显示的资产名称

  • 类型：字符串

positionName

  • 应用程序中显示的传感器位置名称

  • 类型：字符串

assetPositionURL

  • 应用程序中显示的传感器 URL

  • 类型：字符串

physicalID

  • 发出测量数据的传感器的物理 ID

  • 类型：字符串

事件 Payload.assetPositionId

  • 状态发生变化的传感器位置的标识符。

  • 类型：字符串

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

事件 Payload.serialNumber

  • 资产的序列号。

  • 类型：字符串

事件 Payload.make

  • 资产的品牌。

  • 类型：字符串

事件 Payload.model

  • 资产的模型。

  • 类型：字符串

eventType: gatewayConnected

事件 Payload.siteName

  • 应用程序中显示的站点名称

  • 类型：字符串

事件 Payload.gatewayName

  • 应用程序中显示的网关的名称

  • 类型：字符串

事件 Payload.gatewayListURL

  • 应用程序中显示的网关 URL

  • 类型：字符串

事件 Payload.gateway.physicalID

  • 刚刚连接的网关（用于向 Amazon Monitron 服务传输数据）的物理 ID

  • 类型：字符串

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

eventType: gatewayDisconnected

siteName

  • 应用程序中显示的站点名称

  • 类型：字符串

gatewayName

  • 应用程序中显示的网关的名称

  • 类型：字符串

gatewayListURL

  • 应用程序中显示的网关 URL

  • 类型：字符串

physicalID

  • 刚刚连接的网关（用于向 Amazon Monitron 服务传输数据）的物理 ID

  • 类型：字符串

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

eventType: assetStateTransition

事件 Payload.siteName

  • 应用程序中显示的站点名称

  • 类型：字符串

事件 Payload.assetName

  • 应用程序中显示的资产名称

  • 类型：字符串

事件 Payload.positionName

  • 应用程序中显示的传感器位置名称

  • 类型：字符串

事件 Payload.assetPositionURL

  • 应用程序中显示的传感器 URL

  • 类型：字符串

事件 Payload.sensor.physicalID

  • 发出测量数据的传感器的物理 ID

  • 类型：字符串

事件 Payload.assetTransitionType

  • 资产状态转换背后的原因

  • 类型：字符串

  • 可能的值：measurement 或 userInput

事件 Payload.assetState.newState

  • 资产的新状态

  • 类型：字符串

事件 Payload.assetState.previousState

  • 资产的先前状态

  • 类型：字符串

事件 Payload.closureCode.failureMode

  • 用户在确认此故障时选择的故障模式

  • 类型：字符串

  • 可能的值：NO_ISSUE | BLOCKAGE | CAVITATION | CORROSION | DEPOSIT | IMBALANCE | LUBRICATION | MISALIGNMENT | OTHER | RESONANCE | ROTATING_LOOSENESS | STRUCTURAL_LOOSENESS | TRANSMITTED_FAULT | UNDETERMINED

事件 Payload.closureCode.failureCause

  • 用户确认故障时在应用程序下拉菜单中选择的故障原因。

  • 类型：字符串

  • 可能的值：ADMINISTRATION | DESIGN | FABRICATION | MAINTENANCE | OPERATION | OTHER | QUALITY | UNDETERMINED | WEAR

事件 Payload.closureCode.actionTaken

  • 关闭此异常时执行的操作，由用户在应用程序下拉菜单中选择。

  • 类型：字符串

  • 可能的值：ADJUST | CLEAN | LUBRICATE | MODIFY | NO_ACTION | OTHER | OVERHAUL | REPLACE

事件 Payload.closureCode.resolvedModels

  • 指出了问题的一组模型。

  • 类型：字符串列表

  • 可能的值：vibrationISO | vibrationML | temperatureML

事件 Payload.assetPositionId

  • 状态发生变化的资产头寸的标识符。

  • 类型：字符串

模型。温度 ML.persistentClassificationOutput

  • 基于机器学习的温度模型的持续分类输出

  • 类型：数字

  • 有效值：UNKNOWN | HEALTHY | WARNING | ALARM

模型。温度 ML.pointwiseClassificationOutput

  • 基于机器学习的温度模型的逐点分类输出

  • 类型：字符串

  • 有效值：UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

模型。振动 ISO.isoClass

  • 基于 ISO 的振动模型使用的 ISO 20816 等级（用于测量和评估机器振动的标准）

  • 类型：字符串

  • 有效值：CLASS1 | CLASS2 | CLASS3 | CLASS4

模型。振动 ISO.mutedThreshold

  • 将基于 ISO 的振动模型发出的通知静音的阈值

  • 类型：字符串

  • 有效值：WARNING | ALARM

模型。振动 ISO.persistentClassificationOutput

  • 基于 ISO 的振动模型的持续分类输出

  • 类型：字符串

  • 有效值：UNKNOWN | HEALTHY | WARNING | ALARM

模型。振动 ISO.pointwiseClassificationOutput

  • 基于 ISO 的振动模型的逐点分类输出

  • 类型：字符串

  • 有效值：UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM

模型。振动 ML.persistentClassificationOutput

  • 基于机器学习的振动模型的持续分类输出

  • 类型：字符串

  • 有效值：UNKNOWN | HEALTHY | WARNING | ALARM

模型。振动 ML.pointwiseClassificationOutput

  • 基于机器学习的振动模型的逐点分类输出

  • 类型：字符串

  • 有效值：UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

资产 State.newState

  • 处理测量数据后的机器状态

  • 类型：字符串

  • 有效值：UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

资产 State.previousState

  • 处理测量数据前的机器状态

  • 类型：字符串

  • 有效值：UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

事件 Payload.companyName

  • 使用资产的公司名称。

  • 类型：字符串

事件 Payload.geoLocation.latitude

  • 站点物理位置的纬度。

  • 类型：数字

事件 Payload.geoLocation.longitude

  • 站点物理位置的经度。

  • 类型：数字

事件 Payload.address

  • 网站的地址。

  • 类型：字符串

事件 Payload.serialNumber

  • 资产的序列号。

  • 类型：字符串

事件 Payload.make

  • 资产的品牌。

  • 类型：字符串

事件 Payload.model

  • 资产的模型。

  • 类型：字符串