Añadir un destino almacenado en AWS IoT SiteWise búfer mediante Amazon S3 - AWS IoT SiteWise

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.

Añadir un destino almacenado en AWS IoT SiteWise búfer mediante Amazon S3

El tipo de destino almacenado en búfer te permite ahorrar en costes de ingesta AWS IoT SiteWise si no necesitas los datos en tiempo real. Le permite almacenar temporalmente sus datos de IoT en un bucket de Amazon S3 antes de importarlos AWS IoT SiteWise. O simplemente puede cargar sus datos a S3 para almacenarlos, independientemente de si planea importarlos o no AWS IoT SiteWise. Esto resulta útil para agrupar y almacenar en búfer los datos de sus dispositivos y pasarelas antes de incorporarlos. AWS IoT SiteWise Con esta opción, los datos se cargan en el bucket S3 especificado en formato Parquet con una frecuencia configurada. A continuación, puede importar estos datos al AWS IoT SiteWise almacenamiento para su posterior análisis y procesamiento.

Para añadir un destino almacenado en búfer mediante Amazon S3

Utilice la AWS IoT SiteWise consola o AWS CLI añada un destino que almacene datos en búfer mediante Amazon S3 a su puerta de enlace SiteWise Edge.

Console

Úselo AWS Management Console para añadir un AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3.

  1. Abra la consola de AWS IoT SiteWise.

  2. En el panel de navegación, seleccione Puertas de enlace Edge.

  3. Seleccione la puerta de enlace a la que quiere añadir un destino.

  4. En la sección Destinos, selecciona Añadir destino.

  5. En la página Añadir destino, introduce los detalles del destino:

    1. Un nombre para el destino en el campo Nombre del destino.

    2. Seleccione AWS IoT SiteWise Almacenado en búfer mediante Amazon S3 como Tipo de destino. AWS IoT SiteWise almacenado en búfer con Amazon S3 envía los datos a Amazon Simple Storage Service por lotes, en formato Parquet, y después los importa al almacenamiento. AWS IoT SiteWise

  6. Introduzca la URL de Amazon S3 de la ubicación en la que desee almacenar los datos de la puerta de enlace. Para buscar la ruta, seleccione Browse S3. Una vez que haya agregado un depósito, también podrá verlo seleccionando Ver.

  7. Especifique la frecuencia con la que su puerta de enlace debe cargar datos a Amazon S3 introduciendo un período de tiempo y seleccionando un incremento de tiempo para la frecuencia de carga de datos. El valor de frecuencia debe ser superior a 0 e inferior o igual a 30 días.

  8. En Configuración de almacenamiento de datos, determine qué hacer con los datos de la puerta de enlace después de importarlos a AWS IoT SiteWise. Hay dos decisiones que se deben tomar en relación con el almacenamiento de datos:

    • Si desea copiar los datos importados al AWS IoT SiteWise almacenamiento, active la casilla Copiar los datos al almacenamiento. Esta opción duplica los datos importados del bucket de Amazon S3 configurado en el AWS IoT SiteWise almacenamiento.

    • Si decide importar los datos de su bucket de Amazon S3 al AWS IoT SiteWise almacenamiento, también puede especificar si los datos importados se deben eliminar una vez finalizada la importación. Seleccione la casilla Eliminar datos de Amazon S3 para eliminar la fecha importada del bucket de Amazon S3 configurado después de importarla al AWS IoT SiteWise almacenamiento.

  9. Añada filtros de ruta a su destino. Para obtener más información, consulte, Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge.

AWS CLI
ejemplo : Cree un nuevo AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3

Utilice la UpdateGatewayCapabilityConfigurationAPI para configurar el publicador.

Establezca el parámetro capabilityNamespace como iotsitewise:publisher:3.

{
    "sources": [
      {
        "type": "MQTT"
      }
    ],
    "destinations": [
      {
        "type": "SITEWISE_BUFFERED",
        "name": "your-s3-destination-name",
        "config": {
          "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
          "publishPolicy": {
            "publishFrequency": "15m",
            "localSizeLimitGB": 10
          },
          "siteWiseImportPolicy": {
            "enableSiteWiseStorageImport": true,
            "enableDeleteAfterImport": true,
            "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
          }
        },
        "filters": [
          {
            "type": "PATH",
            "config": {
              "paths": [
                "#"
              ]
            }
          }
        ]
      }
    ]
  }
ejemplo : Actualizar un AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3

Para actualizar un destino AWS IoT SiteWise en tiempo real existente, utilice primero la DescribeGatewayCapabilityConfiguration API para encontrar el. destinationId

Espacio de nombres del publicador: iotsitewise:publisher:3

{
    "sources": [
      {
        "type": "MQTT"
      }
    ],
    "destinations": [
      {
        "id": "your-existing-destination-id",
        "type": "SITEWISE_BUFFERED",
        "name": "your-s3-destination-name",
        "config": {
          "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
          "publishPolicy": {
            "publishFrequency": "15m",
            "localSizeLimitGB": 10
          },
          "siteWiseImportPolicy": {
            "enableSiteWiseStorageImport": true,
            "enableDeleteAfterImport": true,
            "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
          }
        },
        "filters": [
          {
            "type": "PATH",
            "config": {
              "paths": [
                "#"
              ]
            }
          }
        ]
      }
    ]
  }

Las siguientes opciones de configuración son específicas de las puertas de enlace habilitadas para MQTT que utilizan el espacio de nombres. iotsitewise:publisher:3

sources

Define las fuentes de datos a las que se transferirán los datos de su equipo industrial. AWS IoT SiteWise Para las pasarelas habilitadas para MQTT, utilice. MQTT

Tipo: Matriz de objetos

Obligatorio: sí

destinations

Define dónde enviar los datos. Los destinos se transmiten en tiempo real o se almacenan en búfer mediante Amazon S3. Se requiere al menos un objeto de destino, pero puede añadir una matriz vacía. Puede tener un destino en tiempo real para cada puerta de enlace. Para obtener más información, consulte Comprenda los destinos de AWS IoT SiteWise Edge.

Tipo: Matriz de objetos

Obligatorio: sí

id

El identificador único del destino. Puede proporcionar un identificador de destino existente o dejarlo en blanco para que se genere automáticamente un nuevo identificador para el destino.

Tipo: cadena

Requerido: no

type

Tipo de destino. Las opciones incluyen: SITEWISE_REALTIME ySITEWISE_BUFFERED. Elija SITEWISE_BUFFERED.

  • SITEWISE_REALTIME(predeterminado): envía los datos directamente al AWS IoT SiteWise almacenamiento en tiempo real. Para obtener más información, consulte Agregue un destino de AWS IoT SiteWise Edge en tiempo real.

  • SITEWISE_BUFFERED— Envíe los datos a Amazon S3 en lotes en formato Parquet y, a continuación, impórtelos al AWS IoT SiteWise almacenamiento.

Tipo: cadena

Obligatorio: sí

name

Un nombre único para el destino.

Tipo: cadena

Obligatorio: sí

config

Configuración específica para el tipo de destino en formato JSON. La configuración varía entre los destinos en tiempo real y los almacenados en búfer.

Tipo: objeto

Obligatorio: sí

targetBucketArn

El ARN del bucket en el que se va a publicar. Elija lo mismo Región de AWS para Amazon S3 AWS IoT SiteWise y para Amazon S3. Si elige un prefijo, debe tener entre 1 y 255 caracteres.

nota

AWS IoT SiteWise, incluida la puerta de enlace, tendrá acceso a todo el bucket de S3 especificado. Recomendamos utilizar un depósito dedicado para la ingesta de datos almacenados en búfer.

Tipo: cadena

Obligatorio: sí

publishPolicy

Detalles de la política de publicación.

Tipo: objeto

Obligatorio: sí

publishFrequency

La frecuencia con la que la puerta de enlace SiteWise Edge publica en el bucket de Amazon S3. La frecuencia de carga de datos a Amazon S3 debe ser superior a 0 minutos e inferior o igual a 30 días. Puede usar mh, y d cuando especifique una frecuencia de publicación, la antigüedad. Tenga en cuenta que m representa minutos, h representa horas y d representa días. El valor predeterminado es 15 minutos.

Tipo: cadena

Obligatorio: sí

localSizeLimitGB

El tamaño máximo de los archivos escritos en el disco local en GB. Si se supera este umbral, el publicador publica todos los datos almacenados en el búfer en su destino.

Tipo: entero

Obligatorio: sí

siteWiseImportPolicy

Detalles de la política de importación para importar datos a AWS IoT SiteWise.

Tipo: objeto

Obligatorio: sí

enableSiteWiseStorageImport

trueConfigúrelo para importar datos de un bucket de Amazon S3 al AWS IoT SiteWise almacenamiento. Inicialmente, hace una copia de los datos en AWS IoT SiteWise. A continuación, si se establece en enableDeleteAfterImport true, los datos de S3 se eliminan después de copiarlos a AWS IoT SiteWise. Se aplican las implicaciones de precio. El valor predeterminado es true.

Tipo: Booleano

Obligatorio: sí

enableDeleteAfterImport

trueConfigúrelo para eliminar el archivo del bucket de Amazon S3 después de introducirlo en el AWS IoT SiteWise almacenamiento. El valor predeterminado es true.

Tipo: Booleano

Obligatorio: sí

bulkImportJobRoleArn

El ARN de la función de IAM que AWS IoT SiteWise asume leer los datos almacenados en búfer de Amazon S3 durante la ingesta de datos. Esta función se utiliza cuando un dispositivo perimetral solicita iniciar el proceso de AWS IoT SiteWise APIs importación masiva.

nota

Si enableSiteWiseStorageImport se establece entrue, este parámetro es obligatorio.

Tipo: cadena

Requerido: no

Añada filtros de ruta para su destino. Para obtener más información, consulte Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge.