グループを作成するグループを適用します　グループを編集しますグループのクローンを作成しますグループの削除 Amazon でグループメトリクスを表示する CloudWatch

グループの設定

グループは、フィルタ式で定義されるトレースのコレクションです。グループを使用して、追加のサービスグラフを生成し、Amazon CloudWatch メトリクスを提供できます。 AWS X-Ray コンソールまたは X-Ray API を使用して、サービスのグループを作成して管理できます。このトピックでは、X-Ray コンソールを使用してグループを作成および管理する方法について説明します。X-Ray API を使用してグループを管理する方法については、グループを参照してください。

トレースマップ、トレース、または分析用のトレースのグループを作成できます。グループを作成すると、そのグループは、トレースマップ、トレース 、分析の 3 ページすべてでグループドロップダウンメニューのフィルターとして利用可能になります。

グループは名前または Amazon リソースネーム (ARN) で識別され、フィルタ式を含みます。サービスは着信トレースを式と比較し、それに応じてそれらを保管します。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。

グループのフィルタ式を更新しても、すでに記録されているデータは変わりません。更新は後続のトレースにのみ適用されます。これにより、新しい式と古い式がマージされたグラフが表示される場合があります。これを回避するには、現在のグループを削除し、新しいグループを作成します。

注記

グループは、フィルタ式と一致する取得済みのトレースの数で請求されます。詳細については、AWS X-Ray の料金を参照してください。

グループを作成する

注記

Amazon CloudWatch コンソール内から X-Ray グループを設定できるようになりました。X-Ray コンソールを引き続き使用することもできます。

CloudWatch console

にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。
左側のナビゲーションペインの [Settings] (設定) を選択します。
[X-Ray トレース] セクションの [グループ] の下にある [設定の表示] を選択します。
グループのリストの上にある [グループを作成] を選択します。
[Create group] (グループの作成) ページで、グループの名前を入力します。グループ名は最大 32 文字で、英数字とダッシュを使用できます。グループ名では大文字と小文字が区別されます。
フィルター式を入力します。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、グループによってサービスapi.example.com からの障害トレースと応答時間が 5 秒以上であったサービスへのリクエストがフィルタリングされます。
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
[Insights] ( インサイト )で、グループのインサイトアクセスを有効または無効にします。インサイトの詳細については、「X-Ray インサイトの使用」を参照してください。
[タグ] で [新しいタグを追加] を選択してタグキーを入力し、オプションでタグ値を入力します。必要に応じて、続けてタグを追加します。タグキーは一意である必要があります。タグを削除するには、タグの下にある [削除] を選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
[グループを作成] を選択します。

X-Ray console

にサインイン AWS Management Console し、https://console.aws.amazon.com/xray/home で X-Ray コンソールを開きます。
左側のナビゲーションペインのグループページ、またはトレースマップ、トレース 、分析のいずれかのページのグループメニューから、グループの作成ページを開きます。
[Create group] (グループの作成) ページで、グループの名前を入力します。グループ名は最大 32 文字で、英数字とダッシュを使用できます。グループ名では大文字と小文字が区別されます。
フィルター式を入力します。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、グループによってサービスapi.example.com からの障害トレースと応答時間が 5 秒以上であったサービスへのリクエストがフィルタリングされます。
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
[Insights] ( インサイト )で、グループのインサイトアクセスを有効または無効にします。インサイトの詳細については、「X-Ray インサイトの使用」を参照してください。
[Tags] ( タグ ) で、タグキー、および必要に応じてタグ値を入力します。タグを追加すると、別のタグを入力するための新しい行が表示されます。タグキーは一意である必要があります。タグを削除するには、タグの行の最後にあるX を選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
[グループを作成] を選択します。

グループを適用します　

グループを編集します

CloudWatch console

にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。
左側のナビゲーションペインの [Settings] (設定) を選択します。
[X-Ray トレース] セクションの [グループ] の下にある [設定を表示] を選択します。
[グループ] セクションからグループを選択し、[編集] を選択します。
グループの名前を変更することはできませんが、フィルター式を更新することはできます。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、リクエストのURLアドレスにexample/game が含まれ、リクエストの応答時間が5秒以上であるサービス api.example.com からの障害トレースを、グループでフィルタリングしています。
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
[Insights] ( インサイト )で、グループのインサイトアクセスを有効または無効にします。インサイトの詳細については、「X-Ray インサイトの使用」を参照してください。
[タグ] で [新しいタグを追加] を選択してタグキーを入力し、オプションでタグ値を入力します。必要に応じて、続けてタグを追加します。タグキーは一意である必要があります。タグを削除するには、タグの下にある [削除] を選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
グループの更新が完了したら、[グループの更新] を選択します。

