View a markdown version of this page

Comprendre le schéma d'exportation des données v2 - Amazon Monitron
format de schéma v2paramètres du schéma v2

Amazon Monitron n'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour des fonctionnalités similaires à celles d'Amazon Monitron, consultez notre article de blog.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comprendre le schéma d'exportation des données v2

Chaque donnée de mesure, le résultat d'inférence, la passerelle connect/disconnect et les connect/disconnect événements de capteur correspondants sont exportés sous la forme d'un enregistrement de flux de données Kinesis au format JSON.

format de schéma 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"
    }
}

paramètres du schéma v2

Le schéma d'exportation de données Amazon Monitron Kinesis v2 inclut les paramètres de schéma suivants. Certains paramètres sont des mises à jour depuis la version v1 et d'autres sont propres à la version v2. Par exemple, siteName était un paramètre de premier niveau dans la v1. Dans la v2, il s'agit d'un paramètre de second niveau qui se trouve sous l'eventPayloadentité.

timestamp

  • Horodatage de réception de la mesure par le service Amazon Monitron en UTC

  • Type : String

  • Motif : yyyy-mm-dd HH:mm:SS.sss

eventId

  • L'ID d'événement d'exportation de données unique attribué à chaque mesure. Peut être utilisé pour dédupliquer les enregistrements de flux Kinesis reçus.

  • Type : String

version

  • Version du schéma

  • Type : String

  • Valeur : 1,0 ou 2,0

accountId

  • L'identifiant de AWS compte à 12 chiffres pour votre projet Monitron

  • Type : String

projectName

Le nom du projet affiché dans l'application et la console.

Type : String

projectId

L'identifiant unique de votre Amazon Monitron projet.

Type : String

eventType

  • Le flux d'événements en cours. Chaque type d'événement aura un eventPayload format dédié.

  • Type : String

  • Valeurs possibles : measurementgatewayConnected,gatewayDisconnected,sensorConnected,sensorDisconnected,assetStateTransition.

eventType: measurement

événement Payload.features.acceleration.band0To6000Hz.xAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 0—6 000 Hz sur l'axe des x

  • Type : Number

  • Unité : m/s ^2

événement Payload.features.acceleration.band0To6000Hz.yAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 0—6 000 Hz sur l'axe Y

  • Type : Number

  • Unité : m/s ^2

événement Payload.features.acceleration.band0To6000Hz.zAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 0—6 000 Hz sur l'axe z

  • Type : Number

  • Unité : m/s ^2

événement Payload.features.acceleration.band10To1000Hz.resultantVector.absMax

  • Accélération maximale absolue observée dans la bande de fréquences 10—1000 Hz

  • Type : Number

  • Unité : m/s ^2

événement Payload.features.acceleration.band10To1000Hz.resultantVector.absMin

  • Accélération minimale absolue observée dans la bande de fréquences 10—1000 Hz

  • Type : Number

  • Unité : m/s ^2

événement Payload.features.acceleration.band10To1000Hz.resultantVector.crestFactor

  • Le facteur de crête d'accélération observé dans la bande de fréquences 10—1000 Hz

  • Type : Number

événement Payload.features.acceleration.band10To1000Hz.resultantVector.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 10—1 000 Hz

  • Type : Number

  • m/s^2

événement Payload.features.acceleration.band10To1000Hz.xAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 10—1 000 Hz sur l'axe des x

  • Type : Number

  • m/s^2

événement Payload.features.acceleration.band10To1000Hz.yAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe Y

  • Type : Number

  • m/s^2

événement Payload.features.acceleration.band10To1000Hz.zAxis.rms

  • La racine carrée de l'accélération observée dans la bande de fréquences 10—1 000 Hz sur l'axe z

  • Type : Number

  • m/s^2

événement Payload.features.temperature

  • La température observée

  • Type : Number

  • °C/degC

événement Payload.features.velocity.band10To1000Hz.resultantVector.absMax

  • La vitesse maximale absolue observée dans la bande de fréquences 10—1000 Hz

  • Type : Number

  • mm/s

événement Payload.features.velocity.band10To1000Hz.resultantVector.absMin

  • La vitesse minimale absolue observée dans la bande de fréquences 10—1000 Hz

  • Type : Number

  • mm/s

