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
Temas
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
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 sontrue
yfalse
.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
nota
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 enAverage
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) |
|
|
La cantidad de memoria que utilizan actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo. |
|
La cantidad que utilizan CPU actualmente todas las aplicaciones del dispositivo principal de Greengrass, incluido el sistema operativo. |
|
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 |
|
|
El número de componentes que se ejecutan en el dispositivo principal de Greengrass. |
|
El número de componentes que están en estado de error en el dispositivo principal de Greengrass. |
|
El número de componentes que están instalados en el dispositivo principal de Greengrass. |
|
El número de componentes que se inician en el dispositivo principal de Greengrass. |
|
La cantidad de componentes que son nuevos en el dispositivo principal de Greengrass. |
|
El número de componentes que se detienen en el dispositivo principal de Greengrass. |
|
El número de componentes que están acabados en el dispositivo principal de Greengrass. |
|
La cantidad de componentes que están rotos en el dispositivo principal de Greengrass. |
|
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.
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 |
---|---|
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. |