View a markdown version of this page

Comprensión del esquema de exportación de datos v2 - Amazon Monitron
Formato del esquema v2Parámetros del esquema v2

Amazon Monitron ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener información sobre capacidades similares a las de Amazon Monitron, consulte nuestra entrada de blog.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comprensión del esquema de exportación de datos v2

Cada dato de medición, su correspondiente resultado de inferencia connect/disconnect, puerta de enlace y connect/disconnect eventos de sensores se exportan como un registro de flujo de datos de Kinesis en formato JSON.

Formato del esquema 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"
    }
}

Parámetros del esquema v2

El esquema de exportación de datos de Kinesis v2 de Amazon Monitron incluye los siguientes parámetros de esquema. Algunos parámetros son actualizaciones de v1 y otros son exclusivos de v2. Por ejemplo, siteName era un parámetro de primer nivel en v1. En v2, es un parámetro de segundo nivel que se encuentra bajo la entidad eventPayload.

timestamp

  • La marca de tiempo en UTC en la que el servicio de Amazon Monitron recibe la medición

  • Tipo: cadena

  • Patrón: aaaa-mm-dd hh:mm:ss.SSS

eventId

  • El ID de evento de exportación de datos único asignado a cada medición. Se puede utilizar para deduplicar los registros de flujo de Kinesis recibidos.

  • Tipo: cadena

versión

  • Versión del esquema

  • Tipo: cadena

  • Valor: 1.0 o 2.0

accountId

  • El ID de AWS cuenta de 12 dígitos de su proyecto de Monitron

  • Tipo: cadena

projectName

El nombre del proyecto que se muestra en la aplicación y en la consola.

Tipo: cadena

projectId

El identificador único de tu Amazon Monitron proyecto.

Tipo: cadena

eventType

  • El flujo de eventos actual. Cada tipo de evento tiene un formato eventPayload específico.

  • Tipo: cadena

  • Valores posibles: measurement, gatewayConnected, gatewayDisconnected, sensorConnected, sensorDisconnected o assetStateTransition.

eventType: measurement

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 0‑6000 Hz en el eje x

  • Tipo: Number

  • Unidad: m/s ^2

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 0‑6000 Hz en el eje y

  • Tipo: Number

  • Unidad: m/s ^2

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 0‑6000 Hz en el eje z

  • Tipo: Number

  • Unidad: m/s ^2

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

  • La aceleración máxima absoluta observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • Unidad: m/s ^2

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

  • La aceleración mínima absoluta observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • Unidad: m/s ^2

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

  • El factor de cresta de aceleración observado en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • m/s^2

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 10‑1000 Hz en el eje x

  • Tipo: Number

  • m/s^2

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 10‑1000 Hz en el eje y

  • Tipo: Number

  • m/s^2

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

  • La raíz cuadrada media de la aceleración observada en la banda de frecuencia 10‑1000 Hz en el eje z

  • Tipo: Number

  • m/s^2

evento Payload.features.temperature

  • La temperatura observada

  • Tipo: Number

  • °C/degC

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

  • La aceleración máxima absoluta observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • mm/s

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

  • La aceleración mínima absoluta observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • mm/s

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

  • El factor de cresta de velocidad observado en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

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

  • La raíz cuadrada media de la velocidad observada en la banda de frecuencia 10‑1000 Hz

  • Tipo: Number

  • mm/s

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

  • La raíz cuadrada media de la velocidad observada en la banda de frecuencia 10‑1000 Hz en el eje x

  • Tipo: Number

  • mm/s

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

  • La raíz cuadrada media de la velocidad observada en la banda de frecuencia 10‑1000 Hz en el eje y

  • Tipo: Number

  • mm/s

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

  • La raíz cuadrada media de la velocidad observada en la banda de frecuencia 10‑1000 Hz en el eje z

  • Tipo: Number

  • mm/s

evento Payload.sequenceNo

  • El número de secuencias de medición

  • Tipo: Number

evento Payload.assetPositionId

  • El identificador de la posición del sensor para la que se envía la medición.

  • Tipo: cadena

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

