View a markdown version of this page

Comprendere lo schema di esportazione dei dati v2 - Amazon Monitron
formato dello schema v2parametri dello schema v2

Amazon Monitron non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per funzionalità simili ad Amazon Monitron, consulta il nostro post sul blog.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Comprendere lo schema di esportazione dei dati v2

Ogni dato di misurazione, il risultato di inferenza corrispondente, il gateway connect/disconnect e connect/disconnect gli eventi del sensore vengono esportati come un unico record del flusso di dati Kinesis in formato JSON.

formato dello schema 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",
        "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"
    }
}

parametri dello schema v2

Lo schema di esportazione dei dati di Amazon Monitron Kinesis v2 include i seguenti parametri dello schema. Alcuni parametri sono aggiornamenti della v1 e altri sono esclusivi della v2. Ad esempio, siteName era un parametro di primo livello nella v1. In v2, è un parametro di secondo livello che si trova sotto l'entità. eventPayload

timestamp

  • Il timestamp in cui la misurazione viene ricevuta dal servizio Amazon Monitron in UTC

  • Tipo: stringa

  • Modello: aaaa-mm-gg HH:mm:ss.sss

eventId

  • L'ID univoco dell'evento di esportazione dei dati assegnato per ogni misurazione. Può essere utilizzato per deduplicare i record di streaming Kinesis ricevuti.

  • Tipo: stringa

version

  • Versione dello schema

  • Tipo: stringa

  • Valore: 1.0 o 2.0

accountId

  • L'ID dell' AWS account a 12 cifre per il tuo progetto Monitron

  • Tipo: stringa

projectName

Il nome del progetto visualizzato nell'app e nella console.

Tipo: stringa

projectId

L'ID univoco del tuo Amazon Monitron progetto.

Tipo: stringa

eventType

  • Lo stream di eventi corrente. Ogni tipo di evento avrà un eventPayload formato dedicato.

  • Tipo: stringa

  • Valori possibili:measurement,gatewayConnected,gatewayDisconnected,sensorConnected,sensorDisconnected,assetStateTransition.

eventType: measurement

evento Payload.features.acceleration.band0To6000Hz.xAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse x

  • Tipo: numero

  • Unità: ^2 m/s

evento Payload.features.acceleration.band0To6000Hz.yAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse y

  • Tipo: numero

  • Unità: ^2 m/s

evento Payload.features.acceleration.band0To6000Hz.zAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 0-6000 Hz sull'asse z

  • Tipo: numero

  • Unità: ^2 m/s

evento Payload.features.acceleration.band10To1000Hz.resultantVector.absMax

  • L'accelerazione massima assoluta osservata nella banda di frequenza 10—1000 Hz

  • Tipo: numero

  • Unità: ^2 m/s

evento Payload.features.acceleration.band10To1000Hz.resultantVector.absMin

  • L'accelerazione minima assoluta osservata nella banda di frequenza 10—1000 Hz

  • Tipo: numero

  • Unità: ^2 m/s

evento Payload.features.acceleration.band10To1000Hz.resultantVector.crestFactor

  • Il fattore di cresta di accelerazione osservato nella banda di frequenza 10-1000 Hz

  • Tipo: numero

evento Payload.features.acceleration.band10To1000Hz.resultantVector.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10-1000 Hz

  • Tipo: numero

  • m/s^2

evento Payload.features.acceleration.band10To1000Hz.xAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10-1000 Hz sull'asse x

  • Tipo: numero

  • m/s^2

evento Payload.features.acceleration.band10To1000Hz.yAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10-1000 Hz sull'asse y

  • Tipo: numero

  • m/s^2

evento Payload.features.acceleration.band10To1000Hz.zAxis.rms

  • La radice quadratica media dell'accelerazione osservata nella banda di frequenza 10-1000 Hz sull'asse z

  • Tipo: numero

  • m/s^2

evento Payload.features.temperature

  • La temperatura osservata

  • Tipo: numero

  • °C/degC

evento Payload.features.velocity.band10To1000Hz.resultantVector.absMax

  • La velocità massima assoluta osservata nella banda di frequenza 10—1000 Hz

  • Tipo: numero

  • mm/s

evento Payload.features.velocity.band10To1000Hz.resultantVector.absMin

  • La velocità minima assoluta osservata nella banda di frequenza 10—1000 Hz

  • Tipo: numero

  • mm/s

evento Payload.features.velocity.band10To1000Hz.resultantVector.crestFactor

  • Il fattore di cresta della velocità osservato nella banda di frequenza 10-1000 Hz

  • Tipo: numero

evento Payload.features.velocity.band10To1000Hz.resultantVector.rms

  • La radice quadratica media della velocità osservata nella banda di frequenza 10-1000 Hz

  • Tipo: numero

  • mm/s

