Amazon Monitron ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener información sobre funciones similares a las de Amazon Monitron, consulte nuestra [entrada de blog](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron).
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.
# Exportación de datos de Amazon Monitron con Kinesis v1
**nota**
El esquema de exportación de datos de Amazon Monitron Kinesis v1 ha quedado en desuso. Obtenga más información sobre el esquema de exportación de datos [v2](monitron-kinesis-export-v2.md).
Puede exportar datos de mediciones entrantes y los resultados de inferencia correspondientes desde Amazon Monitron y realizar análisis en tiempo real. La exportación de datos transmite datos en directo a Kinesis.
**Topics**
+ [Exportación de datos a un flujo de Kinesis](#exporting-stream-procedure)
+ [Edición de los ajustes de exportación de datos en directo](#edit-live-export)
+ [Detención de una exportación de datos en directo](#stop-kinesis-export)
+ [Visualización de errores de exportación de datos](#viewing-kinesis-export-errors)
+ [Uso del cifrado en el lado del servidor para el flujo de Kinesis](#data-export-server-side-encryption)
+ [Supervisión con Amazon CloudWatch Logs](data-export-cloudwatch-logs.md)
+ [Almacenamiento de datos exportados en Amazon S3](kinesis-store-S3.md)
+ [Procesamiento de datos con Lambda](data-export-lambda.md)
+ [Comprensión del esquema de exportación de datos v1](data-export-schema.md)
## Exportación de datos a un flujo de Kinesis
1. En la página principal de su proyecto, casi en la parte inferior de la página, a la derecha, elija **Iniciar exportación de datos en directo**.
1. En **Seleccionar flujo de datos de Amazon Kinesis**, realice una de las siguientes acciones:
+ Introduzca el nombre de un flujo existente en el cuadro de búsqueda. A continuación, vaya al paso 5.
+ Elija **Crear un nuevo flujo de datos**.
1. En la página **Crear flujo de datos**, en **Configuración del flujo de datos**, introduzca el nombre de su flujo de datos.
1. En Capacidad de flujo de datos, elija su modo de capacidad:
+ Si los requisitos de rendimiento de su flujo de datos son impredecibles y variables, elija **Bajo demanda**.
+ Si puede estimar de forma fiable los requisitos de rendimiento de su flujo de datos, elija **Estipulado**. A continuación, en particiones estipuladas, introduzca el número de particiones que desee crear, o elija el **Estimador de particiones**.
1. Elija **Crear flujo de datos**.
## Edición de los ajustes de exportación de datos en directo
Para editar los ajustes de exportación de datos en directo:
1. Abra la consola de Amazon Monitron.
1. En el panel de navegación, elija **Proyectos**.
1. Si tiene múltiples proyectos, elija el proyecto para el que desea editar los ajustes de exportación.
1. En la página principal de su proyecto, en **Exportación de datos en directo**, en el menú desplegable **Acciones**, elija **Editar ajustes de exportación de datos en directo**.
## Detención de una exportación de datos en directo
1. Abra la consola de Amazon Monitron.
1. En el panel de navegación, elija **Proyectos**.
1. Si tiene múltiples proyectos, elija el proyecto para el que desea editar los ajustes de exportación.
1. En la página principal de su proyecto, en **Exportación de datos en directo**, en el menú desplegable **Acciones**, elija **Detener exportación de datos en directo**.
1. En la ventana emergente, elija **Detener**.
## Visualización de errores de exportación de datos
Para ver los mensajes de error en la interfaz CloudWatch de registros:
+ En la consola de Amazon Monitron, en la página principal de su proyecto, en **Exportación de datos en vivo**, elija grupo de **CloudWatch registros**.
## Uso del cifrado en el lado del servidor para el flujo de Kinesis
Puede habilitar el cifrado en el lado del servidor para su flujo de datos de Kinesis antes de configurar la exportación de datos de Kinesis. Sin embargo, si se habilita el cifrado en el lado del servidor después de configurar la exportación de datos de Kinesis, Amazon Monitron no podrá publicar en el flujo. Esto se debe a que Amazon Monitron no tendrá permiso para llamar a [kms](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html), GenerateDataKey por lo que podrá cifrar los datos enviados a Kinesis.
Para solucionar este problema, siga las instrucciones indicadas en [Edición de los ajustes de exportación de datos en directo](#edit-live-export), pero sin cambiar la configuración. Esto asociará el cifrado que haya establecido con su configuración de exportación.
# Supervisión con Amazon CloudWatch Logs
Puede supervisar la exportación de datos en tiempo real de Amazon Monitron mediante Amazon CloudWatch Logs. Si una medición no se puede exportar, Amazon Monitron enviará un evento de registro a sus CloudWatch registros. También puede configurar un filtro de métricas en el registro de errores para generar métricas y configurar alarmas. Una alarma puede vigilar determinados umbrales y enviar notificaciones o tomar medidas cuando se alcanzan dichos umbrales. Para obtener más información, consulte [la Guía del CloudWatch usuario](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html).
Amazon Monitron envía los eventos de registro al grupo de registros/aws/monitron/data-export/ \$1HASH\$1ID\$1.
El evento de registro tiene el siguiente formato JSON:
```
{
"assetDisplayName": "string",
"destination": "string",
"errorCode": "string",
"errorMessage": "string",
"eventId": "string",
"positionDisplayName": "string",
"projectDisplayName": "string",
"projectName": "string",
"sensorId": "string",
"siteDisplayName": "string",
"timestamp": "string"
}
```
assetDisplayName
+ El nombre del activo que se muestra en la aplicación
+ Tipo: cadena
destination
+ El ARN del flujo de datos de Kinesis
+ Tipo: cadena
+ Patrón: arn:aws:kinesis: \$1\$1REGION\$1\$1: \$1\$1\$1ID\$1\$1 :stream/ \$1\$1STREAM\$1NAME\$1\$1 AWS\$1ACCOUNT
errorCode
+ El código de error
+ Tipo: cadena
+ Valores válidos: `INTERNAL_SEVER_ERROR | KINESIS_RESOURCE_NOT_FOUND | KINESIS_PROVISIONED_THROUGHPUT_EXCEEDED | KMS_ACCESS_DENIED | KMS_NOT_FOUND | KMS_DISABLED | KMS_INVALID_STATE | KMS_THROTTLING`
errorMessage
+ El mensaje de error detallado
+ Tipo: cadena
eventId
+ El ID de evento único correspondiente a cada exportación de medición
+ Tipo: cadena
positionDisplayName
+ El nombre de la posición del sensor que se muestra en la aplicación
+ Tipo: cadena
sensorId
+ El ID físico del sensor desde el que se envía la medición
+ Tipo: cadena
siteDisplayName
+ El nombre del sitio que se muestra en la aplicación
+ Tipo: cadena
timestamp
+ La marca de tiempo en UTC en la que el servicio de Amazon Monitron recibe la medición
+ Tipo: cadena
+ yyyy-mm-ddPatrón: HH:MM:SS.SSS
# Almacenamiento de datos exportados en Amazon S3
**Topics**
+ [Uso de una plantilla predefinida CloudFormation](#kinesis-cloudfront-makestack)
+ [Configuración manual de Kinesis en la consola](#kinesis-configure-console)
## Uso de una plantilla predefinida CloudFormation
Amazon Monitron proporciona una AWS CloudFormation plantilla predefinida que ayuda a configurar rápidamente la Firehose para entregar datos desde una transmisión de datos de Kinesis al bucket de Amazon S3. Esta plantilla habilita el particionamiento dinámico y los objetos de Amazon S3 entregados utilizarán el siguiente formato de clave recomendado por Amazon Monitron: `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`
1. Inicie sesión en su cuenta. AWS
1. Abra una nueva pestaña del navegador con el siguiente URL:
```
https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/create/review?templateURL=https://s3.us-east-1.amazonaws.com/monitron-cloudformation-templates-us-east-1/monitron_kinesis_data_export.yaml&stackName=monitron-kinesis-live-data-export
```
1. En la CloudFormation página que se abre, en la esquina superior derecha, seleccione la región en la que utiliza Amazon Monitron.
1. De forma predeterminada, la plantilla crea un nuevo flujo de datos de Kinesis y un bucket de S3 junto con otros recursos necesarios para entregar datos a Amazon S3. Puede cambiar los parámetros a fin de utilizar los recursos existentes.
1. Marque la casilla que dice «*Reconozco que AWS CloudFormation podría crear recursos de IAM*».
1. Seleccione **Creación de pila**.
1. En la página siguiente, elija el icono de actualización tantas veces como desee hasta que el estado de la pila sea CREATE\$1COMPLETE.
## Configuración manual de Kinesis en la consola
1. Inicie sesión en la consola de AWS administración y abra la consola de Kinesis en /kinesis. https://console.aws.amazon.com
1. En el panel de navegación, elija **Flujos de entrega**.
1. Elija **Crear flujo de entrega**.
1. En Origen, elija **Amazon Kinesis Data Streams**.
1. En Destino, elija **Amazon S3**.
1. En **Configuración de origen, flujo de datos de Kinesis**, introduzca el ARN de su flujo de datos de Kinesis.
1. En **Nombre del flujo de datos**, introduzca el nombre de su flujo de datos de Kinesis.
1. En **Configuración de destino**, elija un bucket de Amazon S3 o introduzca un URI de bucket.
1. (opcional) Habilite el particionamiento dinámico mediante el análisis sintáctico en línea para JSON. Esta opción es apropiada si desea particionar los datos de medición en flujo continuo en función de la información de origen y la fecha y hora. Por ejemplo:
+ En **Partición dinámica**, elija **Habilitado**.
+ En **Nuevo delimitador de línea**, elija **Habilitado**.
+ En **Análisis sintáctico en línea para JSON**, elija **Habilitado**.
+ En **Claves de partición dinámica**, añada:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/kinesis-store-S3.html)
1. Elija **Aplicar claves de partición dinámica** y confirme que el prefijo del bucket de Amazon S3 generado sea `!{partitionKeyFromQuery:project}/!{partitionKeyFromQuery:site}/!{partitionKeyFromQuery:time}/`.
1. En Amazon S3, los objetos utilizan el siguiente formato de clave: `/project={projectName}/site={siteName}/time={yyyy-mm-dd 00:00:00}/{filename}`.
1. Elija **Crear flujo de entrega**.
1. (opcional) Utilice una ruta más granular.
Si ha elegido una partición dinámica, utilice el formato de clave anterior de Amazon S3 si piensa utilizar AWS Glue Athena para consultar los datos. También puede elegir un formato de clave más fino, pero la consulta de Amazon Athena no será eficiente. En este ejemplo se muestra cómo configurar una ruta de clave de Amazon S3 más fina.
En **Claves de partición dinámica**, añada:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/kinesis-store-S3.html)
En Amazon S3, los objetos utilizan el siguiente formato de clave: ` /project={projectName}/site={siteName}/asset={assetName}/position={positionName}/sensor={sensorId}/date={yyyy-mm-dd}/time={HH:MM:SS}/{filename}`
# Procesamiento de datos con Lambda
**Topics**
+ [Paso 1: Cree el [rol de IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) que otorgue permiso a su función para acceder a los recursos AWS](#create-iam-role)
+ [Paso 2: Crear la función de Lambda](#create-lambda-function)
+ [Paso 3: Configurar la función de Lambda](#configure-lambda-function)
+ [Paso 4: Habilitar el disparador de Kinesis en la consola AWS Lambda](#enable-lambda-trigger)
## Paso 1: Cree el [rol de IAM](https://docs.aws.amazon.com//lambda/latest/dg/lambda-intro-execution-role.html) que otorgue permiso a su función para acceder a los recursos AWS
1. Abra la [página Roles](https://console.aws.amazon.com/iam/home?#/roles) en la consola de IAM.
1. Elija **Crear rol**.
1. Cree un rol con las propiedades siguientes.
+ Entidad de confianza: Lambda
+ Permisos: AWSLambda KinesisExecutionRole (y AWSKey ManagementServicePowerUser si la transmisión de Kinesis está cifrada)
+ Nombre del rol: lambda-kinesis-role
![\[IAM role creation interface showing name, review, and create steps with role details and permissions.\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/images/lambda-create-role.png)
## Paso 2: Crear la función de Lambda
1. Abra la página **Funciones** en la consola de Lambda.
1. Seleccione **Creación de función**.
1. Elija **Utilizar un esquema**.
1. En la barra de búsqueda de **Blueprints**, busque y elija **kinesis-process-record (nodejs**) o. **kinesis-process-record-python**
1. Elija **Configurar**.
![\[Create function interface with options to author from scratch, use a blueprint, or select container image.\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/images/lambda-create-function.png)
## Paso 3: Configurar la función de Lambda
1. Elija **Nombre de la función**
1. Elija el rol creado en el primer paso como **Rol de ejecución**.
1. Configure el activador de Kinesis.
1. Elija su flujo de Kinesis.
1. Pulse **Crear función**.
![\[Lambda function configuration form with basic information and Kinesis trigger settings.\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/images/lambda-kinesis-trigger.png)
## Paso 4: Habilitar el disparador de Kinesis en la consola AWS Lambda
1. En la pestaña **Configuración**, elija **Activadores**.
1. Marque la casilla situada junto al nombre del flujo de Kinesis y elija **Habilitar**.
![\[Lambda function configuration page with Triggers tab and Kinesis stream trigger highlighted.\]](http://docs.aws.amazon.com/es_es/Monitron/latest/user-guide/images/kinesis-process-record-lambda.png)
El esquema utilizado en este ejemplo solo consume datos de registro del flujo seleccionado. Puede seguir editando el código de función de Lambda más adelante para completar una tarea más complicada.
# Comprensión del esquema de exportación de datos v1
**nota**
El esquema de exportación de datos de Amazon Monitron Kinesis v1 ha quedado en desuso. Obtenga más información sobre el esquema de exportación de datos [v2](monitron-kinesis-export-v2.md).
Cada dato de medición y su correspondiente resultado de inferencia se exportan como un registro de flujo de datos de Kinesis en formato JSON.
**Topics**
+ [Formato del esquema v1](#data-export-schema-format)
+ [Parámetros del esquema v1](#data-export-schema-parameters)
## Formato del esquema v1
```
{
"timestamp": "string",
"eventId": "string",
"version": "string",
"projectDisplayName": "string",
"siteDisplayName": "string",
"assetDisplayName": "string",
"sensorPositionDisplayName": "string",
"sensor": {
"physicalId": "string",
"rssi": number
},
"gateway": {
"physicalId": "string"
},
"measurement": {
"features": {
"acceleration": {
"band0To6000Hz": {
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
},
"band10To1000Hz": {
"resultantVector": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
},
"temperature": number,
"velocity": {
"band10To1000Hz": {
"resultantVector": {
"absMax": number,
"absMin": number,
"crestFactor": number,
"rms": number
},
"xAxis": {
"rms": number
},
"yAxis": {
"rms": number
},
"zAxis": {
"rms": number
}
}
}
},
"sequenceNo": number
},
"models": {
"temperatureML": {
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationISO": {
"isoClass": "string",
"mutedThreshold": "string",
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
},
"vibrationML": {
"persistentClassificationOutput": "string",
"pointwiseClassificationOutput": "string"
}
},
"assetState": {
"newState": "string",
"previousState": "string"
}
}
```
## Parámetros del esquema v1
timestamp
+ La marca de tiempo en UTC en que el servicio de Monitron recibe la medición
+ Tipo: cadena
+ Patrón: HH:MM:SS.SSS yyyy-mm-dd
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 actual: 1.0
projectDisplayName
+ El nombre del proyecto que se muestra en la aplicación y en la consola
+ Tipo: cadena
siteDisplayName
+ El nombre del sitio que se muestra en la aplicación
+ Tipo: cadena
assetDisplayName
+ El nombre del activo que se muestra en la aplicación
+ Tipo: cadena
sensorPositionDisplayNombre
+ El nombre de la posición del sensor que se muestra en la aplicación
+ Tipo: cadena
sensor.physicalId
+ El ID físico del sensor desde el que se envía la medición
+ Tipo: cadena
sensor.rssi
+ El valor del indicador de intensidad de señal bluetooth recibida del sensor
+ Tipo: Number
+ Unidad: dBm
gateway.physicalId
+ El ID físico de la puerta de enlace utilizada para transmitir datos al servicio de Amazon Monitron
+ Tipo: cadena
measurement.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
measurement.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
measurement.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 y
+ Tipo: Number
+ Unidad: m/s^2
measurement.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
measurement.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
measurement.features.acceleration.band10To1000Hz.resultantVector.crestFactor
+ El factor de cresta de aceleración observado en la banda de frecuencia 10‑1000 Hz
+ Tipo: Number
measurement.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
measurement.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
measurement.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
measurement.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
measurement.features.temperature
+ La temperatura observada
+ Tipo: Number
+ °C/grados C
measurement.features.velocity.band10To1000Hz.resultantVector.absMax
+ La aceleración máxima absoluta observada en la banda de frecuencia 10‑1000 Hz
+ Tipo: Number
+ mm/s
measurement.features.velocity.band10To1000Hz.resultantVector.absMin
+ La aceleración mínima absoluta observada en la banda de frecuencia 10‑1000 Hz
+ Tipo: Number
+ mm/s
measurement.features.velocity.band10To1000Hz.resultantVector.crestFactor
+ El factor de cresta de velocidad observado en la banda de frecuencia 10‑1000 Hz
+ Tipo: Number
measurement.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
measurement.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
measurement.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
measurement.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
measurement.sequenceNo
+ El número de secuencias de medición
+ Tipo: Number
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`
models.vibrationISO.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 | FAN_BV2`
models.vibrationISO.mutedThreshold
+ El umbral para silenciar la notificación del modelo de vibración basado en ISO
+ Tipo: cadena
+ Valores válidos: `WARNING | ALARM`
Modelos. Vibration 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. Vibration 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. Vibration 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. Vibration 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`
assetState.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`
assetState.previousState
+ El estado de la máquina antes de procesar la medición
+ Tipo: cadena
+ Valores válidos: `UNKNOWN | HEALTHY | NEEDS_MAINTENANCE | WARNING | ALARM`