v2 データエクスポートスキーマを理解する

PDFRSS

各測定データ、それに対応する推論結果、ゲートウェイの接続/切断、およびセンサーの接続/切断のイベントは、1 つの Kinesis データストリームレコードとして JSON 形式でエクスポートされます。

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",
        "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",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "string"
    }
    
    // sensorDisconnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "string"
    }
    
    // gatewayConnected
    "eventPayload": {
        "siteName": "string",
        "gatewayName": "string",
        "gatewayListURL": "string",
        "gateway": {
            "physicalId": "string"
        }
    }
    
    // gatewayDisconnected
    "eventPayload": {
        "siteName": "string",
        "gatewayName": "string",
        "gatewayListURL": "string",
        "gateway": {
            "physicalId": "string"
        }
    }
    
    // assetStateTransition
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "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 の第 1 レベルのパラメータでしたが、v2 では eventPayload エンティティ下の第 2 レベルのパラメータです。

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

eventPayload.features.acceleration.band0To6000Hz.xAxis.rms

• X 軸の 0～6000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• 単位: m/s^2

eventPayload.features.acceleration.band0To6000Hz.yAxis.rms

• Y 軸の 0～6000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• 単位: m/s^2

eventPayload.features.acceleration.band0To6000Hz.zAxis.rms

• Z 軸の 0～6000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• 単位: m/s^2

eventPayload.features.acceleration.band10To1000Hz.resultantVector.absMax

• 10～1000 Hz の周波数帯域で観測された絶対最大加速度

• タイプ: 数値

• 単位: m/s^2

eventPayload.features.acceleration.band10To1000Hz.resultantVector.absMin

• 10～1000 Hz の周波数帯域で観測された絶対最小加速度

• タイプ: 数値

• 単位: m/s^2

eventPayload.features.acceleration.band10To1000Hz.resultantVector.crestFactor

• 10～1000 Hz の周波数帯域で観測された加速度の波高率

• タイプ: 数値

eventPayload.features.acceleration.band10To1000Hz.resultantVector.rms

• 10～1000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• m/s^2

eventPayload.features.acceleration.band10To1000Hz.xAxis.rms

• X 軸の 10～1000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• m/s^2

eventPayload.features.acceleration.band10To1000Hz.yAxis.rms

• Y 軸の 10～1000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• m/s^2

eventPayload.features.acceleration.band10To1000Hz.zAxis.rms

• Z 軸の 10～1000 Hz の周波数帯域で観測された加速度の二乗平均平方根

• タイプ: 数値

• m/s^2

eventPayload.features.temperature

• 観測された温度

• タイプ: 数値

• °C/摂氏

eventPayload.features.velocity.band10To1000Hz.resultantVector.absMax

• 10～1000 Hz の周波数帯域で観測された絶対最大速度

• タイプ: 数値

• mm/秒

eventPayload.features.velocity.band10To1000Hz.resultantVector.absMin

• 10～1000 Hz の周波数帯域で観測された絶対最小速度

• タイプ: 数値

• mm/秒

eventPayload.features.velocity.band10To1000Hz.resultantVector.crestFactor

• 10～1000 Hz の周波数帯域で観測された速度の波高率

• タイプ: 数値

eventPayload.features.velocity.band10To1000Hz.resultantVector.rms

• 10～1000 Hz の周波数帯域で観測された速度の二乗平均平方根

• タイプ: 数値

• mm/秒

eventPayload.features.velocity.band10To1000Hz.xAxis.rms

• X 軸の 10～1000 Hz の周波数帯域で観測された速度の二乗平均平方根

• タイプ: 数値

• mm/秒

eventPayload.features.velocity.band10To1000Hz.yAxis.rms

• Y 軸の 10～1000 Hz の周波数帯域で観測された速度の二乗平均平方根

• タイプ: 数値

• mm/秒

eventPayload.features.velocity.band10To1000Hz.zAxis.rms

• Z 軸の 10～1000 Hz の周波数帯域で観測された速度の二乗平均平方根

• タイプ: 数値

• mm/秒

eventPayload.sequenceNo

• 測定のシーケンス番号

• タイプ: 数値

eventPayload.assetPositionId

• 測定値が送信されるセンサー位置の識別子。

• タイプ: 文字列

eventType: sensorConnected

siteName

• アプリに表示されるサイト名

• タイプ: 文字列

assetName

• アプリに表示されるアセット名

• タイプ: 文字列

positionName

• アプリに表示されるセンサーの配置名

• タイプ: 文字列

assetPositionURL

• アプリに表示されるセンサー URL

• タイプ: 文字列

physicalID

• 測定値の送信元となるセンサーの物理 ID

• タイプ: 文字列

eventPayload.assetPositionId

• 状態が変更されたセンサー位置の識別子。

• タイプ: 文字列

eventType: sensorDisconnected

siteName

• アプリに表示されるサイト名

• タイプ: 文字列

assetName

• アプリに表示されるアセット名

• タイプ: 文字列

positionName

• アプリに表示されるセンサーの配置名

• タイプ: 文字列

assetPositionURL

• アプリに表示されるセンサー URL

• タイプ: 文字列

physicalID

• 測定値の送信元となるセンサーの物理 ID