evento Payload.features.velocity.band10To1000Hz.xAxis.rms

  • La radice quadratica media della velocità osservata nella banda di frequenza 10-1000 Hz sull'asse x

  • Tipo: numero

  • mm/s

evento Payload.features.velocity.band10To1000Hz.yAxis.rms

  • La radice quadratica media della velocità osservata nella banda di frequenza 10-1000 Hz sull'asse y

  • Tipo: numero

  • mm/s

evento Payload.features.velocity.band10To1000Hz.zAxis.rms

  • La radice quadratica media della velocità osservata nella banda di frequenza 10-1000 Hz sull'asse z

  • Tipo: numero

  • mm/s

evento Payload.sequenceNo

  • Il numero della sequenza di misurazione

  • Tipo: numero

evento Payload.assetPositionId

  • L'identificatore della posizione del sensore per il quale viene inviata la misurazione.

  • Tipo: stringa

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

evento Payload.serialNumber

  • Il numero di serie della risorsa.

  • Tipo: stringa

evento Payload.make

  • La marca dell'asset.

  • Tipo: stringa

evento Payload.model

  • Il modello dell'asset.

  • Tipo: stringa

eventType: sensorConnected

siteName

  • Il nome del sito visualizzato nell'app

  • Tipo: stringa

Nome della risorsa

  • Il nome della risorsa visualizzato nell'app

  • Tipo: stringa

Nome della posizione

  • Il nome della posizione del sensore visualizzato nell'app

  • Tipo: stringa

AssetPositionURL

  • L'URL del sensore visualizzato nell'app

  • Tipo: stringa

ID fisico

  • L'ID fisico del sensore da cui viene inviata la misurazione

  • Tipo: stringa

evento Payload.assetPositionId

  • L'identificatore della posizione del sensore il cui stato è cambiato.

  • Tipo: stringa

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

evento Payload.serialNumber

  • Il numero di serie della risorsa.

  • Tipo: stringa

evento Payload.make

  • La marca dell'asset.

  • Tipo: stringa

evento Payload.model

  • Il modello dell'asset.

  • Tipo: stringa

eventType: sensorDisconnected

siteName

  • Il nome del sito visualizzato nell'app

  • Tipo: stringa

Nome della risorsa

  • Il nome della risorsa visualizzato nell'app

  • Tipo: stringa

Nome della posizione

  • Il nome della posizione del sensore visualizzato nell'app

  • Tipo: stringa

AssetPositionURL

  • L'URL del sensore visualizzato nell'app

  • Tipo: stringa

ID fisico

  • L'ID fisico del sensore da cui viene inviata la misurazione

  • Tipo: stringa

evento Payload.assetPositionId

  • L'identificatore della posizione del sensore il cui stato è cambiato.

  • Tipo: stringa

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

evento Payload.serialNumber

  • Il numero di serie della risorsa.

  • Tipo: stringa

evento Payload.make

  • La marca dell'asset.

  • Tipo: stringa

evento Payload.model

  • Il modello dell'asset.

  • Tipo: stringa

eventType: gatewayConnected

evento Payload.siteName

  • Il nome del sito visualizzato nell'app

  • Tipo: stringa

evento Payload.gatewayName

  • Il nome del gateway visualizzato nell'app

  • Tipo: stringa

evento Payload.gatewayListURL

  • L'URL del gateway visualizzato nell'app

  • Tipo: stringa

evento Payload.gateway.physicalID

  • L'ID fisico del gateway appena connesso per trasmettere i dati al servizio Amazon Monitron

  • Tipo: stringa

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

eventType: gatewayDisconnected

siteName

  • Il nome del sito visualizzato nell'app

  • Tipo: stringa

Nome del gateway

  • Il nome del gateway visualizzato nell'app

  • Tipo: stringa

URL dell'elenco dei gateway

  • L'URL del gateway visualizzato nell'app

  • Tipo: stringa

ID fisico

  • L'ID fisico del gateway appena connesso per trasmettere i dati al servizio Amazon Monitron

  • Tipo: stringa

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

eventType: assetStateTransition

evento Payload.siteName

  • Il nome del sito visualizzato nell'app

  • Tipo: stringa

evento Payload.assetName

  • Il nome della risorsa visualizzato nell'app

  • Tipo: stringa

evento Payload.positionName

  • Il nome della posizione del sensore visualizzato nell'app

  • Tipo: stringa

evento Payload.assetPositionURL

  • L'URL del sensore visualizzato nell'app

  • Tipo: stringa

evento Payload.sensor.physicalID

  • L'ID fisico del sensore da cui viene inviata la misurazione

  • Tipo: stringa

evento Payload.assetTransitionType

  • Il motivo alla base della transizione allo stato patrimoniale

  • Tipo: stringa

  • Valori possibili: measurement o userInput

evento Payload.assetState.newState

  • Il nuovo stato dell'asset

  • Tipo: stringa

evento Payload.assetState.previousState

  • Lo stato precedente dell'asset

  • Tipo: stringa

evento Payload.closureCode.failureMode

  • La modalità di errore selezionata dall'utente al momento della conferma dell'errore

  • Tipo: stringa

  • Valori possibili: NO_ISSUE | BLOCKAGE | CAVITATION | CORROSION | | DEPOSIT | IMBALANCE | LUBRICATION | MISALIGNMENT | OTHER | | RESONANCE | ROTATING_LOOSENESS | STRUCTURAL_LOOSENESS | TRANSMITTED_FAULT UNDETERMINED

evento Payload.closureCode.failureCause

  • La causa dell'errore selezionata dall'utente nel menu a discesa dell'app al momento della conferma dell'errore.

  • Tipo: stringa

  • Valori possibili: ADMINISTRATION | | DESIGN | FABRICATION | MAINTENANCE | OPERATION | | OTHER | QUALITY UNDETERMINED WEAR

evento Payload.closureCode.actionTaken

  • L'azione intrapresa per la chiusura di questa anomalia, selezionata dall'utente nel menu a discesa dell'app.

  • Tipo: stringa

  • Valori possibili: ADJUST | | CLEAN | LUBRICATE | MODIFY | | NO_ACTION | OTHER OVERHAUL REPLACE

evento Payload.closureCode.resolvedModels

  • La serie di modelli che ha evidenziato il problema.

  • Tipo: elenco di stringhe

  • Valori possibili: vibrationISO | vibrationML | temperatureML

evento Payload.assetPositionId

  • L'identificatore della posizione patrimoniale il cui stato è cambiato.

  • Tipo: stringa

modelli.temperatura ML.persistentClassificationOutput

  • L'output di classificazione persistente del modello di temperatura basato sull'apprendimento automatico

  • Tipo: numero

  • Valori validi: UNKNOWN | HEALTHY | WARNING | ALARM

modelli.temperatura ML.pointwiseClassificationOutput

  • L'output della classificazione puntuale del modello di temperatura basato sull'apprendimento automatico

  • Tipo: stringa

  • Valori validi: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

modelli.vibrazione ISO.isoClass

  • La classe ISO 20816 (uno standard per la misurazione e la valutazione delle vibrazioni delle macchine) utilizzata dal modello di vibrazione basato su ISO

  • Tipo: stringa

  • Valori validi: CLASS1 | CLASS2 | CLASS3 | CLASS4

modelli.vibrazione ISO.mutedThreshold

  • La soglia per disattivare la notifica proveniente dal modello di vibrazione basato su ISO

  • Tipo: stringa

  • Valori validi: WARNING | ALARM

modelli.vibrazione ISO.persistentClassificationOutput

  • L'output di classificazione persistente del modello di vibrazione basato su ISO

  • Tipo: stringa

  • Valori validi: UNKNOWN | HEALTHY | WARNING | ALARM

modelli.vibrazione ISO.pointwiseClassificationOutput

  • Il risultato della classificazione puntuale del modello di vibrazione basato su ISO

  • Tipo: stringa

  • Valori validi: UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM

modelli.vibrazione ML.persistentClassificationOutput

  • L'output di classificazione persistente del modello di vibrazione basato sull'apprendimento automatico

  • Tipo: stringa

  • Valori validi: UNKNOWN | HEALTHY | WARNING | ALARM

modelli.vibrazione ML.pointwiseClassificationOutput

  • L'output della classificazione puntuale del modello di vibrazione basato sull'apprendimento automatico

  • Tipo: stringa

  • Valori validi: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

risorsa State.newState

  • Lo stato della macchina dopo l'elaborazione della misurazione

  • Tipo: stringa

  • Valori validi: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

risorsa State.previousState

  • Lo stato della macchina prima dell'elaborazione della misurazione

  • Tipo: stringa

  • Valori validi: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

evento Payload.companyName

  • Il nome della società che utilizza la risorsa.

  • Tipo: stringa

evento Payload.geoLocation.latitude

  • La latitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.geoLocation.longitude

  • La longitudine della posizione fisica del sito.

  • Tipo: numero

evento Payload.address

  • L'indirizzo del sito.

  • Tipo: stringa

evento Payload.serialNumber

  • Il numero di serie della risorsa.

  • Tipo: stringa

evento Payload.make

  • La marca dell'asset.

  • Tipo: stringa

evento Payload.model

  • Il modello dell'asset.

  • Tipo: stringa