原子核遙測發射器 - AWS IoT Greengrass
版本類型作業系統相依性組態輸出資料用量本機記錄檔Changelog

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

原子核遙測發射器

核心遙測發射器元件 (aws.greengrass.telemetry.NucleusEmitter) 會收集系統健康情況遙測資料，並持續將其發佈至本機主題和 MQTT 主題。AWS IoT Core此元件可讓您在 Greengrass 核心裝置上收集即時系統遙測。如需將系統遙測資料發佈至 Amazon EventBridge 之 Greengrass 遙測代理程式的相關資訊，請參閱。從AWS IoT Greengrass核心裝置收集系統健康狀態遙測資料

根據預設，核心遙測發射器元件會每 60 秒發佈一次遙測資料至下列本機發佈/訂閱主題。

$local/greengrass/telemetry

核心遙測發射器元件預設不會發佈至 AWS IoT Core MQTT 主題。您可以將此元件設定為在部署 AWS IoT Core MQTT 主題時發佈至 MQTT 主題。使用 MQTT 主題將資料發佈至的需要AWS 雲端AWS IoT Core定價。

AWS IoT Greengrass提供數個社群元件，協助您使用 InfluxDB 和 Grafana 在核心裝置上本機分析和視覺化遙測資料。這些元件使用來自核輻射器元件的遙測資料。如需詳細資訊，請參閱 In fluxDB 發行者元件的讀我檔案。

版本

此元件具有下列版本：

  • 1.0.x

類型

這個組件是一個插件組件（aws.greengrass.plugin）。Greengrass 核在與核相同的 Java 虛擬機（JVM）中運行此組件。當您在核心裝置上變更此元件的版本時，核心會重新啟動。

此組件使用與 Greengrass 核相同的日誌文件。如需詳細資訊，請參閱監控AWS IoT Greengrass日誌。

如需詳細資訊，請參閱元件類型。

作業系統

此元件可安裝在執行下列作業系統的核心裝置上：

  • Linux

  • Windows

相依性

部署元件時，AWS IoT Greengrass也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的需求，才能成功部署元件。本節列出此元件之已發行版本的相依性，以及定義每個相依性之元件版本的語意版本條件約束。您也可以在AWS IoT Greengrass主控台中檢視元件每個版本的相依性。在元件詳細資料頁面上，尋找 [相依性] 清單。

1.0.7

下表列出此元件 1.0.7 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.6

下表列出此元件 1.0.6 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.5

下表列出此元件 1.0.5 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.4

下表列出此元件 1.0.4 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.3

下表列出此元件 1.0.3 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.2

下表列出此元件 1.0.2 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.1

下表列出此元件 1.0.1 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
1.0.0

下表列出此元件 1.0.0 版的相依性。

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式

如需有關元件相依性的詳細資訊，請參閱元件方案參考。

組態

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

pubSubPublish

(選擇性) 定義是否將遙測資料發佈至$local/greengrass/telemetry主題。支援的值為 true 和 false。

預設：true

mqttTopic

(選擇性) 此元件發佈遙測資料的 AWS IoT Core MQTT 主題。

將此值設定為您要發佈遙測資料的 AWS IoT Core MQTT 主題。當此值為空時，核子核發射器不會將遙測資料發佈至. AWS 雲端

注意

使用 MQTT 主題將資料發佈至的需要AWS 雲端AWS IoT Core定價。

預設：""

telemetryPublishIntervalMs

(選擇性) 元件發佈遙測資料之間的時間量 (毫秒)。如果您將此值設定為低於支援的最小值，元件會改用最小值。

注意

較低的發佈間隔會導致核心裝置上的 CPU 使用率較高。我們建議您從預設發佈間隔開始，並根據裝置的 CPU 使用率進行調整。

下限：500

預設：60000

範例：組態合併更新

下列範例顯示組態合併更新範例，此更新可讓您每 5 秒發佈一次遙測資料至$local/greengrass/telemetry主題和 greengrass/myTelemetry AWS IoT Core MQTT 主題。

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

輸出資料

此元件會根據下列主題將遙測度量發佈為 JSON 陣列。

本地主題：$local/greengrass/telemetry

您也可以選擇將遙測指標發佈至 AWS IoT Core MQTT 主題。如需有關主題的詳細資訊，請參閱AWS 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 使用量。

對於所有其他度量，核子核發射器不會彙總度量值，而且此屬性設定為。Count

N

指標的名稱

NS

測量結果命名空間。

TS

收集資料的時間戳記。

U

公制值的單位。

V

指標值。

核發射器發布以下指標：

名稱 描述

系統

SystemMemUsage

Greengrass 核心裝置 (包括作業系統) 上所有應用程式目前使用的記憶體容量。

CpuUsage

Greengrass 核心裝置 (包括作業系統) 上所有應用程式目前正在使用的 CPU 數量。

TotalNumberOfFDs

Greengrass 核心裝置作業系統所儲存的檔案描述元數目。一個文件描述符唯一標識一個打開的文件。

Greengrass 核

NumberOfComponentsRunning

在 Greengrass 核心裝置上執行的元件數目。

NumberOfComponentsErrored

Greengrass 核心裝置上處於錯誤狀態的元件數目。

NumberOfComponentsInstalled

安裝在 Greengrass 核心裝置上的元件數目。

NumberOfComponentsStarting

在 Greengrass 核心裝置上啟動的元件數目。

NumberOfComponentsNew

Greengrass 核心裝置上新增的元件數目。

NumberOfComponentsStopping

在 Greengrass 核心裝置上停止的元件數目。

NumberOfComponentsFinished

在 Greengrass 核心裝置上完成的元件數目。

NumberOfComponentsBroken

Greengrass 核心裝置上損壞的元件數目。

NumberOfComponentsStateless

Greengrass 核心裝置上無狀態的元件數目。

用量

若要使用系統健康情況遙測資料，您可以建立自訂元件，以訂閱核心發射器發佈遙測資料的主題，並視需要對該資料做出回應。由於核心發射器元件提供將遙測資料發佈到本機主題的選項，因此您可以訂閱該主題，並使用已發佈的資料在核心裝置上在本機上執行動作。然後，即使與雲端的連線有限，核心裝置也可以對遙測資料做出反應。

例如，您可以設定偵聽遙測資料$local/greengrass/telemetry主題的元件，並將資料傳送至串流管理員元件，以將資料串流至. AWS 雲端 如需建立此類元件的詳細資訊，請參閱發佈/訂閱本地訊息和建立使用串流管理員的自訂元件。

本機記錄檔

此元件使用與 Greengrass 核元件相同的記錄檔。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
若要檢視此元件的記錄

  • 在核心裝置上執行下列命令，即時檢視此元件的記錄檔。將/greengrass/v2 或 C:\greengrass\v2 取代為AWS IoT Greengrass根資料夾的路徑。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

下表說明元件每個版本中的變更。

版本

變更

1.0.7

 版本更新了 Greengrass 核 2.11.0 版本釋放。

1.0.6

 版本更新了 Greengrass 核 2.10.0 版本釋放。

1.0.5

 版本更新 Greengrass 2.9.0 版本釋放。

1.0.4

 版本更新 Greengrass 2.8.0 版本的版本。

1.0.3

版本更新了 Greengrass 核 2.7.0 版本釋放。

1.0.2

版本更新 Greengrass 2.6.0 版本的版本。

1.0.1

版本更新了 Greengrass 核 2.5.0 版本。

1.0.0

初始版本。