Comprendre le schéma d'exportation de 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 de données v2

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

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",
        "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",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "string"
    }
    
    // sensorDisconnected
    "eventPayload": {
        "siteName": "string",
        "assetName": "string",
        "positionName": "string",
        "assetPositionURL": "string",
        "sensor": {
            "physicalId": "string"
        },
        "assetPositionId": "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"
    }
}

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 v1 et d'autres sont uniques à la v2. Par exemple, siteName était un paramètre de premier niveau dans la version 1. En v2, il s'agit d'un paramètre de second niveau qui se trouve sous l'eventPayloadentité.

timestamp

  • L'horodatage auquel la mesure est reçue par le service Amazon Monitron dans UTC

  • Type : String

  • Motif : yyyy-mm-dd hh:mm:ss. SSS

eventId

  • L'identifiant unique de l'événement d'exportation de données 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 de l'événement en cours. Chaque type d'événement aura un eventPayload format dédié.

  • Type : String

  • Valeurs possibles :measurement,gatewayConnected,gatewayDisconnected,sensorConnected,sensorDisconnected,assetStateTransition.

eventType: measurement

eventPayload. Caractéristiques. Accélération. Bande de 0 à 6000 Hz. xAxis.rms

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

  • Type : nombre

  • Unité : m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 0 à 6000 Hz. yAxis.rms

  • La racine carrée moyenne de l'accélération observée dans la bande de fréquences de 0 à 6 000 Hz sur l'axe y.

  • Type : nombre

  • Unité : m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 0 à 6000 Hz. zAxis.rms

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

  • Type : nombre

  • Unité : m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. resultantVector. absMax

  • Accélération maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

  • Unité : m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. resultantVector. absMin

  • Accélération minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

  • Unité : m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. resultantVector. crestFactor

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

  • Type : nombre

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. resultantVector.rms

  • La moyenne quadratique de l'accélération observée dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

  • m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. xAxis.rms

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

  • Type : nombre

  • m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. yAxis.rms

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

  • Type : nombre

  • m/s^2

eventPayload. Caractéristiques. Accélération. Bande de 10 à 1000 Hz. zAxis.rms

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

  • Type : nombre

  • m/s^2

eventPayload.caractéristiques.température

  • La température observée

  • Type : nombre

  • °C/degrés C

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. resultantVector. absMax

  • Vitesse maximale absolue observée dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

  • mm/s

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. resultantVector. absMin

  • Vitesse minimale absolue observée dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

  • mm/s

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. resultantVector. crestFactor

  • Le facteur de crête de vitesse observé dans la bande de fréquences de 10 à 1 000 Hz

  • Type : nombre

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. resultantVector.rms

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

  • Type : nombre

  • mm/s

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. xAxis.rms

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

  • Type : nombre

  • mm/s

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. yAxis.rms

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

  • Type : nombre

  • mm/s

eventPayload. Caractéristiques. Vitesse. Bande de 10 à 1000 Hz. zAxis.rms

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

  • Type : nombre

  • mm/s

eventPayload.sequenceNo

  • Le numéro de séquence de mesure

  • Type : nombre

eventPayload.assetPositionId

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

  • Type : String

eventType: sensorConnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

assetName

  • Le nom de la ressource affiché dans l'application

  • Type : String

positionName

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

  • Type : String

assetPositionURL

  • Le capteur URL affiché dans l'application

  • Type : String

Identifiant physique

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

  • Type : String

eventPayload.assetPositionId

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

  • Type : String

eventType: sensorDisconnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

assetName

  • Le nom de la ressource affiché dans l'application

  • Type : String

positionName

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

  • Type : String

assetPositionURL

  • Le capteur URL affiché dans l'application

  • Type : String

Identifiant physique

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

  • Type : String

eventPayload.assetPositionId

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

  • Type : String

eventType: gatewayConnected

eventPayload.siteName

  • Le nom du site affiché dans l'application

  • Type : String

eventPayload.gatewayName

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

  • Type : String

eventPayload.gatewayListURL

  • La passerelle URL affichée dans l'application

  • Type : String

eventPayload.gateway.PhysicalID

  • L'identifiant physique de la passerelle qui vient d'être connectée pour transmettre les données au service Amazon Monitron

  • Type : String

eventType: gatewayDisconnected

siteName

  • Le nom du site affiché dans l'application

  • Type : String

gatewayName

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

  • Type : String

gatewayListURL

  • La passerelle URL affichée dans l'application

  • Type : String

Identifiant physique

  • L'identifiant physique de la passerelle qui vient d'être connectée pour transmettre les données au service Amazon Monitron

  • Type : String

eventType: assetStateTransition

eventPayload.siteName

  • Le nom du site affiché dans l'application

  • Type : String

eventPayload.assetName

  • Le nom de la ressource affiché dans l'application

  • Type : String

eventPayload.positionName

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

  • Type : String

eventPayload.assetPositionURL

  • Le capteur URL affiché dans l'application

  • Type : String

eventPayload.sensor.PhysicalID

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

  • Type : String

eventPayload.assetTransitionType

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

  • Type : String

  • Valeurs possibles : measurement ou userInput

eventPayload.assetState.newState

  • Le nouvel état de l'actif

  • Type : String

eventPayload.assetState.previousState

  • L'état précédent de l'actif

  • Type : String

eventPayload.closureCode.failureMode

  • Le mode de défaillance sélectionné par l'utilisateur lors de la confirmation de cet échec

  • Type : String

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

eventPayload.closureCode.failureCause

  • La cause de l'échec, telle que sélectionnée par l'utilisateur dans la liste déroulante de l'application lorsqu'il reconnaît l'échec.

  • Type : String

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

eventPayload.closureCode.actionTaken

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

  • Type : String

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

eventPayload.closureCode.resolvedModels

  • L'ensemble de modèles qui a mis en évidence le problème.

  • Type : liste de chaînes

  • Valeurs possibles : vibrationISO | vibrationML | temperatureML

eventPayload.assetPositionId

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

  • Type : String

Modèles. TemperatureML. persistentClassificationOutput

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

  • Type : nombre

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM

Modèles. TemperatureML. pointwiseClassificationOutput

  • La sortie de classification par points 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 ISO basé

  • 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 ISO basé

  • Type : String

  • Valeurs valides : WARNING | ALARM

modèles.vibration. ISO persistentClassificationOutput

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

  • Type : String

  • Valeurs valides : UNKNOWN | HEALTHY | WARNING | ALARM

modèles.vibration. ISO pointwiseClassificationOutput

  • La sortie de classification par points du modèle de vibration ISO basé

  • Type : String

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

Modèles.vibrationML. 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.vibrationML. pointwiseClassificationOutput

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

  • Type : String

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

assetState.newState

  • État de la machine après le traitement de la mesure

  • Type : String

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

assetState.previousState

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

  • Type : String

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