監控 AWS IoT Greengrass 日誌

焦點模式

監控 AWS IoT Greengrass 日誌 - AWS IoT Greengrass

存取檔案系統日誌存取 CloudWatch Logs 存取系統服務日誌啟用記錄至 CloudWatch Logs 設定的記錄 AWS IoT Greengrass AWS CloudTrail 日誌

AWS IoT Greengrass 包含雲端服務和 AWS IoT Greengrass Core 軟體。 AWS IoT Greengrass 核心軟體可以將日誌寫入 Amazon CloudWatch Logs 和核心裝置的本機檔案系統。在核心裝置上執行的 Greengrass 元件也可以將日誌寫入 CloudWatch Logs 和本機檔案系統。您可以使用日誌來監控事件和排解疑難問題。所有 AWS IoT Greengrass 日誌項目都包含時間戳記、日誌層級和事件的相關資訊。

根據預設， AWS IoT Greengrass Core 軟體只會將日誌寫入本機檔案系統。您可以即時檢視檔案系統日誌，以便偵錯您開發和部署的 Greengrass 元件。您也可以設定核心裝置將日誌寫入 CloudWatch Logs，以便對核心裝置進行故障診斷，而不需要存取本機檔案系統。如需詳細資訊，請參閱啟用記錄至 CloudWatch Logs。

存取檔案系統日誌

AWS IoT Greengrass 核心軟體會將日誌存放在核心裝置上的 /greengrass/v2/logs 資料夾中，其中 /greengrass/v2是 AWS IoT Greengrass 根資料夾的路徑。日誌資料夾具有下列結構。


/greengrass/v2
└── logs
    ├── greengrass.log
    ├── greengrass_2021_09_14_15_0.log
    ├── ComponentName.log
    ├── ComponentName_2021_09_14_15_0.log
    └── main.log

greengrass.log – AWS IoT Greengrass 核心軟體日誌檔案。使用此日誌檔案來檢視元件和部署的即時資訊。此日誌檔案包含 Greengrass 核的日誌，這是 AWS IoT Greengrass 核心軟體的核心，以及外掛程式元件，例如日誌管理員和秘密管理員。
ComponentName.log – Greengrass 元件日誌檔案。使用元件日誌檔案來檢視在核心裝置上執行之 Greengrass 元件的即時資訊。一般元件和 Lambda 元件會將標準輸出 (stdout) 和標準錯誤 (stderr) 寫入這些日誌檔案。
main.log – 處理元件生命週期之main服務的日誌檔案。此日誌檔案一律為空白。

如需外掛程式、一般和 Lambda 元件之間差異的詳細資訊，請參閱元件類型。

使用檔案系統日誌時有下列考量：

根使用者許可

您必須具有讀取檔案系統 AWS IoT Greengrass 日誌的根許可。
日誌檔案輪換

AWS IoT Greengrass 核心軟體每小時輪換日誌檔案，或在超過檔案大小限制時輪換日誌檔案。輪換的日誌檔案在檔案名稱中包含時間戳記。例如，輪換 AWS IoT Greengrass 的核心軟體日誌檔可能命名為 greengrass_2021_09_14_15_0.log。預設的檔案大小限制為 1，024 KB (1 MB)。您可以在 Greengrass 核元件上設定檔案大小限制。
日誌檔案刪除

AWS IoT Greengrass 核心軟體會在 AWS IoT Greengrass 核心軟體日誌檔案或 Greengrass 元件日誌檔案的大小超過磁碟空間限制時，清除先前的日誌檔案，包括輪換的日誌檔案。Core AWS IoT Greengrass 軟體日誌和每個元件日誌的預設磁碟空間限制為 10，240 KB (10 MB)。您可以在 Greengrass 核元件或日誌管理員元件上設定 AWS IoT Greengrass 核心軟體日誌磁碟空間限制。日誌管理員您可以在日誌管理員元件上設定每個元件的日誌磁碟空間限制。

檢視 AWS IoT Greengrass 核心軟體日誌檔案

