Administrador de transmisiones - AWS IoT Greengrass

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.

Administrador de transmisiones

El componente administrador de flujos (aws.greengrass.StreamManager) le permite procesar flujos de datos para transferirlos Nube de AWS desde los dispositivos principales de Greengrass.

Para obtener más información sobre cómo configurar y usar el administrador de transmisiones en componentes personalizados, consulteGestione los flujos de datos en los dispositivos principales de Greengrass.

Versiones

Este componente tiene las siguientes versiones:

  • 2.1.x

  • 2.0.x

nota

Si utilizas el administrador de transmisiones para exportar datos a la nube, no puedes actualizar la versión 2.0.7 del componente de administrador de transmisiones a una versión entre la v2.0.8 y la v2.0.11. Si va a implementar Stream Manager por primera vez, le recomendamos encarecidamente que implemente la última versión del componente Stream Manager.

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:

  • La función de intercambio de fichas debe permitir el acceso a los Nube de AWS destinos que utilices con Stream Manager. Para obtener más información, consulte:

  • Se admite la ejecución del componente administrador de flujos en una VPC. Para implementar este componente en una VPC, se requiere lo siguiente.

    • El componente del administrador de transmisiones debe tener conectividad con el AWS servicio en el que se publican los datos.

      • Amazon S3: com.amazonaws.region.s3

      • Amazon Kinesis Data Streams: com.amazonaws.region.kinesis-streams

      • AWS IoT SiteWise: com.amazonaws.region.iotsitewise.data

    • Si publica datos en Amazon S3 en la us-east-1 región, este componente intentará utilizar el punto de enlace global de S3 de forma predeterminada; sin embargo, este punto de enlace no está disponible a través del punto de enlace de la interfaz de VPC de Amazon S3. Para obtener más información, consulte Restricciones y limitaciones AWS PrivateLink de Amazon S3. Para resolver este problema, puede elegir entre las siguientes opciones.

      • Configure el componente del administrador de transmisiones para que utilice el punto final S3 regional de la us-east-1 región, proporcionando la variable de AWS_S3_US_EAST_1_REGIONAL_ENDPOINT=regional entorno.

      • Cree un punto de enlace de VPC de puerta de enlace de Amazon S3 en lugar de un punto de enlace de VPC de interfaz de Amazon S3. Los puntos de enlace de la puerta de enlace S3 permiten el acceso al punto de enlace global de S3. Para obtener más información, consulte Crear un punto final de puerta de enlace.

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

iotanalytics.region.amazonaws.com

443 No

Necesario si publica datos en. AWS IoT Analytics

kinesis.region.amazonaws.com

443 No

Obligatorio si publicas datos en Firehose.

data.iotsitewise.region.amazonaws.com

443 No

Obligatorio si publica datos en. AWS IoT SiteWise

*.s3.amazonaws.com

443 No

Es obligatorio si publicas datos en buckets de S3.

Puede sustituirlos por * el nombre de cada depósito en el que publique los datos.

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.

2.1.11

La siguiente tabla muestra las dependencias de las versiones 2.1.11 a 2.1.10 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.13.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.1.9 – 2.1.10

La siguiente tabla muestra las dependencias de las versiones 2.1.9 a 2.1.10 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.12.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.1.5 – 2.1.8

La siguiente tabla muestra las dependencias de las versiones 2.1.5 a 2.1.8 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.11.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.1.2 – 2.1.4

La siguiente tabla muestra las dependencias de las versiones 2.1.2 a 2.1.4 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.10.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.1.1

La siguiente tabla muestra las dependencias de la versión 2.1.1 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.9.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.1.0

La siguiente tabla muestra las dependencias de la versión 2.1.0 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.8.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.15

La siguiente tabla muestra las dependencias de la versión 2.0.15 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.7.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.13 and 2.0.14

La siguiente tabla muestra las dependencias de las versiones 2.0.13 y 2.0.14 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.6.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.11 and 2.0.12

La siguiente tabla muestra las dependencias de las versiones 2.0.11 y 2.0.12 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.5.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.10