evento Payload.serialNumber

  • El número de serie del activo.

  • Tipo: cadena

evento Payload.make

  • La marca del activo.

  • Tipo: cadena

evento Payload.model

  • El modelo del activo.

  • Tipo: cadena

eventType: sensorConnected

siteName

  • El nombre del sitio que se muestra en la aplicación

  • Tipo: cadena

assetName

  • El nombre del activo que se muestra en la aplicación

  • Tipo: cadena

positionName

  • El nombre de la posición del sensor que se muestra en la aplicación

  • Tipo: cadena

assetPositionURL

  • El URL del sensor que se muestra en la aplicación

  • Tipo: cadena

physicalID

  • El ID físico del sensor desde el que se envía la medición

  • Tipo: cadena

evento Payload.assetPositionId

  • El identificador de la posición del sensor cuyo estado ha cambiado.

  • Tipo: cadena

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

evento Payload.serialNumber

  • El número de serie del activo.

  • Tipo: cadena

evento Payload.make

  • La marca del activo.

  • Tipo: cadena

evento Payload.model

  • El modelo del activo.

  • Tipo: cadena

eventType: sensorDisconnected

siteName

  • El nombre del sitio que se muestra en la aplicación

  • Tipo: cadena

assetName

  • El nombre del activo que se muestra en la aplicación

  • Tipo: cadena

positionName

  • El nombre de la posición del sensor que se muestra en la aplicación

  • Tipo: cadena

assetPositionURL

  • El URL del sensor que se muestra en la aplicación

  • Tipo: cadena

physicalID

  • El ID físico del sensor desde el que se envía la medición

  • Tipo: cadena

evento Payload.assetPositionId

  • El identificador de la posición del sensor cuyo estado ha cambiado.

  • Tipo: cadena

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

evento Payload.serialNumber

  • El número de serie del activo.

  • Tipo: cadena

evento Payload.make

  • La marca del activo.

  • Tipo: cadena

evento Payload.model

  • El modelo del activo.

  • Tipo: cadena

eventType: gatewayConnected

evento Payload.siteName

  • El nombre del sitio que se muestra en la aplicación

  • Tipo: cadena

evento Payload.gatewayName

  • El nombre de la puerta de enlace que se muestra en la aplicación

  • Tipo: cadena

evento Payload.gatewayListURL

  • El URL de la puerta de enlace que se muestra en la aplicación

  • Tipo: cadena

evento Payload.gateway.physicalID

  • El ID físico de la puerta de enlace apenas conectada para transmitir datos al servicio de Amazon Monitron

  • Tipo: cadena

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

eventType: gatewayDisconnected

siteName

  • El nombre del sitio que se muestra en la aplicación

  • Tipo: cadena

gatewayName

  • El nombre de la puerta de enlace que se muestra en la aplicación

  • Tipo: cadena

gatewayListURL

  • El URL de la puerta de enlace que se muestra en la aplicación

  • Tipo: cadena

physicalID

  • El ID físico de la puerta de enlace apenas conectada para transmitir datos al servicio de Amazon Monitron

  • Tipo: cadena

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

eventType: assetStateTransition

evento Payload.siteName

  • El nombre del sitio que se muestra en la aplicación

  • Tipo: cadena

evento Payload.assetName

  • El nombre del activo que se muestra en la aplicación

  • Tipo: cadena

evento Payload.positionName

  • El nombre de la posición del sensor que se muestra en la aplicación

  • Tipo: cadena

evento Payload.assetPositionURL

  • El URL del sensor que se muestra en la aplicación

  • Tipo: cadena

evento Payload.sensor.physicalID

  • El ID físico del sensor desde el que se envía la medición

  • Tipo: cadena

evento Payload.assetTransitionType

  • El motivo de la transición de estado del activo

  • Tipo: cadena

  • Valores posibles: measurement o userInput

evento Payload.assetState.newState

  • El nuevo estado del activo

  • Tipo: cadena

evento Payload.assetState.previousState

  • El estado anterior del activo

  • Tipo: cadena

