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 del núcleo
<a name="nucleus-emitter-component"></a>

El componente emisor de telemetría nuclear (`aws.greengrass.telemetry.NucleusEmitter`) recopila datos de telemetría de salud del sistema y los publica continuamente sobre un tema local y otro sobre el MQTT. AWS IoT Core 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](telemetry.md)

De forma predeterminada, el componente emisor de telemetría del núcleo publica los datos de telemetría cada 60 segundos en el siguiente tema local. publish/subscribe 

```
$local/greengrass/telemetry
```

De forma predeterminada, el componente emisor de telemetría nuclear no se publica en ningún tema de MQTT. AWS IoT Core Puede configurar este componente para que se publique en un tema de AWS IoT Core MQTT al implementarlo. [El uso de un tema de MQTT para publicar datos en el Nube de AWS está sujeto a AWS IoT Core los precios.](https://aws.amazon.com/iot-core/pricing/)

<a name="greengrass-software-catalog-influxdb-telemetry-publisher"></a>AWS IoT Greengrass proporciona varios [componentes comunitarios](greengrass-software-catalog.md) 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 emisor de núcleo. Para obtener más información, consulte el archivo README para el [componente publicador de InfluxDB](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher).

**Topics**
+ [Versiones](#nucleus-emitter-component-versions)
+ [Tipo](#nucleus-emitter-component-type)
+ [Sistema operativo](#nucleus-emitter-component-os-support)
+ [Dependencias](#nucleus-emitter-component-dependencies)
+ [Configuración](#nucleus-emitter-component-configuration)
+ [Datos de salida](#nucleus-emitter-component-output-data)
+ [De uso](#nucleus-emitter-component-usage)
+ [Archivo de registro local](#nucleus-emitter-component-log-file)
+ [Registros de cambios](#nucleus-emitter-component-changelog)

## Versiones
<a name="nucleus-emitter-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 1.0.x

## Tipo
<a name="nucleus-emitter-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Este componente es un componente de complemento (`aws.greengrass.plugin`). El [núcleo de Greengrass](greengrass-nucleus-component.md) 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.

<a name="public-component-type-plugin-para2"></a>Este componente usa el mismo archivo de registro que el núcleo de Greengrass. Para obtener más información, consulte [Supervisión de los registros de AWS IoT Greengrass](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="nucleus-emitter-component-os-support"></a>

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

## Dependencias
<a name="nucleus-emitter-component-dependencies"></a>

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 implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#nucleus-emitter-component-changelog) 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 de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

------
#### [ 1.0.12 ]

En la siguiente tabla se enumeran las dependencias de la versión 1.0.12 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) | >=2.4.0 <2.17.0 | Flexible | 

------
#### [ 1.0.11 ]

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


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.16.0  | Rígido | 

------
#### [ 1.0.10 ]

LEn la siguiente tabla, se muestran las dependencias de la versión 1.0.10 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 =2.4.0 <2.15.0  | Rígido | 

------
#### [ 1.0.9 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.9 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.14.0  | Rígido | 

------
#### [ 1.0.8 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.8 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.13.0  | Rígido | 

------
#### [ 1.0.7 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.7 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.12.0  | Rígido | 

------
#### [ 1.0.6 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.6 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.11.0  | Rígido | 

------
#### [ 1.0.5 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.5 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.10.0  | Rígido | 

------
#### [ 1.0.4 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.4 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.9.0  | Rígido | 

------
#### [ 1.0.3 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.3 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.8.0  | Rígido | 

------
#### [ 1.0.2 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.2 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.7.0  | Rígido | 

------
#### [ 1.0.1 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.1 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.6.0  | Rígido | 

------
#### [ 1.0.0 ]

En la siguiente tabla, se muestran las dependencias de la versión 1.0.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Núcleo de Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.5.0  | Rígido | 

------

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="nucleus-emitter-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

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

`mqttTopic`  
(Opcional) El tema de AWS IoT Core MQTT en el que este componente publica datos de telemetría.  
Establezca este valor en el tema AWS IoT Core MQTT en el que desee publicar los datos de telemetría. Cuando este valor está vacío, el emisor del núcleo no publica los datos de telemetría en la Nube de AWS.   
[El uso de un tema de MQTT para publicar datos en el Nube de AWS está sujeto a los precios.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/)
Valor predeterminado: `""`

`telemetryPublishIntervalMs`  
(Opcional) Cantidad de tiempo (en milisegundos) 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.  
Los intervalos de publicación más bajos dan como resultado un mayor uso de la CPU en el dispositivo principal. Le recomendamos empezar con el intervalo de publicación predeterminado y ajustarlo en función del uso de la CPU del dispositivo.
Mínimo: `500`  
Valor predeterminado: `60000`

**Example Ejemplo: actualización de la 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 MQTT. `greengrass/myTelemetry` AWS IoT Core   

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

## Datos de salida
<a name="nucleus-emitter-component-output-data"></a>

Este componente publica las métricas de telemetría como una matriz JSON en 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 tema de MQTT. AWS IoT Core Para obtener más información, consulte [Temas de MQTT](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) en la *Guía para desarrolladores de AWS IoT Core *.

**Example 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
  }
]
```<a name="telemetry-json-array-config"></a>

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

`A`  
El tipo de agregación de las métricas.   
Para la métrica `CpuUsage`, esta propiedad se establece en `Average` porque el valor publicado de la métrica es la cantidad media de uso de la CPU desde el último evento de publicación.  
Para el resto de las métricas, el emisor del núcleo no agrega el valor de la métrica y esta propiedad se establece en `Count`.

`N`  
El nombre de la métrica.

`NS`  
Espacio de nombres de la métrica.

`TS`  
Marca temporal 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:


| Name | Description (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 de CPU que utilizan 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 instalados en el dispositivo principal de Greengrass.  | 
|  `NumberOfComponentsStarting`  |  El número de componentes que se inician en el dispositivo principal de Greengrass.  | 
|  `NumberOfComponentsNew`  |  El número de componentes 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 terminados en el dispositivo principal de Greengrass.  | 
|  `NumberOfComponentsBroken`  |  El número de componentes dañados en el dispositivo principal de Greengrass.  | 
|  `NumberOfComponentsStateless`  |  El número de componentes sin estado en el dispositivo principal de Greengrass.  | 

## De uso
<a name="nucleus-emitter-component-usage"></a>

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 emisor del núcleo publica los datos de telemetría y que reaccionen a esos datos según sea necesario. Como el componente emisor del núcleo 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 tema `$local/greengrass/telemetry` en busca de datos de telemetría y envíe los datos al componente del administrador de flujos para transmitir sus datos a la Nube de AWS. Para obtener más información sobre cómo crear este componente, consulte [Publicar/suscribir mensajes locales](ipc-publish-subscribe.md) y [Creación de componentes personalizados que usen el administrador de flujos](use-stream-manager-in-custom-components.md).

## Archivo de registro local
<a name="nucleus-emitter-component-log-file"></a>

Este componente utiliza el mismo archivo de registro que el componente [núcleo de Greengrass](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

------
#### [ Windows ]

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. Sustituya `/greengrass/v2` o *C:\$1greengrass\$1v2* por la ruta a la AWS IoT Greengrass carpeta 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
<a name="nucleus-emitter-component-changelog"></a>

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


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  1.0.13  |  Actualiza la versión del componente para la versión 2.17.0 del núcleo de Greengrass.  | 
|  1.0.12  |  Versión actualizada para la versión 2.16.0 de Greengrass nucleus.  | 
|  1.0.11  | Versión actualizada para la versión 2.15.0 de Greengrass nucleus. | 
|  1.0.10  | Versión actualizada para la versión 2.14.0 de Greengrass nucleus. | 
|  1.0.9  | Versión actualizada para el lanzamiento de la versión 2.13.0 del núcleo de Greengrass. | 
|  1.0.8  | Versión actualizada para el lanzamiento de la versión 2.12.0 del núcleo de Greengrass. | 
|  1.0.7  | Versión actualizada para el lanzamiento de la versión 2.11.0 del núcleo de Greengrass. | 
|  1.0.6  | Versión actualizada para el lanzamiento de la versión 2.10.0 del núcleo de Greengrass. | 
|  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 del núcleo de Greengrass.  | 
|  1.0.2  |  Versión actualizada para el lanzamiento de la versión 2.6.0 del núcleo de Greengrass.  | 
|  1.0.1  |  Versión actualizada para el lanzamiento de la versión 2.5.0 del núcleo de Greengrass.  | 
|  1.0.0  |  Versión inicial.  |