La siguiente tabla muestra las dependencias de la versión 2.0.10 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.4.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.9

La siguiente tabla muestra las dependencias de la versión 2.0.9 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.3.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.8

La siguiente tabla muestra las dependencias de la versión 2.0.8 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.0 <2.2.0 Flexible
Servicio de intercambio de fichas >=0.0.0 Rígido
2.0.7

La siguiente tabla muestra las dependencias de la versión 2.0.7 de este componente.

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.0.3 <2.1.0 Flexible
Servicio de intercambio de fichas >=0.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 proporciona los siguientes parámetros de configuración que puede personalizar al implementar el componente.

STREAM_MANAGER_STORE_ROOT_DIR

(Opcional) La ruta absoluta del directorio local utilizado para almacenar las transmisiones. Este valor debe comenzar con una barra inclinada (por ejemplo, /data).

Debe especificar una carpeta existente y el usuario del sistema que ejecuta el componente del administrador de transmisiones debe tener permisos para leer y escribir en esta carpeta. Por ejemplo, puede ejecutar los siguientes comandos para crear y configurar una carpeta/var/greengrass/streams, que especifique como carpeta raíz del administrador de flujos. Estos comandos permiten al usuario predeterminado del sistemaggc_user,, leer y escribir en esta carpeta.

sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams

Predeterminado: /greengrass/v2/work/aws.greengrass.StreamManager

STREAM_MANAGER_SERVER_PORT

(Opcional) El número de puerto local que se utilizará para comunicarse con el administrador de transmisiones.

Puede especificar el uso 0 de un puerto disponible de forma aleatoria.

Predeterminado: 8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(Opcional) Puedes hacer que sea obligatorio que los clientes se autentiquen antes de poder interactuar con Stream Manager. El SDK de Stream Manager controla la interacción entre los clientes y el administrador de transmisiones. Este parámetro determina qué clientes pueden llamar al SDK de Stream Manager para trabajar con las transmisiones. Para obtener más información, consulta la autenticación de clientes de Stream Manager.

Si lo especificastrue, el SDK de Stream Manager solo permite como clientes los componentes de Greengrass.

Si lo especificasfalse, el SDK de Stream Manager permite que todos los procesos del dispositivo principal sean clientes.

Predeterminado: true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(Opcional) El ancho de banda máximo promedio (en kilobits por segundo) que Stream Manager puede usar para exportar datos.

Valor predeterminado: sin límite

STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

(Opcional) El número máximo de subprocesos activos que Stream Manager puede usar para exportar datos.

El tamaño óptimo depende del hardware, el volumen de secuencias y la cantidad planificada de secuencias de exportación. Si la velocidad de exportación es lenta, puede ajustar esta configuración para encontrar el tamaño óptimo para su hardware y su caso de negocio. La CPU y la memoria del hardware del dispositivo principal son factores limitantes. Para comenzar, puede intentar establecer este valor igual a la cantidad de núcleos de procesador en el dispositivo.

Tenga cuidado de no establecer un tamaño superior al que admite el hardware. Cada transmisión consume recursos de hardware, así que intente limitar la cantidad de transmisiones de exportación en dispositivos restringidos.

Predeterminado: 5 hilos

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(Opcional) El tamaño mínimo (en bytes) de una parte en una carga multiparte a Amazon S3. El administrador de flujos utiliza esta configuración y el tamaño del archivo de entrada para determinar cómo agrupar los datos en una solicitud PUT de varias partes.

nota

El administrador de transmisiones usa la sizeThresholdForMultipartUploadBytes propiedad streams para determinar si se debe exportar a Amazon S3 como una carga de una o varias partes. AWS IoT Greengrass los componentes pueden establecer este umbral cuando crean una transmisión que exporta a Amazon S3.

Predeterminado: 5242880 (5 MB). También es el valor mínimo.

LOG_LEVEL

(Opcional) El nivel de registro del componente. Elija uno de los siguientes niveles de registro, que se muestran aquí en orden de niveles:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

Predeterminado: INFO

