Emisor de telemetría Nucleus - 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.

Emisor de telemetría Nucleus

El componente emisor de telemetría central (aws.greengrass.telemetry.NucleusEmitter) recopila datos de telemetría de salud del sistema y los publica continuamente sobre un tema y un tema locales. AWS IoT Core MQTT Este componente le permite recopilar la telemetría del sistema en tiempo real en sus dispositivos principales de Greengrass. Para obtener información sobre el agente de telemetría de Greengrass que publica los datos de telemetría del sistema en Amazon, consulte. EventBridge Recopile datos de telemetría del estado del sistema de los dispositivos principales AWS IoT Greengrass

De forma predeterminada, el componente emisor de telemetría Nucleus publica los datos de telemetría cada 60 segundos en el siguiente tema local de publicación o suscripción.

$local/greengrass/telemetry

De forma predeterminada, el componente emisor de telemetría nuclear no publica en ningún tema. AWS IoT Core MQTT Puede configurar este componente para que se publique en un AWS IoT Core MQTT tema al implementarlo. El uso de un MQTT tema para publicar datos en el Nube de AWS está sujeto a AWS IoT Core los precios.

AWS IoT Greengrass proporciona varios componentes comunitarios para ayudarlo a analizar y visualizar los datos de telemetría localmente en su dispositivo principal mediante InfluxDB y Grafana. Estos componentes utilizan datos de telemetría del componente nucleo-emisor. Para obtener más información, consulte el componente del editor README InfluxDB.

Versiones

Este componente tiene las siguientes versiones:

  • 1.0.x

Tipo

Este componente es un componente de complemento (aws.greengrass.plugin). El núcleo de Greengrass ejecuta este componente en la misma máquina virtual Java (JVM) que el núcleo. El núcleo se reinicia al cambiar la versión de este componente en el dispositivo principal.

Este componente utiliza el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte Supervisar AWS IoT Greengrass registros.

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

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.

1.0.9

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.14.0 Rígido
1.0.8

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.13.0 Rígido
1.0.7

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.12.0 Rígido
1.0.6

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.11.0 Rígido
1.0.5

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.10.0 Rígido
1.0.4

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.9.0 Rígido
1.0.3

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.8.0 Rígido
1.0.2

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.7.0 Rígido
1.0.1

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.6.0 Rígido
1.0.0

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

Dependencia Versiones compatibles Tipo de dependencia
Núcleo de Greengrass >=2.4.0 <2.5.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.

pubSubPublish

(Opcional) Define si se deben publicar los datos de telemetría en el $local/greengrass/telemetry tema. Los valores admitidos son true y false.

Valor predeterminado: true

mqttTopic

(Opcional) El AWS IoT Core MQTT tema en el que este componente publica los datos de telemetría.

Establezca este valor en el AWS IoT Core MQTT tema en el que desee publicar los datos de telemetría. Cuando este valor está vacío, el núcleo emisor no publica los datos de telemetría en el. Nube de AWS

Valor predeterminado: ""

telemetryPublishIntervalMs

(Opcional) El tiempo (en milisegundos) entre el que el componente publica los datos de telemetría. Si establece este valor por debajo del valor mínimo admitido, el componente utilizará el valor mínimo en su lugar.

nota

Los intervalos de publicación más bajos dan como resultado un mayor CPU uso en el dispositivo principal. Te recomendamos empezar con el intervalo de publicación predeterminado y ajustarlo en función del CPU uso del dispositivo.

Mínimo: 500

Valor predeterminado: 60000

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

El siguiente ejemplo muestra un ejemplo de actualización de combinación de configuraciones que permite publicar datos de telemetría cada 5 segundos en el $local/greengrass/telemetry tema y en el tema. greengrass/myTelemetry AWS IoT Core MQTT

{ "pubSubPublish": "true", "mqttTopic": "greengrass/myTelemetry", "telemetryPublishIntervalMs": 5000 }

Datos de salida

Este componente publica las métricas de telemetría como una JSON matriz sobre el tema siguiente.

Tema local: $local/greengrass/telemetry

Si lo desea, puede optar por publicar también las métricas de telemetría en un AWS IoT Core MQTT tema. Para obtener más información sobre los temas, consulte los MQTTtemas de la Guía AWS IoT Core para desarrolladores.

