了解 v2 資料匯出結構描述 - Amazon Monitron
v2 結構描述格式v2 結構描述參數

自 2024 年 10 月 31 日起，Amazon Monitron 將不再開放給新客戶。如果您想要使用 服務，請在該日期之前註冊。現有客戶可以繼續正常使用服務。如需類似 Amazon Monitron 的功能，請參閱我們的部落格文章 。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

了解 v2 資料匯出結構描述

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

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 中的第一級參數。在 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.temp

  • 觀察到的溫度

  • 類型：數字

  • °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

  • 測量序號

  • 類型：數字

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

  • 閘道的實體 ID，剛連線以將資料傳輸至 Amazon Monitron 服務

  • 類型：字串

eventType: gatewayDisconnected

siteName

  • 應用程式中顯示的網站名稱

  • 類型：字串

gatewayName

  • 應用程式中顯示的閘道名稱

  • 類型：字串

gatewayListURL

  • 應用程式中URL顯示的閘道

  • 類型：字串

physicalID

  • 閘道的實體 ID，剛連線以傳輸資料至 Amazon Monitron 服務

  • 類型：字串

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