Nucleus 遥测发射器

nucleus 遥测发射器组件 (aws.greengrass.telemetry.NucleusEmitter) 收集系统健康遥测数据，并将其持续发布到本地主题和主题。 Amazon IoT Core MQTT此组件使您能够在 Greengrass 核心设备上收集实时系统遥测数据。有关向亚马逊发布系统遥测数据的 Greengrass 遥测代理的信息，请参阅。 EventBridge 从 Amazon IoT Greengrass 核心设备收集系统运行状况遥测数据

默认情况下，Nucleus 遥测发射器组件每 60 秒将遥测数据发布到以下本地发布/订阅主题。


$local/greengrass/telemetry

默认情况下，nucleus 遥测发射器组件不会发布到 Amazon IoT Core MQTT主题中。您可以将此组件配置为在部署时将其发布到 Amazon IoT Core MQTT主题。使用MQTT主题向发布数据需视Amazon IoT Core 定价而定。 Amazon Web Services 云

Amazon IoT Greengrass 提供了多个社区组件，可帮助您使用 InfluxDB 和 Grafana 在核心设备上本地分析和可视化遥测数据。这些组件使用来自 Nucleus 发射器组件的遥测数据。有关更多信息，请参阅 InfluxDB 发布者组件的。README

版本

此组件具有以下版本：

1.0.x

Type

此组件是一个插件组件 (aws.greengrass.plugin)。Greengrass 核心在与核心相同的 Java 虚拟机 () 中运行此组件。JVM当您在核心设备上更改此组件的版本时，Nucleus 会重新启动。

此组件使用与 Greengrass Nucleus 相同的日志文件。有关更多信息，请参阅监控 Amazon IoT Greengrass 日志。

有关更多信息，请参阅组件类型。

操作系统

此组件可以安装在运行以下操作系统的核心设备上：

Linux
Windows

依赖项

部署组件时， Amazon IoT Greengrass 还会部署其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求，才能成功部署组件。本部分列出了此组件的已发布版本的依赖关系，以及定义每个依赖关系的组件版本的语义版本约束。您还可以在 Amazon IoT Greengrass 控制台中查看每个组件版本的依赖关系。在组件详细信息页面上，查找依赖关系列表。

1.0.10

下表列出了此组件版本 1.0.10 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.15.0	硬性

1.0.9

下表列出了此组件版本 1.0.9 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.14.0	硬性

1.0.8

下表列出了此组件版本 1.0.8 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.13.0	硬性

1.0.7

下表列出了此组件版本 1.0.7 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.12.0	硬性

1.0.6

下表列出了此组件版本 1.0.6 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.11.0	硬性

1.0.5

下表列出了此组件版本 1.0.5 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.10.0	硬性

1.0.4

下表列出了此组件的版本 1.0.4 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.9.0	硬性

1.0.3

下表列出了此组件版本 1.0.3 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.8.0	硬性

1.0.2

下表列出了此组件版本 1.0.2 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.7.0	硬性

1.0.1

下表列出了此组件版本 1.0.1 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.6.0	硬性

1.0.0

下表列出了此组件的版本 1.0.0 的依赖关系。

依赖关系	兼容版本	依赖关系类型
Greengrass Nucleus	>=2.4.0 <2.5.0	硬性

有关组件依赖关系的更多信息，请参阅组件配方参考。

配置

此组件提供您可以在部署组件时自定义的以下配置参数。

pubSubPublish

（可选）定义是否向 $local/greengrass/telemetry 主题发布遥测数据。支持的值为 true 和 false。

默认值：true

mqttTopic

（可选）此组件向其发布遥测数据 Amazon IoT Core MQTT的主题。

将此值设置为要向其发布遥测数据 Amazon IoT Core MQTT的主题。当此值为空时，Nucleus 发射器不会将遥测数据发布到 Amazon Web Services 云。

注意

使用MQTT主题向发布数据需视Amazon IoT Core 定价而定。 Amazon Web Services 云

默认值：""

telemetryPublishIntervalMs

（可选）组件发布遥测数据的间隔时长（以毫秒为单位）。如果将此值设置为低于支持的最小值，则组件将改用最小值。

注意

较短的发布间隔会导致核心设备上的CPU使用率更高。我们建议您从默认的发布间隔开始，然后根据设备的CPU使用情况进行调整。

最低：500

默认值：60000

例示例：配置合并更新

