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

# 設定 群組
<a name="xray-console-groups"></a>

群組是一系列追蹤，為篩選條件表達式所定義。您可以使用 群組來產生額外的服務圖表，並提供 Amazon CloudWatch 指標。您可以使用 AWS X-Ray 主控台或 X-Ray API 來建立和管理 服務的群組。本主題說明如何使用 X-Ray 主控台建立和管理群組。如需如何使用 X-Ray API 管理群組的資訊，請參閱 [Groups (群組)](xray-api-configuration.md#xray-api-configuration-groups)。

您可以建立追蹤映射、追蹤或分析的追蹤群組。當您建立群組時，群組會在所有三個頁面上的群組下拉式功能表上變成篩選條件：**追蹤地圖**、**追蹤****和分析**。

![\[群組功能表\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-menu.png)


群組會根據名稱或 Amazon Resource Name (ARN) 進行識別，且包含篩選條件表達式。此服務會比較傳入表達式的追蹤，並依序存放。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。

更新群組的篩選條件表達式不會變更已記錄的資料。更新僅適用於後續追蹤。這會導致圖表合併新舊表達式。若要避免這種情況，請刪除目前的群組並建立新的群組。

**注意**  
群組的計費方式是根據符合篩選條件表達式的擷取追蹤。如需詳細資訊，請參閱 [AWS X-Ray 定價](https://aws.amazon.com/xray/pricing/)。

**Topics**
+ [建立群組](#xray-console-group-create-console)
+ [套用群組](#xray-console-group-apply)
+ [編輯群組](#xray-console-group-edit)
+ [複製群組](#xray-console-group-clone)
+ [刪除群組](#xray-console-group-delete)
+ [在 Amazon CloudWatch 中檢視群組指標](#xray-console-group-cloudwatch)



## 建立群組
<a name="xray-console-group-create-console"></a>

**注意**  
您現在可以從 Amazon CloudWatch 主控台設定 X-Ray 群組。您也可以繼續使用 X-Ray 主控台。

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中選擇**設定**。

1. 在 **X-Ray 追蹤**區段的**群組**下選擇**檢視設定**。

1. 選擇**群組清單上方的建立**群組。

1. 在**建立群組**頁面上，輸入群組的名稱。群組名稱最多可有 32 個字元，且包含英數字元和破折號。群組名稱區分大小寫。

1. 輸入篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自服務 的故障追蹤`api.example.com`。 和 請求至回應時間大於或等於五秒的服務。

   ```
   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
   ```

1. 在 **Insights** 中，啟用或停用群組的洞見存取。如需洞見的詳細資訊，請參閱[使用 X-Ray 洞察](xray-console-insights.md)。  
![\[群組頁面上的洞見核取方塊\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-insights-cw.png)

1. 在**標籤**中，選擇**新增標籤**以輸入標籤索引鍵，也可以選擇輸入標籤值。繼續視需要新增其他標籤。標籤索引鍵必須是唯一的。若要刪除標籤，請選擇每個標籤下方的**移除**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。  
![\[群組頁面上的標籤欄位\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-tags-cw.png)

1. 選擇**建立群組**。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home). 的 X-Ray 主控台。

1. 從左側導覽窗格中的**群組**頁面，或從下列其中一個頁面上的群組選單開啟**建立群組**頁面：**追蹤地圖**、**追蹤****和分析**。

1. 在**建立群組**頁面上，輸入群組的名稱。群組名稱最多可有 32 個字元，且包含英數字元和破折號。群組名稱區分大小寫。

1. 輸入篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自服務 的故障追蹤`api.example.com`。 和 請求至回應時間大於或等於五秒的服務。

   ```
   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
   ```

1. 在 **Insights** 中，啟用或停用群組的洞見存取。如需洞見的詳細資訊，請參閱[使用 X-Ray 洞察](xray-console-insights.md)。  
![\[群組頁面上的洞見核取方塊\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-insights.png)

1. 在**標籤**中，輸入標籤索引鍵，並選擇性地輸入標籤值。當您新增標籤時，會顯示新行，供您輸入另一個標籤。標籤索引鍵必須是唯一的。若要刪除標籤，請選擇標籤列結尾的 **X**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。  
![\[群組頁面上的標籤欄位\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-tags.png)

1. 選擇**建立群組**。

------

## 套用群組
<a name="xray-console-group-apply"></a>

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 從 **X-Ray 追蹤**下的導覽窗格開啟下列其中一個頁面：
   + **追蹤映射**
   + **追蹤**

1. 在**依 X-Ray 篩選群組篩選條件中輸入群組**名稱。頁面上顯示的資料會變更為符合 群組中設定的篩選條件表達式。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 開啟 X-Ray 主控台。

1. 從導覽窗格開啟下列其中一個頁面：
   + **追蹤映射**
   + **追蹤**
   + **分析**

1. 在群組功能表中，選擇您在 中建立的群組[建立群組](#xray-console-group-create-console)。頁面上顯示的資料會變更為符合 群組中設定的篩選條件表達式。

------

## 編輯群組
<a name="xray-console-group-edit"></a>

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中選擇**設定**。

1. 在 **X-Ray 追蹤**區段的**群組**下選擇**檢視設定**。

1. 從群組區段中選擇**群組**，然後選擇**編輯**。

1. 雖然您無法重新命名群組，但您可以更新篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自 服務的故障追蹤`api.example.com`，其中請求 URL 地址包含 `example/game`，而請求的回應時間大於或等於五秒。

   ```
   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
   ```

1. 在 **Insights** 中，啟用或停用群組的洞見存取。如需洞見的詳細資訊，請參閱[使用 X-Ray 洞察](xray-console-insights.md)。  
![\[群組頁面上的洞見核取方塊\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-insights-cw.png)

1. 在**標籤**中，選擇**新增標籤**以輸入標籤索引鍵，也可以選擇輸入標籤值。繼續視需要新增其他標籤。標籤索引鍵必須是唯一的。若要刪除標籤，請選擇每個標籤下方的**移除**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。  
![\[群組頁面上的標籤欄位\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-tags-cw.png)

1. 完成更新群組後，請選擇**更新群組**。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 開啟 X-Ray 主控台。

1. 執行下列其中一項操作以開啟**編輯群組**頁面。

   1. 在**群組**頁面上，選擇要編輯的群組名稱。

   1. 在下列其中一個頁面上的群組選單上，指向群組，然後選擇**編輯**。
      + **追蹤映射**
      + **追蹤**
      + **分析**

1. 雖然您無法重新命名群組，但您可以更新篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自 服務的故障追蹤`api.example.com`，其中請求 URL 地址包含 `example/game`，而請求的回應時間大於或等於五秒。

   ```
   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
   ```

1. 在 **Insights** 中，啟用或停用群組的洞察和洞察通知。如需洞見的詳細資訊，請參閱[使用 X-Ray 洞察](xray-console-insights.md)。  
![\[群組頁面上的洞見核取方塊\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-insights.png)

1. 在**標籤**中，編輯標籤索引鍵和值。標籤索引鍵必須是唯一的。標籤值是選用的；如果需要，您可以刪除值。若要刪除標籤，請選擇標籤列結尾的 **X**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。  
![\[群組頁面上的標籤欄位\]](http://docs.aws.amazon.com/zh_tw/xray/latest/devguide/images/group-tags.png)

1. 完成更新群組後，請選擇**更新群組**。

------

## 複製群組
<a name="xray-console-group-clone"></a>

複製群組會建立新的群組，其中包含現有群組的篩選條件表達式和標籤。當您複製群組時，新群組的名稱與其複製的群組相同，並`-clone`附加到名稱。

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中選擇**設定**。

1. 在 **X-Ray 追蹤**區段的**群組**下選擇**檢視設定**。

1. 從群組區段中選擇**群組**，然後選擇**複製**。

1. 在**建立群組**頁面上，群組的名稱為 *group-name*`-clone`。或者，輸入群組的新名稱。群組名稱最多可有 32 個字元，且包含英數字元和破折號。群組名稱區分大小寫。

1. 您可以保留現有群組的篩選條件表達式，或選擇性地輸入新的篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自服務 的故障追蹤`api.example.com`。 和 請求至回應時間大於或等於五秒的服務。

   ```
   service("api.example.com") { fault = true OR responsetime >= 5 }
   ```

1. 在**標籤**中，視需要編輯標籤索引鍵和值。標籤索引鍵必須是唯一的。標籤值是選用的；如果需要，您可以刪除值。若要刪除標籤，請選擇標籤列結尾的 **X**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。

1. 選擇**建立群組**。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 開啟 X-Ray 主控台。

1. 從左側導覽窗格開啟**群組**頁面，然後選擇您要複製的群組名稱。

1. 從**動作**功能表中選擇**複製群組**。

1. 在**建立群組**頁面上，群組的名稱為 *group-name*`-clone`。或者，輸入群組的新名稱。群組名稱最多可有 32 個字元，且包含英數字元和破折號。群組名稱區分大小寫。

1. 您可以保留現有群組的篩選條件表達式，或選擇性地輸入新的篩選條件表達式。如需如何建置篩選條件表達式的詳細資訊，請參閱 [使用篩選條件表達式](xray-console-filters.md)。在下列範例中， 群組會篩選來自服務 的故障追蹤`api.example.com`。 和 請求至回應時間大於或等於五秒的服務。

   ```
   service("api.example.com") { fault = true OR responsetime >= 5 }
   ```

1. 在**標籤**中，視需要編輯標籤索引鍵和值。標籤索引鍵必須是唯一的。標籤值是選用的；如果需要，您可以刪除值。若要刪除標籤，請選擇標籤列結尾的 **X**。如需標籤的詳細資訊，請參閱[標記 X-Ray 取樣規則和群組](xray-tagging.md)。

1. 選擇**建立群組**。

------

## 刪除群組
<a name="xray-console-group-delete"></a>

請依照本節中的步驟刪除群組。您無法刪除**預設**群組。

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中選擇**設定**。

1. 在 **X-Ray 追蹤**區段的**群組**下選擇**檢視設定**。

1. 從群組區段中選擇**群組**，然後選擇**刪除**。

1. 系統提示您確認時，請選擇**刪除**。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 開啟 X-Ray 主控台。

1. 從左側導覽窗格開啟**群組**頁面，然後選擇您要刪除的群組名稱。

1. 在**動作**功能表中，選擇**刪除群組**。

1. 當您收到確認提示時，請選擇**刪除**。

------

## 在 Amazon CloudWatch 中檢視群組指標
<a name="xray-console-group-cloudwatch"></a>

建立群組之後，系統會針對群組的篩選條件表達式檢查傳入的追蹤，因為這些追蹤存放在 X-Ray 服務中。符合每個條件的追蹤數量指標每分鐘都會發佈至 Amazon CloudWatch。在**編輯群組**頁面上選擇**檢視指標**會開啟 CloudWatch 主控台至**指標**頁面。如需如何使用 CloudWatch 指標的詳細資訊，請參閱《[Amazon CloudWatch 使用者指南》中的使用 Amazon CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)。 *Amazon CloudWatch * 

------
#### [ CloudWatch console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在左側導覽窗格中選擇**設定**。

1. 在 **X-Ray 追蹤**區段的**群組**下選擇**檢視設定**。

1. 從群組區段中選擇**群組**，然後選擇**編輯**。

1. 在**編輯群組**頁面上，選擇**檢視指標**。

   CloudWatch 主控台**指標**頁面會在新標籤中開啟。

------
#### [ X-Ray console ]

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) 開啟 X-Ray 主控台。

1. 從左側導覽窗格開啟**群組**頁面，然後選擇您要檢視指標的群組名稱。

1. 在**編輯群組**頁面上，選擇**檢視指標**。

   CloudWatch 主控台**指標**頁面會在新標籤中開啟。

------