événement Payload.features.velocity.band10To1000Hz.resultantVector.crestFactor

  • Le facteur de crête de vitesse observé dans la bande de fréquences 10—1000 Hz

  • Type : Number

événement Payload.features.velocity.band10To1000Hz.resultantVector.rms

  • La racine carrée de la vitesse observée dans la bande de fréquences 10—1 000 Hz

  • Type : Number

  • mm/s

événement Payload.features.velocity.band10To1000Hz.xAxis.rms

  • La racine carrée de la vitesse observée dans la bande de fréquences 10—1 000 Hz sur l'axe des x

  • Type : Number

  • mm/s

événement Payload.features.velocity.band10To1000Hz.yAxis.rms

  • La racine carrée de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe Y

  • Type : Number

  • mm/s

événement Payload.features.velocity.band10To1000Hz.zAxis.rms

  • La racine carrée de la vitesse observée dans la bande de fréquences de 10 à 1 000 Hz sur l'axe z

  • Type : Number

  • mm/s

événement Payload.sequenceNo

  • Le numéro de séquence de mesure

  • Type : Number

événement Payload.assetPositionId

  • Identifiant de la position du capteur pour laquelle la mesure est envoyée.

  • Type : String

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

événement Payload.serialNumber

  • Le numéro de série de l'actif.

  • Type : String

événement Payload.make

  • La marque de l'actif.

  • Type : String

événement Payload.model

  • Le modèle de l'actif.

  • Type : String

eventType: sensorConnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

Nom de l'actif

  • Le nom de l'actif affiché dans l'application

  • Type : String

Nom du poste

  • Le nom de position du capteur affiché dans l'application

  • Type : String

URL de position de l'actif

  • L'URL du capteur affichée dans l'application

  • Type : String

Identifiant physique

  • L'identifiant physique du capteur à partir duquel la mesure est envoyée

  • Type : String

événement Payload.assetPositionId

  • Identifiant de la position du capteur dont l'état a changé.

  • Type : String

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

événement Payload.serialNumber

  • Le numéro de série de l'actif.

  • Type : String

événement Payload.make

  • La marque de l'actif.

  • Type : String

événement Payload.model

  • Le modèle de l'actif.

  • Type : String

eventType: sensorDisconnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

Nom de l'actif

  • Le nom de l'actif affiché dans l'application

  • Type : String

Nom du poste

  • Le nom de position du capteur affiché dans l'application

  • Type : String

URL de position de l'actif

  • L'URL du capteur affichée dans l'application

  • Type : String

Identifiant physique

  • L'identifiant physique du capteur à partir duquel la mesure est envoyée

  • Type : String

événement Payload.assetPositionId

  • Identifiant de la position du capteur dont l'état a changé.

  • Type : String

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

événement Payload.serialNumber

  • Le numéro de série de l'actif.

  • Type : String

événement Payload.make

  • La marque de l'actif.

  • Type : String

événement Payload.model

  • Le modèle de l'actif.

  • Type : String

eventType: gatewayConnected

événement Payload.siteName

  • Le nom du site affiché dans l'application

  • Type : String

événement Payload.gatewayName

  • Le nom de la passerelle tel qu'il est affiché dans l'application

  • Type : String

événement Payload.gatewayListURL

  • L'URL de la passerelle affichée dans l'application

  • Type : String

événement Payload.gateway.physicalID

  • L'identifiant physique de la passerelle qui vient de se connecter pour transmettre des données au service Amazon Monitron

  • Type : String

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

eventType: gatewayDisconnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

Nom de la passerelle

  • Le nom de la passerelle tel qu'il est affiché dans l'application

  • Type : String

URL de la liste des passerelles

  • L'URL de la passerelle affichée dans l'application

  • Type : String

Identifiant physique

  • L'identifiant physique de la passerelle qui vient de se connecter pour transmettre des données au service Amazon Monitron

  • Type : String

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

eventType: assetStateTransition

événement Payload.siteName

  • Le nom du site affiché dans l'application

  • Type : String

événement Payload.assetName

  • Le nom de l'actif affiché dans l'application

  • Type : String