evento Payload.closureCode.failureMode

  • El modo de error seleccionado por el usuario al reconocer este fallo

  • Tipo: cadena

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

evento Payload.closureCode.failureCause

  • La causa del fallo seleccionada por el usuario en el menú desplegable de la aplicación al reconocer un fallo.

  • Tipo: cadena

  • Valores posibles: ADMINISTRATION | DESIGN | FABRICATION | MAINTENANCE | OPERATION | OTHER | QUALITY | UNDETERMINED | WEAR

evento Payload.closureCode.actionTaken

  • La acción que se realiza al cerrar esta anomalía seleccionada por el usuario en el menú desplegable de la aplicación.

  • Tipo: cadena

  • Valores posibles: ADJUST | CLEAN | LUBRICATE | MODIFY | NO_ACTION | OTHER | OVERHAUL | REPLACE

evento Payload.closureCode.resolvedModels

  • El conjunto de modelos que pusieron de manifiesto el problema.

  • Tipo: Lista de cadenas

  • Valores posibles: vibrationISO | vibrationML | temperatureML

evento Payload.assetPositionId

  • El identificador de la posición del activo cuyo estado cambió.

  • Tipo: cadena

modelos.temperatura ML.persistentClassificationOutput

  • El resultado de clasificación persistente del modelo de machine learning basado en la temperatura

  • Tipo: Number

  • Valores válidos: UNKNOWN | HEALTHY | WARNING | ALARM

modelos.temperatura ML.pointwiseClassificationOutput

  • El resultado de clasificación puntual del modelo de machine learning basado en la temperatura

  • Tipo: cadena

  • Valores válidos: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

modelos.vibración ISO.isoClass

  • La clase ISO 20816 (norma de medición y evaluación de vibración de máquinas) utilizada por el modelo de vibración basado en ISO

  • Tipo: cadena

  • Valores válidos: CLASS1 | CLASS2 | CLASS3 | CLASS4

modelos.vibración ISO.mutedThreshold

  • El umbral para silenciar la notificación del modelo de vibración basado en ISO

  • Tipo: cadena

  • Valores válidos: WARNING | ALARM

modelos.vibración ISO.persistentClassificationOutput

  • La salida de clasificación persistente del modelo de vibración basado en ISO

  • Tipo: cadena

  • Valores válidos: UNKNOWN | HEALTHY | WARNING | ALARM

modelos.vibración ISO.pointwiseClassificationOutput

  • La salida de clasificación puntual del modelo de vibraciones basado en ISO

  • Tipo: cadena

  • Valores válidos: UNKNOWN | HEALTHY | WARNING | ALARM | MUTED_WARNING | MUTED_ALARM

modelos.vibración ML.persistentClassificationOutput

  • La salida de clasificación persistente del modelo de vibración basado en machine learning

  • Tipo: cadena

  • Valores válidos: UNKNOWN | HEALTHY | WARNING | ALARM

modelos.vibración ML.pointwiseClassificationOutput

  • La salida de clasificación puntual del modelo de vibración basado en machine learning

  • Tipo: cadena

  • Valores válidos: UNKNOWN | INITIALIZING | HEALTHY | WARNING | ALARM

activo State.newState

  • El estado de la máquina después de procesar la medición

  • Tipo: cadena

  • Valores válidos: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

activo State.previousState

  • El estado de la máquina antes de procesar la medición

  • Tipo: cadena

  • Valores válidos: UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM

evento Payload.companyName

  • El nombre de la empresa que utiliza el activo.

  • Tipo: cadena

evento Payload.geoLocation.latitude

  • La latitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.geoLocation.longitude

  • La longitud de la ubicación física del sitio.

  • Tipo: Number

evento Payload.address

  • La dirección del sitio.

  • Tipo: cadena

evento Payload.serialNumber

  • El número de serie del activo.

  • Tipo: cadena

evento Payload.make

  • La marca del activo.

  • Tipo: cadena

evento Payload.model

  • El modelo del activo.

  • Tipo: cadena