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

Amazon Monitron は、新規顧客に公開されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。Amazon Monitron に似た機能については、ブログ記事を参照してください。

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

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"> }, "assetPositionId": "string" } }

v2 スキーマパラメータ

Amazon Monitron の Kinesis データエクスポートスキーマ v2 には、以下のスキーマパラメータが含まれています。v1 から更新されたパラメータもあれば、v2 に固有のパラメータもあります。例えば、siteName は v1 の第 1 レベルのパラメータでしたが、v2 では eventPayload エンティティ下の第 2 レベルのパラメータです。

timestamp
  • で Amazon Monitron サービスによって測定が受信されたときのタイムスタンプ UTC

  • 型: 文字列

  • Pattern: 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 形式があります。

  • 型: 文字列

  • 使用できる値: measurementgatewayConnectedgatewayDisconnectedsensorConnectedsensorDisconnectedassetStateTransition

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

  • 型: 文字列

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.vibration ISO。isoClass
  • ISO ベースの振動モデルで使用される ISO 20816 クラス (マシン振動の測定と評価の標準)

  • 型: 文字列

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

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

  • 型: 文字列

  • 有効な値: WARNING | ALARM

models.vibration ISO。persistentClassificationOutput
  • ISO ベースの振動モデルからの永続分類出力

  • 型: 文字列

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

models.vibration ISO。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