アクティブなクエリをモニタリングする

このページでは、データベースでアクティブなクエリをモニタリングしてトラブルシューティングする方法について説明します。これらのクエリをモニタリングすることで、システムのレイテンシが発生している原因と CPU 使用率が高い原因を特定しやすくなります。

[Query Insights] ダッシュボードでは、アクティブなトランザクションの概要と、トランザクションのリスト（関連するクエリと統計情報を含む）を確認できます。トランザクションはその開始時刻順に表示されます。多数のクエリが実行されている場合、結果はクエリ全体のサブセットに制限される可能性があります。

始める前に

アクティブなクエリをモニタリングするには、Cloud SQL Enterprise エディションまたは Cloud SQL Enterprise Plus エディションのいずれかを使用します。

アクティブなクエリでセッションまたは長時間実行トランザクションを終了するには、Cloud SQL for PostgreSQL インスタンスに Cloud SQL Enterprise Plus エディションを使用する必要があります。

Cloud SQL のエディションの詳細については、Cloud SQL のエディションの概要をご覧ください。

必要なロールと権限

アクティブなクエリを表示するために必要な権限を取得するには、Cloud SQL インスタンスをホストするプロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

これらの事前定義ロールには、アクティブなクエリの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

アクティブなクエリを表示するには、次の権限が必要です。

  • データベース アクティビティの概要と長時間実行トランザクションを表示する
    • databaseinsights.activeQueries.fetch
    • databaseinsights.activitySummary.fetch

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

アクティブ クエリを有効にする

Cloud SQL Enterprise エディション インスタンスに対してアクティブなクエリを有効にするには、次の操作を行います。

  1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

    Cloud SQL の [インスタンス] に移動

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
  3. [構成] タイルで、[構成の編集] をクリックします。
  4. [インスタンスのカスタマイズ] で [Query Insights] を開きます。
  5. [Query Insights を有効にする] が有効になっていることを確認します。
  6. [アクティブ クエリ分析] を選択します。
  7. [保存] をクリックします。

Cloud SQL Enterprise Plus エディション インスタンスに対してアクティブなクエリを有効にするには、次の操作を行います。

  1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

    Cloud SQL の [インスタンス] に移動

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
  3. [構成] タイルで、[構成の編集] をクリックします。
  4. [インスタンスのカスタマイズ] で [Query Insights] を開きます。
  5. [Query Insights を有効にする] が有効になっていることを確認します。
  6. [Enterprise Plus の機能を有効にする] を選択します。
  7. [アクティブ クエリ分析] を選択します。
  8. [保存] をクリックします。

アクティブなクエリでセッションまたは長時間実行トランザクションを終了するには、Cloud SQL Enterprise Plus エディションの Query Insights を使用する必要があります。

アクティブ クエリを無効にする

Cloud SQL Enterprise エディションまたは Cloud SQL Enterprise Plus エディションのインスタンスでアクティブなクエリを無効にするには、次の操作を行います。

  1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

    Cloud SQL の [インスタンス] に移動

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
  3. [構成] タイルで、[構成の編集] をクリックします。
  4. [インスタンスのカスタマイズ] で [Query Insights] を開きます。
  5. [アクティブ クエリ分析] チェックボックスをオフにします。
  6. [保存] をクリックします。

アクティブ クエリを表示する

アクティブ クエリを表示するには、次の手順を実施します。

  1. Google Cloud コンソールで、Cloud SQL の [インスタンス] ページに移動します。

    Cloud SQL の [インスタンス] に移動

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。

  3. 次のいずれかを行うと、[Query Insights] ダッシュボードが表示されます。

    • [Query Insights] タブを選択する。
    • [クエリ分析情報に移動すると、クエリとパフォーマンスに関する詳細情報を確認できます] をクリックする。[Query Insights] ダッシュボードが開きます。インスタンスの詳細が上部に表示されます。

  4. [アクティブなクエリ] タブをクリックします。

    ここで、[最も実行時間の長いトランザクション] のテーブルに表示されるクエリ情報を変更できます。

    • データベース: 特定またはすべてのデータベースのクエリ負荷がフィルタされます。
    • ユーザー: 特定のユーザー アカウントからのクエリ負荷をフィルタリングします。

    • すべてのアクティブ クエリの概要スコアカード: 次のパラメータに基づいて接続の合計数が表示され、すべてのアクティブ クエリの概要が示されます。

      1. 接続状態別に分類されたアクティブな接続の分布。
      2. トランザクションの状態に基づくアクティブなトランザクションの分布。
      3. クエリの継続時間の分布。
    • 最も実行時間の長いトランザクション: 実行中の上位 50 件のクエリ（アクティブ状態とトランザクションのアイドル状態）の概要を、実行時間の長い順に表示します。表内のアクティブ クエリをフィルタして並べ替えることができます。

正規化されたアクティブ クエリを表示する

[Query Insights] ダッシュボードでは、正規化されたアクティブ クエリを使用して、実行時間の長さが上位のトランザクションのリストを確認できます。正規化されたアクティブ クエリは、センシティブ データを削除してダイジェストを返します。次の例では、使用する値は異なってもダイジェストは同じです。

  • 通常のクエリ

    • select * from test_table where id=1;
    • select * from test_table_where id=2;

  • ダイジェストまたは正規化されたクエリ

    • select * from test_table where id=?;

異なるセッションで実行されるクエリは、ダッシュボードに別々のエントリとして表示されます。

実行時間の長さが上位のトランザクションを表示する

[Query insights] ダッシュボードの [最も実行時間の長いトランザクション] のテーブルには、次の列があります。

列名 説明
プロセス ID 接続の固有識別子またはスレッド ID。
クエリ SQL クエリテキスト。
ステータス 接続のステータス。
セッション継続期間 最後に実行されたセッションの継続時間。
トランザクションの実行時間 アクティブなトランザクションの実行時間。
クエリの実行時間 そのトランザクションで最後に実行されたクエリの継続時間。
待機イベントタイプ 発生している待機イベントの待機イベントタイプ。
待機イベント 発生中の待機イベント。
データベース この接続が実行されているデータベースの名前。
アプリケーション名 この接続が実行されているアプリケーションの名前。
ユーザー名 データベースに接続しているユーザーの名前。
クライアント アドレス クエリを送信したクライアントの特定の IP アドレス。
アクション トランザクションを終了するためのリンクが含まれています。

表示内容は 60 秒ごとに自動的に更新されます。

プロセスを終了する

アクティブなクエリでプロセスまたは長時間実行トランザクションを終了するには、Cloud SQL Enterprise Plus エディションを使用して、[アクティブ クエリ分析] と Cloud SQL Enterprise Plus エディションの Query Insights の両方を有効にする必要があります。

長時間実行オペレーションの終了には時間がかかることがあります。

クエリまたはトランザクションを終了するには、次の手順を実施します。

  1. [最も実行時間の長いトランザクション] の表でクエリを選択します。
  2. [アクション] 列で [接続を終了] をクリックします。
  3. [接続を終了] ウィンドウで、[確認] をクリックします。

システムがクエリまたはトランザクションを正常に終了すると、成功メッセージが表示されます。システムは必要に応じて、ロールバックも実行します。

次のステップ