チュートリアル: 集計関数を使用してクエリを実行する

集約関数は、stats コマンドで使用できます。また、他の関数の引数としても使用できます。このチュートリアルでは、指定したフィールドを含むログイベントの数をカウントするクエリコマンドを実行します。このクエリコマンドは、指定したフィールドの値でグループ化された合計数を返します。集計関数の詳細については、「Amazon CloudWatch Logs ユーザーガイド」の「サポートされているオペレーションと関数」を参照してください。

集計関数を使用したクエリの実行方法

1. https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

2. ナビゲーションペインで、[Logs] (ログ)、[Logs Insights] (ログのインサイト) の順に選択します。

3. [Select log group] (ロググループの選択) ドロップダウンから、クエリを実行するロググループを 1 つ以上選択します。

   クロス CloudWatch アカウントオブザーバビリティのモニタリングアカウントの場合は、ソースアカウントとモニタリングアカウントのロググループを選択できます。1 つのクエリで複数のアカウントのログを一度にクエリできます。

   ロググループは、ロググループ名、アカウント ID、またはアカウントラベルでフィルタリングできます。

   ロググループを選択すると、 CloudWatch Logs Insights はグループ内のデータフィールドを自動的に検出します。検出されたフィールドを表示するには、ページの右上あたりにある [Fields] (フィールド) メニューを選択します。

4. クエリエディタでデフォルトのクエリを削除し、次のコマンドを入力します。

   stats count(*) by fieldName

5. fieldName を [Fields] (フィールド) メニューから検出されたフィールドに置換します。

   フィールドメニューはページの右上にあり、 CloudWatch Logs Insights がロググループで検出したすべての検出されたフィールドが表示されます。

6. [Run] (実行) を選択してクエリの結果を表示します。

   クエリの結果には、クエリコマンドに一致するロググループ内のレコード数と、指定したフィールドの値でグループ化された合計数が表示されます。