AWS IoT Greengrass Version 1 於 2023 年 6 月 30 日進入延長使用壽命階段。如需詳細資訊，請參閱AWS IoT Greengrass V1 維護政策。在此日期之後， AWS IoT Greengrass V1 將不會發行提供功能、增強功能、錯誤修正或安全性修補程式的更新。在上運行的設備 AWS IoT Greengrass V1 不會中斷，並將繼續運行並連接到雲。我們強烈建議您移轉至 AWS IoT Greengrass Version 2，這會增加重要的新功能，並支援其他平台。

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

使用 AWS IoT Greengrass 日誌進行監控

AWS IoT Greengrass 由雲端服務和 AWS IoT Greengrass Core 軟體組成。AWS IoT GreengrassCore 軟體可以將日誌寫入 Amazon CloudWatch 和核心裝置的本機檔案系統。核心上執行的 Lambda 函數和連接器也可以將記錄寫入 CloudWatch 記錄檔和本機檔案系統。您可以使用日誌來監控事件和排解疑難問題。所有 AWS IoT Greengrass 日誌項目皆含有時間戳記、日誌等級和事件資料。對記錄設定所做的變更會在部署群組後生效。

於群組層級中設定日誌記錄。如需顯示如何設定 Greengrass 群組記錄日誌的步驟，請參閱設定 AWS IoT Greengrass 的日誌記錄。

存取 CloudWatch 記錄

如果您設定 CloudWatch 記錄，則可以在 Amazon CloudWatch 主控台的日誌頁面上檢視日誌。AWS IoT Greengrass 日誌的日誌群組使用以下的命名慣例：

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

每個日誌群組都包含使用以下命名慣例的日誌串流：

date/account-id/greengrass-group-id/name-of-core-that-generated-log

當您使用 CloudWatch 記錄檔時，需要考量下列事項：

存取檔案系統日誌

如果設定檔案系統記錄，則日誌檔會存放於核心裝置的 greengrass-root/ggc/var/log 之下。以下是高階目錄結構：

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

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

預設日誌記錄組態

如果日誌記錄設定不明確，則在第一個群組部署後 AWS IoT Greengrass 會使用以下預設記錄組態。

設定 AWS IoT Greengrass 的日誌記錄

您可以使用AWS IoT主控台或 AWS IoT GreengrassAPI 來設定AWS IoT Greengrass記錄。

設定日誌記錄 (主控台)

您可以在群組的設定頁面設定日誌記錄。

設定日誌記錄 (API)

您可以使用 AWS IoT Greengrass 記錄器 API，以編寫程式的方式設定日誌記錄。例如，使用 CreateLoggerDefinition 動作根據 LoggerDefinitionVersion承載建立記錄器定義，其會使用以下語法：

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion 是一個陣列，其中一個或多個 Logger 物件具有下列屬性：

組態範例

以下 LoggerDefinitionVersion 範例指定記錄組態：

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

在您建立記錄器定義版本後，您可以使用其版本 ARN 在部署群組前建立群組。

記錄限制

AWS IoT Greengrass 具有下列記錄限制。

每秒交易數

啟用記錄時，記錄元件會先在本機上批次記錄事件，然後再將事件傳送到 CloudWatch，因此您可以以高於每個記錄資料流每秒五個要求的速率進行記錄。 CloudWatch

記憶體

如果設定AWS IoT Greengrass為將記錄傳送至， CloudWatch 且 Lambda 函數在長時間內記錄超過 5 MB/ 秒，則內部處理管線最終會填滿。理論上最壞的情況是每個 Lambda 函數 6 MB。

時鐘誤差

啟用記錄時 CloudWatch ，記錄元件會 CloudWatch使用正常的簽章版本 4 簽署程序來簽署要求。如果AWS IoT Greengrass核心裝置上的系統時間不同步超過 15 分鐘，則會拒絕要求。

硬碟使用量

使用下列公式計算磁碟要記錄的最大使用總量。

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

其中：

日誌受損

如果您的AWS IoT Greengrass核心裝置設定為僅登入， CloudWatch 而且沒有網際網路連線，您就無法擷取記憶體中目前的記錄檔。

當 Lambda 函數終止時 (例如，在部署期間)，幾秒鐘的記錄不會寫入。 CloudWatch

CloudTrail 日誌

AWS IoT Greengrass使用執行的服務AWS CloudTrail，可提供中使用者、角色或服務所採取之動作記錄的AWS服務AWS IoT Greengrass。如需更多詳細資訊，請參閱 使用 AWS CloudTrail 記錄 AWS IoT Greengrass API 呼叫。