JVM_ARGS

(Opcional) Los argumentos personalizados de la máquina virtual Java para pasarlos al administrador de transmisiones al inicio. Separe los argumentos múltiples mediante espacios.

Utilice este parámetro sólo cuando deba anular la configuración predeterminada utilizada por la JVM. Por ejemplo, puede que necesite aumentar el tamaño predeterminado del montón si planea exportar un gran número de secuencias.

ejemplo Ejemplo: actualización de la combinación de configuraciones

El siguiente ejemplo de configuración especifica el uso de un puerto no predeterminado.

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

Archivo de registro local

Este componente utiliza el siguiente archivo de registro.

Linux
/greengrass/v2/logs/aws.greengrass.StreamManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.StreamManager.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.greengrass.StreamManager.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait

Registros de cambios

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

Versión

Cambios

2.1.12

Mejoras y correcciones de errores

Actualiza el orden en que se utilizan las credenciales, de modo que las credenciales de Greengrass son las preferidas para las solicitudes de AWS servicio.

2.1.11

Versión actualizada para la versión 2.12.0 de Greengrass nucleus.

2.1.10

Mejoras y correcciones de errores

Soluciona un problema por el que la configuración del proxy HTTPS no confiaba en la cadena de certificados de la autoridad de certificación (CA) de Greengrass.

2.1.9

Versión actualizada para la versión 2.11.0 de Greengrass nucleus.

2.1.8

Mejoras y correcciones de errores

Soluciona un problema que provocaba que el administrador de transmisiones volviera a intentar SiteWise exportar de forma infinita. InvalidRequestException

2.1.7

Correcciones de errores y mejoras

Soluciona un problema por el que el administrador de transmisiones no podía leer correctamente la configuración del proxy.

2.1.6

Correcciones de errores y mejoras

Corrige un problema que podía provocar un bloqueo al arrancar algunos procesadores ARMv8, incluido el Jetson Nano.

2.1.5

Versión actualizada para la versión 2.10.0 de Greengrass nucleus.

2.1.4

Mejoras y correcciones de errores
  • Soluciona un problema por el que las entradas del mismo activo inmobiliario con la misma marca de tiempo en un solo lote se devolvían ConflictingOperationException de la SiteWise API, lo que provocaba que el administrador de transmisiones volviera a intentarlo continuamente.

  • Actualiza el tiempo de espera de conexión predeterminado de 3 segundos a 1 minuto.

2.1.3

Correcciones de errores y mejoras

Corrige un problema de inicio en el sistema operativo Windows cuando se ejecuta como usuario del SISTEMA.

2.1.2

Correcciones de errores y mejoras
  • Soluciona un problema en los sistemas operativos Windows que utilizan un idioma distinto del inglés.

  • Versión actualizada para el lanzamiento de la versión 2.9.0 del núcleo de Greengrass.

2.1.1

Versión actualizada para el lanzamiento de la versión 2.8.0 de Greengrass nucleus.

2.1.0

Nuevas características

2.0.15

Versión actualizada para el lanzamiento de la versión 2.6.0 de Greengrass Nucleus.

2.0.14

Esta versión contiene correcciones de errores y mejoras.

2.0.13

Versión actualizada para el lanzamiento de la versión 2.5.0 de Greengrass Nucleus.

2.0.12
Mejoras y correcciones de errores

Corrige un problema que impedía actualizar Stream Manager v2.0.7 a una versión entre la v2.0.8 y la v2.0.11. Si utilizas Stream Manager para exportar datos a la nube, ahora puedes actualizar a la versión 2.0.12.

2.0.11

Versión actualizada para el lanzamiento de la versión 2.4.0 de Greengrass Nucleus.

2.0.10

Versión actualizada para el lanzamiento de la versión 2.3.0 de Greengrass nucleus.

2.0.9

Versión actualizada para el lanzamiento de la versión 2.2.0 de Greengrass nucleus.

2.0.8

Versión actualizada para el lanzamiento de la versión 2.1.0 de Greengrass nucleus.

2.0.7

Versión inicial.