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>

 每個測量資料、其對應的推論結果、閘道連線/中斷連線和感應器連線/中斷連線事件都會匯出為 JSON 格式的一個 Kinesis 資料串流記錄。

**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 中的第一層參數。在 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`**

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/degC

eventPayload.features.velocity.band10To1000Hz.resultantVector.absMax  
+ 在頻帶 10–1000 Hz 中觀察到的絕對最大速度
+ 類型：數字
+ mm/s

eventPayload.features.velocity.band10To1000Hz.resultantVector.absMin  
+ 在頻帶 10–1000 Hz 中觀察到的絕對最小速度
+ 類型：數字
+ mm/s

eventPayload.features.velocity.band10To1000Hz.resultantVector.crestFactor  
+ 在頻帶 10–1000 Hz 中觀察到的速度波峰係數
+ 類型：數字

eventPayload.features.velocity.band10To1000Hz.resultantVector.rms  
+ 在頻帶 10–1000 Hz 中觀察到的速度的根均方
+ 類型：數字
+ mm/s

eventPayload.features.velocity.band10To1000Hz.xAxis.rms  
+ 在 x 軸的頻帶 10–1000 Hz 中觀察到的速度的根均方
+ 類型：數字
+ mm/s

eventPayload.features.velocity.band10To1000Hz.yAxis.rms  
+ 在 y 軸的頻帶 10–1000 Hz 中觀察到的速度的根均方
+ 類型：數字
+ mm/s

eventPayload.features.velocity.band10To1000Hz.zAxis.rms  
+ 在 z 軸的頻帶 10–1000 Hz 中觀察到的速度的根均方
+ 類型：數字
+ mm/s

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  
+ 閘道的實體 ID，剛連線以將資料傳輸到 Amazon Monitron 服務
+ 類型：字串

eventPayload.companyName  
+ 使用該資產的公司名稱。
+ 類型：字串

eventPayload.geoLocation.latitude  
+ 網站實體位置的緯度。
+ 類型：數字

eventPayload.geoLocation.longitude  
+ 網站實體位置的經度。
+ 類型：數字

eventPayload.address  
+ 網站的地址。
+ 類型：字串

`eventType: gatewayDisconnected`

siteName  
+ 應用程式中顯示的網站名稱
+ 類型：字串

gatewayName  
+ 顯示在應用程式中的閘道名稱
+ 類型：字串

gatewayListURL  
+ 應用程式中顯示的閘道 URL
+ 類型：字串

physicalID  
+ 閘道的實體 ID，剛連線以將資料傳輸到 Amazon Monitron 服務
+ 類型：字串

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` \| `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`

eventPayload.companyName  
+ 使用該資產的公司名稱。
+ 類型：字串

eventPayload.geoLocation.latitude  
+ 網站實體位置的緯度。
+ 類型：數字

eventPayload.geoLocation.longitude  
+ 網站實體位置的經度。
+ 類型：數字

eventPayload.address  
+ 網站的地址。
+ 類型：字串

eventPayload.serialNumber  
+ 資產的序號。
+ 類型：字串

eventPayload.make  
+ 資產的製造商。
+ 類型：字串

eventPayload.model  
+ 資產的模型。
+ 類型：字串