ejemplo Datos de ejemplo
[ { "A": "Average", "N": "CpuUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Percent", "V": 26.21981271562346 }, { "A": "Count", "N": "TotalNumberOfFDs", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Count", "V": 7316 }, { "A": "Count", "N": "SystemMemUsage", "NS": "SystemMetrics", "TS": 1627597331445, "U": "Megabytes", "V": 10098 }, { "A": "Count", "N": "NumberOfComponentsStarting", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsInstalled", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStateless", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsStopping", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsBroken", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsRunning", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 7 }, { "A": "Count", "N": "NumberOfComponentsErrored", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsNew", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 0 }, { "A": "Count", "N": "NumberOfComponentsFinished", "NS": "GreengrassComponents", "TS": 1627597331446, "U": "Count", "V": 2 } ]

La matriz de salida contiene una lista de métricas que tienen las siguientes propiedades:

A

El tipo de agregación de la métrica.

Para la CpuUsage métrica, esta propiedad se establece en Average porque el valor publicado de la métrica es la cantidad de CPU uso promedio desde el último evento de publicación.

Para todas las demás métricas, el núcleo emisor no agrega el valor de la métrica y esta propiedad se establece en. Count

N

El nombre de la métrica.

NS

El espacio de nombres de la métrica.

TS

La marca de tiempo del momento en que se recopilaron los datos.

U

La unidad del valor métrico.

V

El valor de la métrica de .

El emisor del núcleo publica las siguientes métricas:

Nombre Descripción

System (Sistema)

SystemMemUsage

La cantidad de memoria que utilizan actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo.

CpuUsage

La cantidad que utilizan CPU actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo.

TotalNumberOfFDs

El número de descriptores de archivos almacenados por el sistema operativo del dispositivo principal de Greengrass. Un descriptor de archivo identifica exclusivamente un archivo abierto.

Núcleo de Greengrass

NumberOfComponentsRunning

El número de componentes que se ejecutan en el dispositivo principal de Greengrass.

NumberOfComponentsErrored

El número de componentes que están en estado de error en el dispositivo principal de Greengrass.

NumberOfComponentsInstalled

El número de componentes que están instalados en el dispositivo principal de Greengrass.

NumberOfComponentsStarting

El número de componentes que se inician en el dispositivo principal de Greengrass.

NumberOfComponentsNew

La cantidad de componentes que son nuevos en el dispositivo principal de Greengrass.

NumberOfComponentsStopping

El número de componentes que se detienen en el dispositivo principal de Greengrass.

NumberOfComponentsFinished

El número de componentes que están acabados en el dispositivo principal de Greengrass.

NumberOfComponentsBroken

La cantidad de componentes que están rotos en el dispositivo principal de Greengrass.

NumberOfComponentsStateless

El número de componentes que no tienen estado en el dispositivo principal de Greengrass.

Uso

Para utilizar los datos de telemetría del estado del sistema, puede crear componentes personalizados que se adapten a los temas en los que el núcleo emisor publica los datos de telemetría y que reaccionen a esos datos según sea necesario. Como el componente núcleo emisor ofrece la opción de publicar datos de telemetría en un tema local, puede suscribirse a ese tema y utilizar los datos publicados para actuar de forma local en su dispositivo principal. De este modo, el dispositivo principal puede reaccionar a los datos de telemetría incluso cuando su conectividad a la nube sea limitada.

Por ejemplo, puede configurar un componente que escuche el $local/greengrass/telemetry tema en busca de datos de telemetría y envíe los datos al componente del administrador de transmisiones para transmitir sus datos al. Nube de AWS Para obtener más información sobre cómo crear un componente de este tipo, consulte y. Publicar/suscribir mensajes locales Cree componentes personalizados que usen el administrador de transmisiones

Archivo de registro local

Este componente utiliza el mismo archivo de registro que el componente núcleo de Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.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 con la ruta a la carpeta AWS IoT Greengrass raíz.

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

Registros de cambios

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

Versión

Cambios

1.0.9

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

1.0.8

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

1.0.7

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

1.0.6

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

1.0.5

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

1.0.4

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

1.0.3

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

1.0.2

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

1.0.1

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

1.0.0

Versión inicial.