執行下列命令以即時檢視日誌檔案。/greengrass/v2 將取代為 AWS IoT Greengrass 根資料夾的路徑。
Linux or Unix
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows Command Prompt (CMD)
```
type C:\greengrass\v2\logs\com.example.HelloWorld.log
```
type 命令會將檔案的內容寫入終端機。執行此命令多次，以觀察檔案中的變更。
PowerShell
```
gc C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
anchor anchor anchor
sudo tail -f /greengrass/v2/logs/greengrass.log

檢視元件的日誌檔案

執行下列命令以即時檢視日誌檔案。將 /greengrass/v2或 C：\greengrass\v2 取代為 AWS IoT Greengrass 根資料夾的路徑，並將 com.example.HelloWorld 取代為元件名稱。
Linux or Unix
```
sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
```
PowerShell
```
gc C:\greengrass\v2\logs\com.example.HelloWorld.log -Tail 10 -Wait
```
anchor anchor
sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log

您也可以使用 Greengrass CLI 的 logs命令來分析核心裝置上的 Greengrass 日誌。若要使用 logs命令，您必須設定 Greengrass 核以輸出 JSON 格式日誌檔案。如需詳細資訊，請參閱 Greengrass 命令列界面和日誌。

存取 CloudWatch Logs

您可以部署日誌管理員元件，將核心裝置設定為寫入 CloudWatch Logs。如需詳細資訊，請參閱啟用記錄至 CloudWatch Logs。然後，您可以在 Amazon CloudWatch 主控台的日誌頁面上或使用 CloudWatch Logs API 檢視日誌。

日誌群組名稱


/aws/greengrass/componentType/region/componentName

日誌群組名稱使用下列變數：

componentType – 元件的類型，可以是下列其中一項：
- GreengrassSystemComponent – 此日誌群組包含核和外掛程式元件的日誌，這些元件在與 Greengrass 核相同的 JVM 中執行。元件是 Greengrass 核的一部分。
- UserComponent – 此日誌群組包含一般元件、Lambda 元件和裝置上的其他應用程式的日誌。元件不是 Greengrass 核的一部分。
如需詳細資訊，請參閱元件類型。
region – 核心裝置使用的 AWS 區域。
componentName – 元件的名稱。對於系統日誌，此值為 System。

日誌串流名稱


/date/thing/thingName

日誌串流名稱使用下列變數：

date – 日誌的日期，例如 2020/12/15。日誌管理員元件使用 yyyy/MM/dd 格式。
thingName – 核心裝置的名稱。

注意

如果物件名稱包含冒號 (:)，則日誌管理員會將冒號取代為加號 (+)。

當您使用日誌管理員元件寫入 CloudWatch Logs 時，會套用下列考量：

日誌延遲

注意
我們建議您升級至日誌管理員 2.3.0 版，以減少輪換和作用中日誌檔案的日誌延遲。當您升級至 log Manager 2.3.0 時，我們建議您也升級至 Greengrass nucleus 2.9.1。

日誌管理員元件 2.2.8 版（及更早版本）只會從輪換的日誌檔案處理和上傳日誌。根據預設， AWS IoT Greengrass Core 軟體會每小時輪換日誌檔案，或在 1，024 KB 之後輪換日誌檔案。因此，日誌管理員元件只會在 AWS IoT Greengrass Core 軟體或 Greengrass 元件寫入超過 1，024 KB 的日誌之後上傳日誌。您可以設定較低的日誌檔案大小限制，讓日誌檔案更頻繁地輪換。這會導致日誌管理員元件更頻繁地將日誌上傳至 CloudWatch Logs。

日誌管理員元件 2.3.0 版（及更新版本）會處理和上傳所有日誌。當您撰寫新的日誌時，日誌管理員 2.3.0 版（及更新版本）會處理並直接上傳該作用中日誌檔案，而不是等待輪換。這表示您可以在 5 分鐘內檢視新日誌。

日誌管理員元件會定期上傳新的日誌。根據預設，日誌管理員元件會每 5 分鐘上傳新的日誌。您可以設定較低的上傳間隔，讓日誌管理員元件透過設定，更頻繁地將日誌上傳至 CloudWatch LogsperiodicUploadIntervalSec。如需如何設定此定期間隔的詳細資訊，請參閱組態。

日誌可以近乎即時地從相同的 Greengrass 檔案系統上傳。如果您需要即時觀察日誌，請考慮使用檔案系統日誌。

注意
如果您使用不同的檔案系統來寫入日誌，日誌管理員會還原為日誌管理員元件 2.2.8 版及更早版本中的行為。如需有關存取檔案系統日誌的資訊，請參閱存取檔案系統日誌。
時鐘偏移

日誌管理員元件使用標準 Signature 第 4 版簽署程序來建立對 CloudWatch Logs 的 API 請求。如果核心裝置上的系統時間不同步超過 15 分鐘，則 CloudWatch Logs 會拒絕請求。如需詳細資訊，請參閱 AWS 一般參考 中的 Signature 第 4 版簽署程序。

存取系統服務日誌

如果您將 AWS IoT Greengrass Core 軟體設定為系統服務，您可以檢視系統服務日誌來疑難排解問題，例如軟體無法啟動。

檢視系統服務日誌 (CLI)

執行下列命令以檢視 AWS IoT Greengrass 核心軟體系統服務日誌。
Linux or Unix (systemd)
```
sudo journalctl -u greengrass.service
```
Windows Command Prompt (CMD)
```
type C:\greengrass\v2\logs\greengrass.wrapper.log
```
PowerShell
```
gc C:\greengrass\v2\logs\greengrass.wrapper.log
```
anchor anchor anchor
sudo journalctl -u greengrass.service
在 Windows 裝置上， AWS IoT Greengrass Core 軟體會建立個別的日誌檔案，以處理系統服務錯誤。執行下列命令以檢視系統服務錯誤日誌。
Windows Command Prompt (CMD)
```
type C:\greengrass\v2\logs\greengrass.err.log
```
PowerShell
```
gc C:\greengrass\v2\logs\greengrass.err.log
```
anchor anchor
type C:\greengrass\v2\logs\greengrass.err.log

在 Windows 裝置上，您也可以使用 Event Viewer 應用程式來檢視系統服務日誌。

檢視 Windows 服務日誌（事件檢視器）

開啟事件檢視器應用程式。
選取 Windows Logs 以展開日誌。
選擇應用程式以檢視應用程式服務日誌。
尋找並開啟來源為的事件日誌greengrass。

啟用記錄至 CloudWatch Logs

您可以部署日誌管理員元件，以設定核心裝置將日誌寫入 CloudWatch Logs。您可以啟用 CloudWatch Logs for AWS IoT Greengrass Core 軟體日誌，也可以針對特定 Greengrass 元件啟用 CloudWatch Logs。

注意

Greengrass 核心裝置的字符交換角色必須允許核心裝置寫入 CloudWatch Logs，如下列範例 IAM 政策所示。如果您使用自動資源佈建安裝 AWS IoT Greengrass Core 軟體，您的核心裝置會擁有這些許可。


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

若要設定核心裝置將 AWS IoT Greengrass 核心軟體日誌寫入 CloudWatch Logs，請建立部署，指定true為 aws.greengrass.LogManager 元件uploadToCloudWatch設定的組態更新。 AWS IoT Greengrass 核心軟體日誌包含 Greengrass 核和外掛程式元件的日誌。


{
  "logsUploaderConfiguration": {
    "systemLogsConfiguration": {
      "uploadToCloudWatch": "true"
    }
  }
}

若要設定核心裝置將 Greengrass 元件的日誌寫入 CloudWatch Logs，請建立部署，指定將元件新增至元件記錄組態清單的組態更新。當您將元件新增至此清單時，日誌管理員元件會將其日誌寫入 CloudWatch Logs。元件日誌包含一般元件和 Lambda 元件的日誌。


{
  "logsUploaderConfiguration": {
    "componentLogsConfigurationMap": {
      "com.example.HelloWorld": {
      
      }
    }
  }
}

部署日誌管理員元件時，您也可以設定磁碟空間限制，以及核心裝置在將日誌檔案寫入 CloudWatch Logs 後是否刪除日誌檔案。如需詳細資訊，請參閱設定的記錄 AWS IoT Greengrass。

設定的記錄 AWS IoT Greengrass

您可以設定下列選項來自訂 Greengrass 核心裝置的記錄。若要設定這些選項，請建立指定 Greengrass 核或日誌管理員元件組態更新的部署。

將日誌寫入 CloudWatch Logs

若要遠端疑難排解核心裝置，您可以設定核心裝置將 AWS IoT Greengrass 核心軟體和元件日誌寫入 CloudWatch Logs。若要這麼做，請部署和設定日誌管理員元件。如需詳細資訊，請參閱啟用記錄至 CloudWatch Logs。
刪除上傳的日誌檔案

若要減少磁碟空間用量，您可以將核心裝置設定為在將日誌檔案寫入 CloudWatch Logs 後刪除日誌檔案。如需詳細資訊，請參閱日誌管理員元件的 deleteLogFileAfterCloudUpload 參數，您可以為AWS IoT Greengrass 核心軟體日誌和元件日誌指定參數。
日誌磁碟空間限制

若要限制磁碟空間用量，您可以在核心裝置上設定每個日誌的最大磁碟空間，包括其輪換的日誌檔案。例如，您可以設定 greengrass.log和輪換greengrass.log檔案的最大合併磁碟空間。如需詳細資訊，請參閱 Greengrass 核元件的 logging.totalLogsSizeKB 參數和日誌管理員元件的 diskSpaceLimit 參數，您可以為AWS IoT Greengrass 核心軟體日誌和元件日誌指定參數。
日誌檔案大小限制

您可以為每個日誌檔案設定檔案大小上限。日誌檔案超過此檔案大小限制後， AWS IoT Greengrass Core 軟體會建立新的日誌檔案。日誌管理員元件 2.28 版（及更早版本）只會將輪換的日誌檔案寫入 CloudWatch Logs，因此您可以指定較低的檔案大小限制，以更頻繁地將日誌寫入 CloudWatch Logs。日誌管理員元件 2.3.0 版（及更新版本）會處理和上傳所有日誌，而不是等待輪換。如需詳細資訊，請參閱 Greengrass 核元件的日誌檔案大小限制參數 (logging.fileSizeKB)。
日誌層級下限

您可以設定 Greengrass 核元件寫入檔案系統日誌的最低日誌層級。例如，您可以指定DEBUG關卡日誌以協助故障診斷，也可以指定ERROR關卡日誌以減少核心裝置建立的日誌數量。如需詳細資訊，請參閱 Greengrass 核元件的日誌層級參數 (logging.level)。

您也可以設定日誌管理員元件寫入 CloudWatch Logs 的最低日誌層級。例如，您可以指定較高的日誌層級來降低記錄成本。如需詳細資訊，請參閱日誌管理員元件的 minimumLogLevel 參數，您可以為AWS IoT Greengrass 核心軟體日誌和元件日誌指定參數。
檢查日誌以寫入 CloudWatch Logs 的間隔

若要增加或減少日誌管理員元件將日誌寫入 CloudWatch Logs 的頻率，您可以設定其檢查新日誌檔案寫入的間隔。例如，您可以指定比預設 5 分鐘間隔更短的間隔來檢視 CloudWatch Logs 中的日誌。您可以指定較高的間隔來降低成本，因為日誌管理員元件會將日誌檔案批次處理為較少的請求。如需詳細資訊，請參閱日誌管理員元件的上傳間隔參數 (periodicUploadIntervalSec)。
日誌格式

您可以選擇 AWS IoT Greengrass Core 軟體是以文字還是 JSON 格式寫入日誌。如果您讀取日誌，請選擇文字格式；如果您使用應用程式來讀取或剖析日誌，請選擇 JSON 格式。如需詳細資訊，請參閱 Greengrass 核元件的日誌格式參數 (logging.format)。
本機檔案系統日誌資料夾

您可以將日誌資料夾從 /greengrass/v2/logs 變更為核心裝置上的另一個資料夾。如需詳細資訊，請參閱 Greengrass 核元件的輸出目錄參數 (logging.outputDirectory)。

AWS CloudTrail 日誌

AWS IoT Greengrass 與整合 AWS CloudTrail，此服務提供使用者、角色或 AWS 服務所採取動作的記錄 AWS IoT Greengrass。如需詳細資訊，請參閱使用記錄 AWS IoT Greengrass V2 API 呼叫 AWS CloudTrail。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

日誌記錄和監控

使用 CloudTrail 記錄 API 呼叫

在本頁面

選取您的 Cookie 偏好設定

自訂 Cookie 偏好設定

必要

效能

功能

廣告

無法儲存 Cookie 偏好設定

監控 AWS IoT Greengrass 日誌

主題

存取檔案系統日誌

檢視 AWS IoT Greengrass 核心軟體日誌檔案

檢視元件的日誌檔案

存取 CloudWatch Logs

注意

注意

注意

存取系統服務日誌

檢視系統服務日誌 (CLI)

檢視 Windows 服務日誌（事件檢視器）

啟用記錄至 CloudWatch Logs

注意

設定的記錄 AWS IoT Greengrass

AWS CloudTrail 日誌

在本頁面

此頁面是否有幫助？

下一個主題：

上一個主題：

需要協助？

選取您的 Cookie 偏好設定

監控 AWS IoT Greengrass 日誌

主題

存取檔案系統日誌

檢視 AWS IoT Greengrass 核心軟體日誌檔案

檢視元件的日誌檔案

存取 CloudWatch Logs

注意

注意

注意

存取系統服務日誌

檢視系統服務日誌 (CLI)

檢視 Windows 服務日誌 （事件檢視器）

啟用記錄至 CloudWatch Logs

注意

設定 的記錄 AWS IoT Greengrass

AWS CloudTrail 日誌

在本頁面

此頁面是否有幫助？

下一個主題：

上一個主題：

需要協助？

檢視 Windows 服務日誌（事件檢視器）

設定的記錄 AWS IoT Greengrass