以下示例显示了一个配置合并更新示例，该更新允许每 5 秒向$local/greengrass/telemetry主题和主题发布遥测数据。greengrass/myTelemetry Amazon IoT Core MQTT


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

输出数据

此组件以JSON数组形式发布有关以下主题的遥测指标。

本地主题：$local/greengrass/telemetry

您也可以选择将遥测指标发布到某个 Amazon IoT Core MQTT主题。有关主题的更多信息，请参阅《Amazon IoT Core 开发人员指南》中的MQTT主题。

例示例数据


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

指标的聚合类型。

对于该CpuUsage指标，此属性设置为，Average因为该指标的发布值是自上次发布事件以来的平均CPU使用量。

对于所有其他指标，Nucleus 发射器不会聚合指标值，并且此属性设置为 Count。

N

指标的名称。

NS

指标命名空间。

TS

表示数据在何时收集的时间戳。

U

指标值的单位。

V

指标值。

Nucleus 发射器发布以下指标：

名称	描述
系统
`SystemMemUsage`	Greengrass 核心设备上所有应用程序（包括操作系统）当前使用的内存量。
`CpuUsage`	Greengrass 核心设备上所有应用程序（包括操作系统）的CPU当前使用量。
`TotalNumberOfFDs`	Greengrass 核心设备操作系统存储的文件描述符的数量。一个文件描述符可以唯一地标识一个打开的文件。
Greengrass Nucleus
`NumberOfComponentsRunning`	Greengrass 核心设备上运行的组件的数量。
`NumberOfComponentsErrored`	Greengrass 核心设备上处于错误状态的组件的数量。
`NumberOfComponentsInstalled`	Greengrass 核心设备上安装的组件的数量。
`NumberOfComponentsStarting`	Greengrass 核心设备上启动的组件的数量。
`NumberOfComponentsNew`	Greengrass 核心设备上新组件的数量。
`NumberOfComponentsStopping`	Greengrass 核心设备上停止组件的数量。
`NumberOfComponentsFinished`	Greengrass 核心设备上完成组件的数量。
`NumberOfComponentsBroken`	Greengrass 核心设备上损坏组件的数量。
`NumberOfComponentsStateless`	Greengrass 核心设备上无状态组件的数量。

使用量

要使用系统运行状况遥测数据，您可以创建自定义组件，这些组件可订阅 Nucleus 发射器向其发布遥测数据的主题，并根据需要对这些数据做出反应。由于 Nucleus 发射器组件提供了将遥测数据发布到本地主题的选项，因此您可以订阅该主题，并使用已发布的数据在核心设备上进行本地操作。然后，即使核心设备与云的连接有限，核心设备也可以对遥测数据做出反应。

例如，您可以配置一个组件，该组件侦听 $local/greengrass/telemetry 主题上的遥测数据，并将数据发送到流管理器组件，以将数据流式传输到 Amazon Web Services 云。有关创建此类组件的更多信息，请参阅发布/订阅本地消息和创建使用流管理器的自定义组件。

本地日志文件

此组件使用与 Greengrass Nucleus 组件相同的日志文件。

查看此组件的日志

在核心设备上运行以下命令以实时查看此组件的日志文件。将/greengrass/v2或C:\greengrass\v2替换为 Amazon IoT Greengrass 根文件夹的路径。
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

更改日志

下表介绍每个组件版本的更改。

版本	更改
2016-09-01	Greengrass nucleus 版本 2.14.0 版本的版本已更新。
1.0.9	对 Greengrass Nucleus 版本 2.13.0 发行版进行了版本更新。
1.0.8	版本更新为 Greengrass Nucleus 版本 2.12.0 发布版。
1.0.7	版本更新为 Greengrass Nucleus 版本 2.11.0 发布版。
1.0.6	版本更新为 Greengrass Nucleus 版本 2.10.0 发布版。
1.0.5	对 Greengrass Nucleus版本 2.9.0 发行版进行了版本更新。
1.0.4	版本更新为 Greengrass Nucleus 版本 2.8.0 发布版。
1.0.3	版本更新为 Greengrass Nucleus 版本 2.7.0 发布版。
1.0.2	版本更新为 Greengrass Nucleus 版本 2.6.0 发布版。
1.0.1	版本更新为 Greengrass Nucleus 版本 2.5.0 发布版。
1.0.0	初始版本。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

MQTT5 经纪人 (EMQX)

PKCS#11 提供商