X-Ray console

にサインイン AWS Management Console し、https://console.aws.amazon.com/xray/home で X-Ray コンソールを開きます。
次のいずれかを実行して [Edit group] (グループの編集ページ) を開きます。
1. [Groups] (グループ) ページで、グループ名を選択して編集します。
2. 次のいずれかのページのグループメニューで、グループを挙げて、[Edit] (編集) を選びます。
  - トレースマップ
  - トレース
  - 分析
グループの名前を変更することはできませんが、フィルター式を更新することはできます。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、リクエストのURLアドレスにexample/game が含まれ、リクエストの応答時間が5秒以上であるサービス api.example.com からの障害トレースを、グループでフィルタリングしています。
```
fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5
```
Insights ( インサイト )では、グループのインサイトおよびインサイト通知を有効または無効にします。インサイトの詳細については、「X-Ray インサイトの使用」を参照してください。
[Tags] (タグ) で、タグキーと値を編集します。タグキーは一意である必要があります。タグ値は任意であり、必要であれば値を削除できます。タグを削除するには、タグの行の最後にあるXを選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
グループの更新が完了したら、[グループの更新] を選択します。

グループのクローンを作成します

グループを複製すると、既存のグループのフィルター式とタグを持つ新しいグループが作成されます。グループのクローンを作成すると、新しいグループの名前はクローンの元のグループの名前に-clone 付加された名前になります。

CloudWatch console

にサインイン AWS Management Console し、https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。
左側のナビゲーションペインの [Settings] (設定) を選択します。
[X-Ray トレース] セクションの [グループ] の下にある [設定を表示] を選択します。
[グループ] セクションからグループを選択し、[クローン] を選択します。
[Create group] (グループを作成する)ページで、グループの名前は[group-name] (グループ名) -clone。必要に応じて、グループの新しい名前を入力します。グループ名は最大 32 文字で、英数字とダッシュを使用できます。グループ名では大文字と小文字が区別されます。
フィルター式を既存のグループから保持するか、オプションで新しいフィルター式を入力できます。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、グループによってサービス api.example.com からの障害トレースと応答時間が 5 秒以上であったサービスへのリクエストがフィルタリングされます。
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
[Tags] (タグ) で、必要に応じてタグのキーと値を編集します。タグキーは一意である必要があります。タグ値は任意であり、必要に応じて値を削除できます。タグを削除するには、タグの行の最後にある[X] を選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
[グループを作成] を選択します。

X-Ray console

にサインイン AWS Management Console し、https://console.aws.amazon.com/xray/home で X-Ray コンソールを開きます。
左側のナビゲーションペインから [グループ] ページを開き、クローンを作成するグループの名前を選択します。
[アクション] メニューから、[グループのクローン作成] を選択します。
[Create group] (グループを作成する)ページで、グループの名前は[group-name] (グループ名) -clone。必要に応じて、グループの新しい名前を入力します。グループ名は最大 32 文字で、英数字とダッシュを使用できます。グループ名では大文字と小文字が区別されます。
フィルター式を既存のグループから保持するか、オプションで新しいフィルター式を入力できます。フィルター式の作成方法の詳細については、フィルター式の使用を参照してください。次の例では、グループによってサービス api.example.com からの障害トレースと応答時間が 5 秒以上であったサービスへのリクエストがフィルタリングされます。
```
service("api.example.com") { fault = true OR responsetime >= 5 }
```
[Tags] (タグ) で、必要に応じてタグのキーと値を編集します。タグキーは一意である必要があります。タグ値は任意であり、必要に応じて値を削除できます。タグを削除するには、タグの行の最後にある[X] を選択します。タグの詳細については、X-Ray のサンプリングルールとグループのタグ付けを参照してください。
[グループを作成] を選択します。

グループの削除

グループを削除するには、このセクションの手順に従います。[Default] (デフォルト) グループを削除することはできません。

Amazon でグループメトリクスを表示する CloudWatch

グループの作成後、着信トレースは、X-Ray サービスに格納されるときにグループのフィルター式と照合されます。各基準に一致するトレース数のメトリクスは、1 分 CloudWatch ごとに Amazon に発行されます。グループの編集ページでメトリクスの表示を選択すると、 CloudWatchコンソールがメトリクスページを開きます。 CloudWatch メトリクスの使用方法の詳細については、「Amazon CloudWatch ユーザーガイド」の「Amazon メトリクスの使用 CloudWatch 」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

分析

サンプリング