As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Emissor de telemetria de núcleo
<a name="nucleus-emitter-component"></a>

O componente emissor de telemetria do núcleo (`aws.greengrass.telemetry.NucleusEmitter`) reúne dados de telemetria de integridade do sistema e os publica continuamente em um tópico local e em um tópico do MQTT. AWS IoT Core Esse componente permite que você reúna a telemetria do sistema em tempo real em seus dispositivos principais do Greengrass. Para obter informações sobre o agente de telemetria do Greengrass que publica dados de telemetria do sistema na Amazon, consulte. EventBridge [Colete dados de telemetria de integridade do sistema a partir dos dispositivos principais AWS IoT Greengrass](telemetry.md)

Por padrão, o componente emissor de telemetria nucleus publica dados de telemetria a cada 60 segundos no seguinte tópico local. publish/subscribe 

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

O componente emissor de telemetria nucleus não é publicado em um tópico do AWS IoT Core MQTT por padrão. Você pode configurar esse componente para publicar em um tópico do AWS IoT Core MQTT ao implantá-lo. O uso de um tópico do MQTT para publicar dados no Nuvem AWS está sujeito a [AWS IoT Core preços](https://aws.amazon.com/iot-core/pricing/).

<a name="greengrass-software-catalog-influxdb-telemetry-publisher"></a>AWS IoT Greengrass fornece vários [componentes da comunidade](greengrass-software-catalog.md) para ajudá-lo a analisar e visualizar dados de telemetria localmente em seu dispositivo principal usando o InfluxDB e o Grafana. Esses componentes usam os dados de telemetria do componente emissor do núcleo. Para obter mais informações, consulte o README do componente do [publicador do InfluxDB](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher).

**Topics**
+ [Versões](#nucleus-emitter-component-versions)
+ [Tipo](#nucleus-emitter-component-type)
+ [Sistema operacional](#nucleus-emitter-component-os-support)
+ [Dependências](#nucleus-emitter-component-dependencies)
+ [Configuração](#nucleus-emitter-component-configuration)
+ [Dados de saída](#nucleus-emitter-component-output-data)
+ [Usage](#nucleus-emitter-component-usage)
+ [Arquivo de log local](#nucleus-emitter-component-log-file)
+ [Changelog](#nucleus-emitter-component-changelog)

## Versões
<a name="nucleus-emitter-component-versions"></a>

Esse componente tem as seguintes versões:
+ 1.0.x

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

<a name="public-component-type-plugin-para1"></a>Este componente é um componente de plug-in (`aws.greengrass.plugin`). O [Greengrass nucleus](greengrass-nucleus-component.md) executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo é reiniciado quando você altera a versão desse componente no dispositivo principal.

<a name="public-component-type-plugin-para2"></a>Esse componente usa o mesmo arquivo de log do Greengrass nucleus. Para obter mais informações, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md).

<a name="public-component-type-more-information"></a>Para obter mais informações, consulte [Tipos de componente](develop-greengrass-components.md#component-types).

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

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:
+ Linux
+ Windows

## Dependências
<a name="nucleus-emitter-component-dependencies"></a>

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das [versões lançadas](#nucleus-emitter-component-changelog) desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no [console do AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). Na página de detalhes do componente, procure a lista de **dependências**.

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

A tabela a seguir lista as dependências da versão 1.0.12 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.4.0 <2.17,0 | Flexível | 

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

A tabela a seguir lista as dependências da versão 1.0.11 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) |  >=2.4.0 <2.16,0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.10 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) |  >=2.4.0 <2.15.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.9 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.14.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.8 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.13.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.7 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.12.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.6 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.11.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.5 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.10.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.4 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.9.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.8.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.2 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.7.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.1 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >= 2.4.0 <2.6.0  | Rígido | 

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

A tabela a seguir lista as dependências da versão 1.0.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Núcleo do Greengrass](greengrass-nucleus-component.md) |  >=2.4.0 <2.5.0  | Rígido | 

------

Para obter mais informações sobre as dependências dos componentes, consulte [referência de fórmula do componente](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuração
<a name="nucleus-emitter-component-configuration"></a>

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

`pubSubPublish`  
(Opcional) Define se os dados de telemetria devem ser publicados no tópico `$local/greengrass/telemetry`. Os valores compatíveis são `true` e `false`.  
Padrão: `true`

`mqttTopic`  
(Opcional) O tópico do AWS IoT Core MQTT no qual esse componente publica dados de telemetria.  
Defina esse valor para o tópico do AWS IoT Core MQTT no qual você deseja publicar dados de telemetria. Quando esse valor está vazio, o emissor do núcleo não publica dados de telemetria no Nuvem AWS.   
O uso de um tópico do MQTT para publicar dados no Nuvem AWS está sujeito a [AWS IoT Core preços](https://aws.amazon.com/iot-core/pricing/).
Padrão: `""`

`telemetryPublishIntervalMs`  
(Opcional) A quantidade de tempo (em milissegundos) entre o qual o componente publica dados de telemetria. Se você definir esse valor abaixo do valor mínimo suportado, o componente usará o valor mínimo em vez disso.  
Intervalos de publicação mais baixos resultam em maior uso da CPU em seu dispositivo principal. Recomendamos que você comece com o intervalo de publicação padrão e o ajuste com base no uso da CPU do seu dispositivo.
Mínimo: `500`  
Padrão: `60000`

**Example Exemplo: atualização da mesclagem de configuração**  
O exemplo a seguir mostra um exemplo de atualização de mesclagem de configurações que permite publicar dados de telemetria a cada 5 segundos no `$local/greengrass/telemetry` tópico e no `greengrass/myTelemetry` AWS IoT Core tópico MQTT.  

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

## Dados de saída
<a name="nucleus-emitter-component-output-data"></a>

Esse componente publica métricas de telemetria como uma matriz JSON no tópico a seguir. 

**Tópico local:** `$local/greengrass/telemetry`

Opcionalmente, você também pode optar por publicar métricas de telemetria em um AWS IoT Core tópico do MQTT. Para obter mais informações sobre tópicos, consulte [MQTT topics](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) no *Guia do desenvolvedor do AWS IoT Core *.

**Example Exemplo de dados**  

```
[
  {
    "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>

A matriz de saída contém uma lista de métricas que têm as seguintes propriedades:

`A`  
O tipo de agregação para a métrica.   
Para a métrica `CpuUsage`, essa propriedade é definida como `Average` porque o valor publicado da métrica é o valor médio de uso da CPU desde o último evento de publicação.  
Para todas as outras métricas, o emissor do núcleo não agrega o valor da métrica e essa propriedade é definida como `Count`.

`N`  
O nome da métrica.

`NS`  
O namespace de métrica.

`TS`  
O carimbo de data/hora de quando os dados foram coletados.

`U`  
A unidade do valor da métrica.

`V`  
O valor da métrica do . 

O emissor de núcleo publica as seguintes métricas:


| Name (Nome) | Description | 
| --- | --- | 
|  **Sistema**  | 
|  `SystemMemUsage`  |  A quantidade de memória atualmente em uso por todas as aplicações no dispositivo principal do Greengrass, incluindo o sistema operacional.  | 
|  `CpuUsage`  |  A quantidade de CPU atualmente em uso por todas as aplicações no dispositivo principal do Greengrass, incluindo o sistema operacional.  | 
|  `TotalNumberOfFDs`  |  O número de descritores de arquivo armazenados pelo sistema operacional do dispositivo de Greengrass nucleus. Um descritor de arquivo identifica exclusivamente um arquivo aberto.  | 
|  **Greengrass nucleus**  | 
|  `NumberOfComponentsRunning`  |  O número de componentes em execução no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsErrored`  |  O número de componentes que estão em estado de erro no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsInstalled`  |  O número de componentes que estão instalados no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsStarting`  |  O número de componentes que estão iniciando no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsNew`  |  O número de componentes que são novos no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsStopping`  |  O número de componentes que estão parando no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsFinished`  |  O número de componentes que são concluídos no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsBroken`  |  O número de componentes que estão quebrados no dispositivo principal do Greengrass.  | 
|  `NumberOfComponentsStateless`  |  O número de componentes sem estado no dispositivo principal do Greengrass.  | 

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

Para usar os dados de telemetria de integridade do sistema, você pode criar componentes personalizados que se inscrevem nos tópicos nos quais o emissor de núcleo publica os dados de telemetria e reagem a esses dados conforme necessário. Como o componente emissor de núcleo oferece a opção de publicar dados de telemetria em um tópico local, você pode se inscrever nesse tópico e usar os dados publicados para agir localmente em seu dispositivo principal. O dispositivo principal pode então reagir aos dados de telemetria mesmo quando tem conectividade limitada com a nuvem.

Por exemplo, você pode configurar um componente que escuta dados de telemetria no `$local/greengrass/telemetry` tópico e enviar os dados para o componente gerenciador de fluxos para transmitir seus dados para o. Nuvem AWS Para obter mais informações sobre a criação de um componente, consulte [Publicar/assinar mensagens locais](ipc-publish-subscribe.md) e [Criar componentes personalizados que usam o Gerenciador de fluxos](use-stream-manager-in-custom-components.md).

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

Esse componente usa o mesmo arquivo de log do componente de [Greengrass nucleus](greengrass-nucleus-component.md).

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

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

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

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

------

**Para ver os logs desse componente**
+ Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua `/greengrass/v2` ou *C:\$1greengrass\$1v2* pelo caminho para a pasta AWS IoT Greengrass raiz.

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

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="nucleus-emitter-component-changelog"></a>

A tabela a seguir descreve as alterações em cada versão do componente.


|  **Versão**  |  **Alterações**  | 
| --- | --- | 
|  1.0.13  |  Atualiza a versão do componente para a versão 2.17.0 do núcleo Greengrass.  | 
|  1.0.12  |  Versão atualizada para a versão 2.16.0 do Greengrass nucleus.  | 
|  1.0.11  | Versão atualizada para o Greengrass nucleus versão 2.15.0. | 
|  1.0.10  | Versão atualizada para o Greengrass nucleus versão 2.14.0. | 
|  1.0.9  | Versão atualizada para o lançamento da versão 2.13.0 do núcleo do Greengrass. | 
|  1.0.8  | Versão atualizada para o núcleo do Greengrass 2.12.0. | 
|  1.0.7  | Versão atualizada para o lançamento da versão 2.11.0 do núcleo do Greengrass. | 
|  1.0.6  | Versão atualizada para o lançamento da versão 2.10.0 do núcleo do Greengrass. | 
|  1.0.5  | Versão atualizada para o núcleo do Greengrass 2.9.0. | 
|  1.0.4  | Versão atualizada para o lançamento da versão 2.8.0 do núcleo do Greengrass. | 
|  1.0.3  |  Versão atualizada para o lançamento da versão 2.7.0 do núcleo do Greengrass.  | 
|  1.0.2  |  Versão atualizada para o lançamento da versão 2.6.0 do núcleo do Greengrass.  | 
|  1.0.1  |  Versão atualizada para o lançamento da versão 2.5.0 do núcleo do Greengrass.  | 
|  1.0.0  |  Versão inicial.  |