Emissor de telemetria Nucleus - AWS IoT Greengrass

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 Nucleus

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. AWS IoT Core MQTT 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

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

$local/greengrass/telemetry

O componente emissor de telemetria nucleus não publica em um AWS IoT Core MQTT tópico por padrão. Você pode configurar esse componente para publicar em um AWS IoT Core MQTT tópico ao implantá-lo. O uso de um MQTT tópico para publicar dados no Nuvem AWS está sujeito a AWS IoT Core preços.

AWS IoT Greengrass fornece vários componentes da comunidade para ajudá-lo a analisar e visualizar dados de telemetria localmente em seu dispositivo principal usando o InfluxDB e o Grafana. Esses componentes usam dados de telemetria do componente emissor do núcleo. Para obter mais informações, consulte o componente README editor do InfluxDB.

Versões

Esse componente tem as seguintes versões:

  • 1,0.x

Tipo

Este componente é um componente de plug-in (aws.greengrass.plugin). O núcleo do Greengrass executa esse componente na mesma Java Virtual Machine (JVM) do núcleo. O núcleo reinicia quando você altera a versão desse componente no dispositivo principal.

Esse componente usa o mesmo arquivo de log do núcleo do Greengrass. Para obter mais informações, consulte Monitore AWS IoT Greengrass os registros.

Para obter mais informações, consulte Tipos de componentes.

Sistema operacional

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

  • Linux

  • Windows

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões do componente para cada dependência. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. Na página de detalhes do componente, procure a lista de dependências.

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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=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 Greengrass >=2.4.0 <2.5.0 Rígido

Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.

pubSubPublish

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

Padrão: true

mqttTopic

(Opcional) O AWS IoT Core MQTT tópico no qual esse componente publica dados de telemetria.

Defina esse valor para o AWS IoT Core MQTT tópico 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

nota

O uso de um MQTT tópico para publicar dados no Nuvem AWS está sujeito a AWS IoT Core preços.

Padrão: ""

telemetryPublishIntervalMs

(Opcional) A quantidade de tempo (em milissegundos) entre a 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.

nota

Intervalos de publicação mais baixos resultam em maior CPU uso em seu dispositivo principal. Recomendamos que você comece com o intervalo de publicação padrão e o ajuste com base no CPU uso do seu dispositivo.

Mínimo: 500

Padrão: 60000

exemplo Exemplo: atualização da mesclagem de configurações

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 tópico. greengrass/myTelemetry AWS IoT Core MQTT

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

Dados de saída

Esse componente publica métricas de telemetria como uma JSON matriz 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 tópico. AWS IoT Core MQTT Para obter mais informações sobre tópicos, consulte MQTTos tópicos no Guia do AWS IoT Core desenvolvedor.

exemplo 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 matriz de saída contém uma lista de métricas que têm as seguintes propriedades:

A

O tipo de agregação da métrica.

Para a CpuUsage métrica, essa propriedade é definida como Average porque o valor publicado da métrica é o valor médio de CPU uso 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 métrico.

TS

A data e hora de quando os dados foram coletados.

U

A unidade do valor da métrica.

V

O valor da métrica do .

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

Nome Descrição

Sistema

SystemMemUsage

A quantidade de memória atualmente em uso por todos os aplicativos no dispositivo de núcleo do Greengrass, incluindo o sistema operacional.

CpuUsage

A quantidade CPU atualmente em uso por todos os aplicativos no dispositivo principal do Greengrass, incluindo o sistema operacional.

TotalNumberOfFDs

O número de descritores de arquivo armazenados pelo sistema operacional do dispositivo de núcleo do Greengrass. Um descritor de arquivo identifica exclusivamente um arquivo aberto.

Núcleo Greengrass

NumberOfComponentsRunning

O número de componentes que estão sendo executados 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 começando 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 finalizados 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.

Uso

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 stream para transmitir seus dados para o. Nuvem AWS Para obter mais informações sobre a criação desse componente, consulte Publique/assine mensagens locais Crie componentes personalizados que usam o gerenciador de fluxo e.

Arquivo de log local

Esse componente usa o mesmo arquivo de log do componente do núcleo do Greengrass.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver os registros desse componente
  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substituir /greengrass/v2 ou C:\greengrass\v2 com o 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 tabela a seguir descreve as alterações em cada versão do componente.

Version (Versão)

Alterações

1.0.9

Versão atualizada para a versão 2.13.0 do Greengrass nucleus.

1.0.8

Versão atualizada para a versão 2.12.0 do Greengrass nucleus.

1.0.7

Versão atualizada para a versão 2.11.0 do Greengrass nucleus.

1.0.6

Versão atualizada para a versão 2.10.0 do Greengrass nucleus.

1.0.5

Versão atualizada para a versão 2.9.0 do Greengrass nucleus.

1.0.4

Versão atualizada para a versão 2.8.0 do Greengrass nucleus.

1.0.3

Versão atualizada para a versão 2.7.0 do Greengrass nucleus.

1.0.2

Versão atualizada para a versão 2.6.0 do Greengrass nucleus.

1.0.1

Versão atualizada para a versão 2.5.0 do Greengrass nucleus.

1.0.0

Versão inicial.