

Amazon Monitron は新規顧客に公開されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。Amazon Monitron に似た機能については、[ブログ記事](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron)を参照してください。

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

# v2 データエクスポートスキーマを理解する
<a name="data-export-schema-v2"></a>

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

**Topics**
+ [v2 スキーマ形式](#data-export-schema-format-v2)
+ [v2 スキーマパラメータ](#data-export-schema-parameters-v2)

## v2 スキーマ形式
<a name="data-export-schema-format-v2"></a>

```
{
    "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 スキーマパラメータ
<a name="data-export-schema-parameters-v2"></a>

 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 ストリームレコードを重複排除するのに使用できます。
+ タイプ: 文字列

バージョン  
+ スキーマバージョニング
+ タイプ: 文字列
+ 値: 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  
+ 測定値が送信されるセンサー位置の識別子。
+ タイプ: 文字列

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

eventPayload.serialNumber  
+ アセットのシリアル番号。
+ タイプ: 文字列

eventPayload.make  
+ アセットのメーカー。
+ タイプ: 文字列

eventPayload.model  
+ アセットのモデル。
+ タイプ: 文字列

`eventType: sensorConnected`

siteName  
+ アプリに表示されるサイト名
+ タイプ: 文字列

assetName  
+ アプリに表示されるアセット名
+ タイプ: 文字列

positionName  
+ アプリに表示されるセンサーの配置名
+ タイプ: 文字列

assetPositionURL  
+ アプリに表示されるセンサー URL
+ タイプ: 文字列

physicalID  
+ 測定値の送信元となるセンサーの物理 ID
+ タイプ: 文字列

eventPayload.assetPositionId  
+ 状態が変更されたセンサー位置の識別子。
+ タイプ: 文字列

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

eventPayload.serialNumber  
+ アセットのシリアル番号。
+ タイプ: 文字列

eventPayload.make  
+ アセットのメーカー。
+ タイプ: 文字列

eventPayload.model  
+ アセットのモデル。
+ タイプ: 文字列

`eventType: sensorDisconnected`

siteName  
+ アプリに表示されるサイト名
+ タイプ: 文字列

assetName  
+ アプリに表示されるアセット名
+ タイプ: 文字列

positionName  
+ アプリに表示されるセンサーの配置名
+ タイプ: 文字列

assetPositionURL  
+ アプリに表示されるセンサー URL
+ タイプ: 文字列

physicalID  
+ 測定値の送信元となるセンサーの物理 ID
+ タイプ: 文字列

eventPayload.assetPositionId  
+ 状態が変更されたセンサー位置の識別子。
+ タイプ: 文字列

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

eventPayload.serialNumber  
+ アセットのシリアル番号。
+ タイプ: 文字列

eventPayload.make  
+ アセットのメーカー。
+ タイプ: 文字列

eventPayload.model  
+ アセットのモデル。
+ タイプ: 文字列

 `eventType: gatewayConnected` 

eventPayload.siteName  
+ アプリに表示されるサイト名
+ タイプ: 文字列

eventPayload.gatewayName  
+ アプリケーションに表示されるゲートウェイ名
+ タイプ: 文字列

eventPayload.gatewayListURL  
+ アプリに表示されるゲートウェイ URL
+ タイプ: 文字列

eventPayload.gateway.physicalID  
+ Amazon Monitron サービスへのデータ送信のために接続したゲートウェイの物理 ID
+ タイプ: 文字列

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

`eventType: gatewayDisconnected`

siteName  
+ アプリに表示されるサイト名
+ タイプ: 文字列

gatewayName  
+ アプリケーションに表示されるゲートウェイ名
+ タイプ: 文字列

gatewayListURL  
+ アプリに表示されるゲートウェイ URL
+ タイプ: 文字列

physicalID  
+ Amazon Monitron サービスへのデータ送信のために接続したゲートウェイの物理 ID
+ タイプ: 文字列

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

`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` \$1 `BLOCKAGE` \$1 `CAVITATION` \$1 `CORROSION` \$1 `DEPOSIT` \$1 `IMBALANCE` \$1 `LUBRICATION` \$1 `MISALIGNMENT` \$1 `OTHER` \$1 `RESONANCE` \$1 `ROTATING_LOOSENESS` \$1 `STRUCTURAL_LOOSENESS` \$1 `TRANSMITTED_FAULT` \$1 `UNDETERMINED` 

eventPayload.closureCode.failureCause  
+ 障害を確認するときにユーザーがアプリのドロップダウンで選択した障害の原因。
+ タイプ: 文字列
+ 使用できる値: `ADMINISTRATION` \$1 `DESIGN` \$1 `FABRICATION` \$1 `MAINTENANCE` \$1 `OPERATION` \$1 `OTHER` \$1 `QUALITY` \$1 `UNDETERMINED` \$1 `WEAR` 

eventPayload.closureCode.actionTaken  
+ アプリのドロップダウンでユーザーが選択した、この異常をクローズするときに実行されるアクション。
+ タイプ: 文字列
+ 使用できる値: `ADJUST` \$1 `CLEAN` \$1 `LUBRICATE` \$1 `MODIFY` \$1 `NO_ACTION` \$1 `OTHER` \$1 `OVERHAUL` \$1 `REPLACE` 

eventPayload.closureCode.resolvedModels  
+ 問題が発生したモデルのセット。
+ タイプ: 文字列のリスト
+ 使用できる値: `vibrationISO` \$1 `vibrationML` \$1 `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`

eventPayload.companyName  
+ アセットを使用している会社の名前。
+ タイプ: 文字列

eventPayload.geoLocation.latitude  
+ サイトの物理的な場所の緯度。
+ タイプ: 数値

eventPayload.geoLocation.longitude  
+ サイトの物理的な場所の経度。
+ タイプ: 数値

eventPayload.address  
+ サイトのアドレス。
+ タイプ: 文字列

eventPayload.serialNumber  
+ アセットのシリアル番号。
+ タイプ: 文字列

eventPayload.make  
+ アセットのメーカー。
+ タイプ: 文字列

eventPayload.model  
+ アセットのモデル。
+ タイプ: 文字列