

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

# 檢查 Greengrass 核心裝置狀態
<a name="device-status"></a>

Greengrass 核心裝置報告其軟體元件的狀態 AWS IoT Greengrass。您可以檢查每個裝置的運作狀態摘要，也可以檢查每個裝置上每個元件的狀態。

核心裝置的運作狀態如下：
+ `HEALTHY` – AWS IoT Greengrass 核心軟體和所有元件在核心裝置上執行時不會發生問題。
+ `UNHEALTHY` – AWS IoT Greengrass 核心軟體或元件在核心裝置上處於錯誤狀態。

**注意**  
AWS IoT Greengrass 倚賴個別裝置傳送狀態更新至 AWS 雲端。如果 AWS IoT Greengrass Core 軟體未在裝置上執行，或裝置未連線至 AWS 雲端，則該裝置回報的狀態可能不會反映其目前狀態。狀態時間戳記指出裝置狀態上次更新的時間。  
核心裝置會在下列時間傳送狀態更新：  
 AWS IoT Greengrass 核心軟體啟動時
當核心裝置從 接收部署時 AWS 雲端
對於 Greengrass 核 2.12.2 及更早版本，核心裝置會在核心裝置上任何元件的狀態變成 `ERRORED`或 `BROKEN`
對於 Greengrass 核 2.12.3 和更新版本，核心裝置會在核心裝置上任何元件的狀態變成 `ERRORED`、`RUNNING`、 `BROKEN`或 時傳送狀態更新 `FINISHED`
您可以[設定的定期間隔](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-fss)，預設為 24 小時
對於 AWS IoT Greengrass Core v2.7.0 和更新版本，核心裝置會在本機部署和雲端部署發生時傳送狀態更新

**Topics**
+ [檢查核心裝置的運作狀態](#check-core-device-health-status)
+ [檢查核心裝置群組的運作狀態](#check-core-device-group-health-status)
+ [檢查核心裝置元件狀態](#check-core-device-component-status)

## 檢查核心裝置的運作狀態
<a name="check-core-device-health-status"></a>

您可以檢查個別核心裝置的狀態。

**檢查核心裝置的狀態 (AWS CLI)**
+ 執行下列命令來擷取裝置的狀態。將 *coreDeviceName* 取代為要查詢的核心裝置名稱。

  ```
  aws greengrassv2 get-core-device --core-device-thing-name coreDeviceName
  ```

  回應包含核心裝置的相關資訊，包括其狀態。

## 檢查核心裝置群組的運作狀態
<a name="check-core-device-group-health-status"></a>

您可以檢查核心裝置群組 （物件群組） 的狀態。

**檢查裝置群組的狀態 (AWS CLI)**
+ 執行下列命令來擷取多個核心裝置的狀態。將命令中的 ARN 取代為要查詢之物件群組的 ARN。

  ```
  aws greengrassv2 list-core-devices --thing-group-arn "arn:aws:iot:region:account-id:thinggroup/thingGroupName"
  ```

  回應包含物件群組中核心裝置的清單。清單中的每個項目都包含核心裝置的狀態。

## 檢查核心裝置元件狀態
<a name="check-core-device-component-status"></a>

您可以在核心裝置上檢查軟體元件的狀態，例如生命週期狀態。如需元件生命週期狀態的詳細資訊，請參閱[開發 AWS IoT Greengrass 元件](develop-greengrass-components.md)。

**若要檢查核心裝置上的元件狀態 (AWS CLI)**
+ 執行下列命令來擷取核心裝置上的元件狀態。將 *coreDeviceName* 取代為要查詢的核心裝置名稱。

  ```
  aws greengrassv2 list-installed-components --core-device-thing-name coreDeviceName
  ```

  回應包含在核心裝置上執行的元件清單。清單中的每個項目都包含元件的生命週期狀態，包括資料的目前狀態，以及 Greengrass 核心裝置上次將包含特定元件的訊息傳送到雲端的時間。回應也會包含將元件帶入 Greengrass 核心裝置的最新部署來源。
**注意**  
此命令會擷取 Greengrass 核心裝置執行的元件分頁清單。根據預設，此清單不包含部署為其他元件相依性的元件。您可以將 `topologyFilter` 參數設定為 ，在回應中包含相依性`ALL`。