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
Tópicos
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
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ãotrue
efalse
.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 comoAverage
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 |
|
|
A quantidade de memória atualmente em uso por todos os aplicativos no dispositivo de núcleo do Greengrass, incluindo o sistema operacional. |
|
A quantidade CPU atualmente em uso por todos os aplicativos no dispositivo principal do Greengrass, incluindo o sistema operacional. |
|
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 |
|
|
O número de componentes que estão sendo executados no dispositivo principal do Greengrass. |
|
O número de componentes que estão em estado de erro no dispositivo principal do Greengrass. |
|
O número de componentes que estão instalados no dispositivo principal do Greengrass. |
|
O número de componentes que estão começando no dispositivo principal do Greengrass. |
|
O número de componentes que são novos no dispositivo principal do Greengrass. |
|
O número de componentes que estão parando no dispositivo principal do Greengrass. |
|
O número de componentes finalizados no dispositivo principal do Greengrass. |
|
O número de componentes que estão quebrados no dispositivo principal do Greengrass. |
|
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.
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
ou/greengrass/v2
C:\greengrass\v2
com o caminho para a pasta AWS IoT Greengrass raiz.
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. |