v2 データエクスポートスキーマを理解する - Amazon Monitron
v2 スキーマ形式v2 スキーマパラメータ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

各測定データ、それに対応する推論結果、ゲートウェイの接続/切断、およびセンサーの接続/切断のイベントは、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"
            }
        }
    }
    
    // sensorConnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        }
    }
    
    // sensorDisconnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "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">
        }
    }
}

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

  • 測定のシーケンス番号

  • タイプ: 数値

eventType: sensorConnected

siteName

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

  • 型: 文字列

assetName

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

  • 型: 文字列

positionName

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

  • 型: 文字列

assetPositionURL

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

  • 型: 文字列

physicalID

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

  • 型: 文字列

eventType: sensorDisconnected

siteName

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

  • 型: 文字列

assetName

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

  • 型: 文字列

positionName

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

  • 型: 文字列

assetPositionURL

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

  • 型: 文字列

physicalID

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

  • 型: 文字列

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

  • 型: 文字列

eventPayloadassetTransitionType。

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

  • 型: 文字列

  • 使用できる値: 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

models.temperatureMLpersistentClassificationOutput

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

  • タイプ: 数値

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

models.temperatureMLpointwiseClassificationOutput

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

  • 型: 文字列

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

models.vibrationISO.isoClass

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

  • 型: 文字列

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

models.vibrationISO.mutedThreshold

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

  • 型: 文字列

  • 有効な値：WARNING | ALARM

models.vibrationISOpersistentClassificationOutput。

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

  • 型: 文字列

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

models.vibrationISOpointwiseClassificationOutput。

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

  • 型: 文字列

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

models.vibrationMLpersistentClassificationOutput。

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

  • 型: 文字列

  • 有効な値：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