• タイプ: 文字列

eventPayload.assetPositionId

• 状態が変更されたセンサー位置の識別子。

• タイプ: 文字列

eventType: gatewayConnected

eventPayload.siteName

• アプリに表示されるサイト名

• タイプ: 文字列

eventPayload.gatewayName

• アプリケーションに表示されるゲートウェイ名

• タイプ: 文字列

eventPayload.gatewayListURL

• アプリに表示されるゲートウェイ URL

• タイプ: 文字列

eventPayload.gateway.physicalID

• Amazon Monitron サービスへのデータ送信のために接続したゲートウェイの物理 ID

• タイプ: 文字列

eventType: gatewayDisconnected

siteName

• アプリに表示されるサイト名

• タイプ: 文字列

gatewayName

• アプリケーションに表示されるゲートウェイ名

• タイプ: 文字列

gatewayListURL

• アプリに表示されるゲートウェイ URL

• タイプ: 文字列

physicalID

• Amazon Monitron サービスへのデータ送信のために接続したゲートウェイの物理 ID

• タイプ: 文字列

eventType: assetStateTransition

eventPayload.siteName

• アプリに表示されるサイト名

• タイプ: 文字列

eventPayload.assetName

• アプリに表示されるアセット名

• タイプ: 文字列

eventPayload.positionName

• アプリに表示されるセンサーの配置名

• タイプ: 文字列

eventPayload.assetPositionURL

• アプリに表示されるセンサー URL

• タイプ: 文字列

eventPayload.sensor.physicalID

• 測定値の送信元となるセンサーの物理 ID

• タイプ: 文字列

eventPayload.assetTransitionType

• アセットの状態遷移の理由

• タイプ: 文字列

• 使用できる値: measurement または userInput

eventPayload.assetState.newState

• アセットの新しい状態

• タイプ: 文字列

eventPayload.assetState.previousState

• アセットの以前の状態

• タイプ: 文字列

eventPayload.closureCode.failureMode

• この障害を確認するときにユーザーが選択した障害モード

• タイプ: 文字列

• 使用できる値: NO_ISSUE | BLOCKAGE | CAVITATION | CORROSION | DEPOSIT | IMBALANCE | LUBRICATION | MISALIGNMENT | OTHER | RESONANCE | ROTATING_LOOSENESS | STRUCTURAL_LOOSENESS | TRANSMITTED_FAULT | UNDETERMINED

eventPayload.closureCode.failureCause

• 障害を確認するときにユーザーがアプリのドロップダウンで選択した障害の原因。

• タイプ: 文字列

• 使用できる値: ADMINISTRATION | DESIGN | FABRICATION | MAINTENANCE | OPERATION | OTHER | QUALITY | UNDETERMINED | WEAR

eventPayload.closureCode.actionTaken

• アプリのドロップダウンでユーザーが選択した、この異常をクローズするときに実行されるアクション。

• タイプ: 文字列

• 使用できる値: ADJUST | CLEAN | LUBRICATE | MODIFY | NO_ACTION | OTHER | OVERHAUL | REPLACE

eventPayload.closureCode.resolvedModels

• 問題が発生したモデルのセット。

• タイプ: 文字列のリスト

• 使用できる値: vibrationISO | vibrationML | temperatureML

eventPayload.assetPositionId

• 状態が変更されたアセット位置の識別子。

• タイプ: 文字列

models.temperatureML.persistentClassificationOutput

• 機械学習ベースの温度モデルからの永続的な分類出力

• タイプ: 数値

• 有効な値: UNKNOWN | HEALTHY | WARNING | ALARM

models.temperatureML.pointwiseClassificationOutput

• 機械学習ベースの温度モデルからのポイントごとの分類出力

• タイプ: 文字列

• 有効な値: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

models.vibrationISO.isoClass

• ISO ベースの振動モデルで使用される ISO 20816 クラス (機械振動の測定と評価に関する規格)

• タイプ: 文字列

• 有効な値: CLASS1 | CLASS2 | CLASS3 | CLASS4

models.vibrationISO.mutedThreshold

• ISO ベースの振動モデルからの通知をミュートするしきい値

• タイプ: 文字列

• 有効な値: WARNING | ALARM

models.vibrationISO.persistentClassificationOutput

• ISO ベースの振動モデルからの永続的な分類出力

• タイプ: 文字列

• 有効な値: UNKNOWN | HEALTHY | WARNING | ALARM

models.vibrationISO.pointwiseClassificationOutput

• ISO ベースの振動モデルからのポイントごとの分類出力

• タイプ: 文字列

• 有効な値: UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM

models.vibrationML.persistentClassificationOutput

• 機械学習ベースの振動モデルからの永続的な分類出力

• タイプ: 文字列

• 有効な値: UNKNOWN | HEALTHY | WARNING | ALARM

models.vibrationML.pointwiseClassificationOutput

• 機械学習ベースの振動モデルからのポイントごとの分類出力

• タイプ: 文字列

• 有効な値: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

assetState.newState

• 測定を処理した後の機械の状態

• タイプ: 文字列

• 有効な値: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

assetState.previousState

• 測定を処理する前の機械の状態

• タイプ: 文字列

• 有効な値: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM