SiteWise Publicador de IoT - AWS IoT Greengrass
VersionesTipoSistema operativoRequisitosDependenciasConfiguraciónDatos de entradaArchivo de registro localSolución de problemas y depuraciónLicenciasRegistros de cambiosVéase también

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.

SiteWise Publicador de IoT

El componente SiteWise publicador de IoT (aws.iot.SiteWiseEdgePublisher) permite a AWS IoT SiteWise las pasarelas exportar datos del borde al Nube de AWS.

Para obtener más información sobre AWS IoT SiteWise las puertas de enlace, consulte Uso AWS IoT SiteWise en el borde en la Guía del AWS IoT SiteWise usuario.

Versiones

Este componente tiene las siguientes versiones:

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente es un componente genérico () aws.greengrass.generic. El núcleo de Greengrass ejecuta los scripts del ciclo de vida del componente.

Para obtener más información, consulte Tipos de componentes.

Sistema operativo

Este componente se puede instalar en los dispositivos principales que ejecutan los siguientes sistemas operativos:

  • Linux

  • Windows

Requisitos

Este componente tiene los siguientes requisitos:

  • El dispositivo principal de Greengrass debe ejecutarse en una de las siguientes plataformas:

    • OS: Ubuntu 18.04 o posterior

      Arquitectura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • OS: Red Hat Enterprise Linux (RHEL) 8

      Arquitectura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • OS: Amazon Linux 2

      Arquitectura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • OS: Debian 11

      Arquitectura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • Sistema operativo: Windows Server 2019 o posterior

      Arquitectura: x86_64 (AMD64)

  • El dispositivo principal de Greengrass debe estar conectado a Internet.

  • El dispositivo principal de Greengrass debe estar autorizado para realizar la iotsitewise:BatchPutAssetPropertyValue acción. Para obtener más información, consulte Autorizar los dispositivos principales para que interactúen con AWS los servicios.

    ejemplo política de permisos
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Puntos finales y puertos

Este componente debe poder realizar solicitudes salientes a los siguientes puntos finales y puertos, además de a los puntos finales y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte Permitir el tráfico del dispositivo a través de un proxy o firewall.

punto de enlace Puerto Obligatoria Descripción

data.iotsitewise.region.amazonaws.com

 443 Sí

Publique datos en. AWS IoT SiteWise

Dependencias

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementarlo correctamente. En esta sección se enumeran las dependencias de las versiones publicadas de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la consola.AWS IoT Greengrass En la página de detalles del componente, busque la lista de dependencias.

La siguiente tabla muestra las dependencias de las versiones 2.0.x a 2.2.x de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.3.0<3.0.0 Rígido
Administrador de transmisiones >=2.3.0 =2.0.10<3.0.0 Rígido

Para obtener más información sobre las dependencias de los componentes, consulta la referencia de recetas de componentes.

Configuración

Este componente no tiene ningún parámetro de configuración.

Puede usar la AWS IoT SiteWise consola o la API para configurar el componente de SiteWise editor de IoT. Para obtener más información, consulte el paso 3: Configurar el editor (opcional) en la Guía del AWS IoT SiteWise usuario.

Datos de entrada

Este componente lee PutAssetPropertyValueEntry los mensajes del administrador de AWS IoT Greengrass transmisiones. Para obtener más información, consulte PutAssetPropertyValueEntryla referencia de la AWS IoT SiteWise API.

Archivo de registro local

Este componente utiliza el siguiente archivo de registro.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Para ver los registros de este componente

  • Ejecute el siguiente comando en el dispositivo principal para ver el archivo de registro de este componente en tiempo real. Sustituya /greengrass/v2 o C:\greengrass\v2 por la ruta a la carpeta AWS IoT Greengrass raíz.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

Solución de problemas y depuración

Este componente incluye un nuevo registro de eventos para ayudar a los clientes a identificar y solucionar problemas. El archivo de registro es independiente del archivo de registro local y se encuentra en la siguiente ubicación. Sustituya /greengrass/v2 o C:\greengrass\v2 por la ruta de acceso a la carpeta AWS IoT Greengrass raíz.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Este registro incluye información detallada e instrucciones de solución de problemas. La información sobre la solución de problemas se proporciona junto con los diagnósticos, con una descripción de cómo solucionar el problema y, a veces, con enlaces a más información. La información de diagnóstico incluye lo siguiente:

  • Nivel de gravedad

  • Timestamp

  • Información adicional específica del evento

ejemplo Registro de ejemplo
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

Licencias

Este componente se publica en virtud del contrato de licencia de software principal de Greengrass.

Registros de cambios

En la siguiente tabla se describen los cambios en cada versión del componente.

Versión

Cambios

3.1.3
Mejoras y correcciones de errores

  • Se resolvió un problema por el que se /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log creaba el archivo de registro de eventos ubicado en pero no se registraba ningún evento.

  • Se agregaron las siguientes CloudWatch métricas para monitorear la conexión con el broker MQTT:

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

    Para obtener más información sobre estas métricas, consulte las métricas de la AWS IoT Greengrass Version 2 puerta de enlace.

  • Se resolvió un problema por el que se seguía llamando a la BatchCreateJob API aunque se produjera un error al cargar un archivo de parquet a S3.

3.1.2
Mejoras y correcciones de errores

  • Se ha corregido el problema del elevado uso de la CPU introducido en la versión 3.1.1.

3.1.1
Mejoras y correcciones de errores

  • Añade un registro adicional que identifica los alias de datos afectados cuando se produce un error.

  • Añade la aplicación local de los límites de la AWS IoT SiteWise API en cuanto a la antigüedad de los datos ingeridos.

  • Soluciona el problema por el que Publisher confunde los puntos de control de las StreamManager transmisiones cuando hay varios destinos de Amazon S3.

  • Corrige un obstáculo en el rendimiento relacionado con la forma en que el editor lee las transmisiones. StreamManager

3.1.0
Nuevas características

  • Añade soporte para publicar datos como archivos de parquet en Amazon S3.

  • Añade compatibilidad con la ingesta en AWS IoT SiteWise búfer.

3.0.0
Mejoras y correcciones de errores

  • Soluciona problemas relacionados con la compatibilidad con el proxy.

Nuevas características

  • Permite la ingesta de datos desde un bróker de MQTT.

2.4.1
Mejoras y correcciones de errores

  • Habilite el componente para que funcione con las versiones 11.0.20.8.1 y posteriores de Java Corretto 11. Las versiones de los componentes 2.4.0 y 2.3.3 muestran el mensaje de "Could not find or load main class" error cuando se utilizan con Java Corretto versión 11.0.20.8.1.

2.4.0
Nuevas características

  • Añade un nuevo registro de eventos para facilitar la identificación y la solución de problemas.

Mejoras y correcciones de errores

  • Mejora la recuperación de los puntos de control de Publisher.

2.3.3
Mejoras y correcciones de errores

  • Mejora la capacidad de soportar un alto rendimiento.

2.3.2
Mejoras y correcciones de errores

  • Corrige la compatibilidad con el proxy HTTP al descargar la configuración de Publisher.

2.3.1
Nuevas características

  • Añade compatibilidad con la instalación del paquete de recopilación de datos en la arquitectura ARMv8 de Linux.

  • Requisitos mínimos para Linux ARMv8:

    • Memoria: 4 GB

    • CPU: ARM Cortex-A72 o especificación equivalente

2.2.3
Mejoras y correcciones de errores

  • Elimina el reintento de una excepción genérica que no estaba en la lista de excepciones recuperables.

2.2.2
Mejoras y correcciones de errores

  • Reintroduce la compatibilidad con la carga de datos a AWS IoT SiteWise través de un servidor proxy HTTP.

2.2.1
nota

Esta versión no admite la configuración de proxy HTTP. La versión 2.2.2 y las posteriores vuelven a introducir la compatibilidad con esta función.

Nuevas características

  • Añade compatibilidad con este componente para activar o desactivar la compresión al cargar datos en él. AWS IoT SiteWise

2.2.0
nota

Esta versión no admite la configuración de proxy HTTP. La versión 2.2.2 y las posteriores vuelven a introducir la compatibilidad con esta función.

Nuevas características

  • Actualiza este componente para comprimir los datos antes de enviarlos al AWS IoT SiteWise servicio.

    • En la mayoría de los casos, este cambio reduce el uso del ancho de banda en un 75 por ciento en comparación con las versiones anteriores de este componente.

    • En la mayoría de los casos, este cambio aumenta el uso de la CPU hasta un 5 por ciento. En las puertas de enlace que procesan grandes cantidades de datos, este cambio puede aumentar el uso de la CPU hasta en un 15 por ciento.

    • Este cambio no afecta a los cargos por AWS IoT SiteWise servicio ni al uso de la cuota de servicio.

    • Añade compatibilidad con Windows Server 2019 o superior.

Mejoras y correcciones de errores

  • Corrige un problema que impedía que este componente se iniciara cuando el archivo de puntos de control estaba dañado.

2.1.4
Mejoras y correcciones de errores

  • Corrige la compatibilidad con la versión 8 de Java.

2.1.3
aviso

Esta versión ya no está disponible, excepto en las regiones EE.UU. Este (Ohio), Canadá (Centro) y AWS GovCloud (EE.UU. Este). Esta versión de componente requiere la versión 11 o superior de Java para ejecutarse. Las mejoras de esta versión están disponibles en versiones posteriores de este componente.

Mejoras y correcciones de errores

  • Mejora los mensajes de error al implementar este componente en dispositivos no compatibles.

  • Actualiza los errores de registro cuando se produce un error al cargar los datos.

2.1.2
Mejoras y correcciones de errores

  • Se actualiza para activar la función de exportación de datos caducados tan pronto como los datos caduquen.

2.1.1

Mejoras y correcciones de errores.

2.1.0
Nuevas características

  • Añade compatibilidad para publicar primero los datos más recientes en la nube.

  • Añade compatibilidad para no publicar datos caducados en la nube.

  • Añade compatibilidad con el almacenamiento local de datos caducados.

Mejoras y correcciones de errores

  • Reduce las E/S del disco y la latencia correspondiente.

2.0.2

Mejoras y correcciones de errores.

2.0.1

Versión inicial.

Véase también