événement Payload.positionName

  • Le nom de position du capteur affiché dans l'application

  • Type : String

événement Payload.assetPositionURL

  • L'URL du capteur affichée dans l'application

  • Type : String

événement Payload.sensor.physicalID

  • L'identifiant physique du capteur à partir duquel la mesure est envoyée

  • Type : String

événement Payload.assetTransitionType

  • La raison de la transition de l'état des actifs

  • Type : String

  • Valeurs possibles : measurement ou userInput

événement Payload.assetState.newState

  • Le nouvel état de l'actif

  • Type : String

événement Payload.assetState.previousState

  • L'état antérieur de l'actif

  • Type : String

événement Payload.closureCode.failureMode

  • Le mode de défaillance sélectionné par l'utilisateur lors de la reconnaissance de cette défaillance

  • Type : String

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

événement Payload.closureCode.failureCause

  • La cause de l'échec sélectionnée par l'utilisateur dans la liste déroulante de l'application lors de la reconnaissance d'un échec.

  • Type : String

  • Valeurs possibles : ADMINISTRATION | DESIGN | FABRICATION | MAINTENANCE | OPERATION | OTHER | QUALITY | UNDETERMINED | WEAR

événement Payload.closureCode.actionTaken

  • Action prise lors de la fermeture de cette anomalie, telle que sélectionnée par l'utilisateur dans la liste déroulante de l'application.

  • Type : String

  • Valeurs possibles : ADJUST | CLEAN | LUBRICATE | MODIFY | NO_ACTION | OTHER | OVERHAUL | REPLACE

événement Payload.closureCode.resolvedModels

  • L'ensemble de modèles qui ont mis en lumière le problème.

  • Type : liste de chaînes

  • Valeurs possibles : vibrationISO | vibrationML | temperatureML

événement Payload.assetPositionId

  • Identifiant de la position de l'actif dont l'état a changé.

  • Type : String

modèles.température ML.persistentClassificationOutput

  • La sortie de classification persistante du modèle de température basé sur l'apprentissage automatique

  • Type : Number

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM

modèles.température ML.pointwiseClassificationOutput

  • La sortie de classification par point du modèle de température basé sur l'apprentissage automatique

  • Type : String

  • Valeurs valides : UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

modèles.vibration ISO.isoClass

  • La classe ISO 20816 (une norme pour la mesure et l'évaluation des vibrations des machines) utilisée par le modèle de vibration basé sur l'ISO

  • Type : String

  • Valeurs valides : CLASS1 | CLASS2 | CLASS3 | CLASS4

modèles.vibration ISO.mutedThreshold

  • Le seuil pour désactiver la notification à partir du modèle de vibration basé sur l'ISO

  • Type : String

  • Valeurs valides : WARNING | ALARM

modèles.vibration ISO.persistentClassificationOutput

  • La sortie de classification persistante du modèle de vibration basé sur l'ISO

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM

modèles.vibration ISO.pointwiseClassificationOutput

  • La sortie de classification par point du modèle de vibration basé sur l'ISO

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM

modèles.vibration ML.persistentClassificationOutput

  • La sortie de classification persistante du modèle de vibration basé sur l'apprentissage automatique

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM

modèles.vibration ML.pointwiseClassificationOutput

  • Le résultat de classification par point du modèle de vibration basé sur l'apprentissage automatique

  • Type : String

  • Valeurs valides : UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

actif State.newState

  • L'état de la machine après le traitement de la mesure

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

actif State.previousState

  • État de la machine avant le traitement de la mesure

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

événement Payload.companyName

  • Le nom de la société qui utilise l'actif.

  • Type : String

événement Payload.geoLocation.latitude

  • Latitude de l'emplacement physique du site.

  • Type : Number

événement Payload.geoLocation.longitude

  • La longitude de l'emplacement physique du site.

  • Type : Number

événement Payload.address

  • L'adresse du site.

  • Type : String

événement Payload.serialNumber

  • Le numéro de série de l'actif.

  • Type : String

événement Payload.make

  • La marque de l'actif.

  • Type : String

événement Payload.model

  • Le modèle de l'actif.

  • Type : String