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

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

原子核遙測發射器

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

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

$local/greengrass/telemetry

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

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

版本

此元件具有下列版本：

  • 1.0.x

Type

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

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

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

作業系統

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

  • Linux

  • Windows

相依性

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

1.0.9

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

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

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

相依性 兼容版本 相依性類型
Greengrass 核 >=2.4.0 硬式
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

變更記錄

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

版本

變更

1.0.9

 版本更新了 Greengrass 2.13.0 版本。

1.0.8

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

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

初始版本。