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.
Temas
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 que el componente administrador de transmisiones se ejecute en unVPC. Para implementar este componente en unVPC, se requiere lo siguiente.
-
El componente del administrador de transmisiones debe tener conectividad con el AWS servicio en el que publique 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 VPC interfaz 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, configurándolo-Daws.s3UseUsEast1RegionalEndpoint=regional
enJVM_ARGS
. -
Cree un VPC punto de enlace de puerta de enlace de Amazon S3 en lugar de un VPC punto de enlace 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 |
---|---|---|---|
|
443 | No |
Necesario si publica datos en. AWS IoT Analytics |
|
443 | No |
Obligatorio si publicas datos en Firehose. |
|
443 | No |
Obligatorio si publica datos en. AWS IoT SiteWise |
|
443 | No |
Es obligatorio si publicas datos en buckets de S3. Puede sustituirlos por |
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
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
Valor predeterminado:
/work/aws.greengrass.StreamManager/greengrass/v2
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.Valor 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 administrador de transmisiones SDK controla la interacción entre los clientes y el administrador de transmisiones. Este parámetro determina qué clientes pueden llamar al Stream Manager SDK para trabajar con las transmisiones. Para obtener más información, consulte Autenticación de clientes de Stream Manager.
Si lo especifica
true
, Stream Manager solo SDK permite los componentes de Greengrass como clientes.Si lo especifica
false
, el Stream Manager SDK permite que todos los procesos del dispositivo principal sean clientes.Valor predeterminado:
true
STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH
-
(Opcional) El ancho de banda máximo promedio (en kilobits por segundo) que el administrador de transmisiones 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 memoria CPU y la memoria del hardware principal del dispositivo 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 transmisiones usa esta configuración y el tamaño del archivo de entrada para determinar cómo agrupar los datos en una solicitud de varias partesPUT.
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
Valor predeterminado:
INFO
-
JVM_ARGS
-
(Opcional) Los argumentos personalizados de la máquina virtual Java para pasarlos al administrador de transmisiones al inicio. Separe varios argumentos mediante espacios.
Utilice este parámetro solo cuando deba anular la configuración predeterminada utilizada por elJVM. 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 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.
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
o/greengrass/v2
C:\greengrass\v2
con la ruta a la carpeta AWS IoT Greengrass raíz.
Registros de cambios
En la siguiente tabla se describen los cambios en cada versión del componente.
Versión |
Cambios |
---|---|
2.1.13 |
|
2.1.12 |
|
2.1.11 |
Versión actualizada para la versión 2.12.0 de Greengrass Nucleus. |
2.1.10 |
|
2.1.9 |
Versión actualizada para el lanzamiento de la versión 2.11.0 de Greengrass nucleus. |
2.1.8 |
|
2.1.7 |
|
2.1.6 |
|
2.1.5 |
Versión actualizada para el lanzamiento de la versión 2.10.0 de Greengrass nucleus. |
2.1.4 |
|
2.1.3 |
|
2.1.2 |
|
2.1.1 |
Versión actualizada para la versión 2.8.0 de Greengrass nucleus. |
2.1.0 |
|
2.0.15 |
Versión actualizada para 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 la versión 2.5.0 de Greengrass nucleus. |
2.0.12 |
|
2.0.11 |
Versión actualizada para la versión 2.4.0 de Greengrass nucleus. |
2.0.10 |
Versión actualizada para 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. |