パフォーマンス キャプチャを構成する

パフォーマンス キャプチャを使用すると、パフォーマンスが低下したときにインスタンスの詳細な指標をキャプチャして、データベースの一時的な問題を診断できます。パフォーマンス キャプチャを使用するには、インスタンスのパフォーマンス キャプチャを有効にして、Cloud SQL インスタンスの詳細な指標ベースのスナップショットをトリガーするしきい値を構成します。

パフォーマンス キャプチャ トリガーの構成に関するガイドライン

パフォーマンス キャプチャのトリガーを構成する際は、次のガイドラインに留意してください。

  • 次のパフォーマンス キャプチャ トリガーはデフォルトで無効になっています。

    • 高い CPU 使用率
    • メモリ使用量が多い
    • トランザクション ロックの待機
    • セマフォの待機
    • 履歴リストの長さ

    これらのトリガーのいずれかのしきい値を構成した後でトリガーを無効にする場合は、しきい値を 0 に設定します。

  • 過剰なキャプチャを防ぐには、過去のパフォーマンス データに基づいてトリガーしきい値を構成します。

    しきい値は、過去の範囲の上限に近い値（たとえば、通常の 1 日のピーク ワークロードを超える値）に設定することをおすすめします。

    しきい値が低すぎたり、通常のワークロードに近すぎたりすると、エージェントがキャプチャを繰り返しトリガーする可能性があります。これは次のような問題につながります。

    • 費用とロギングのオーバーヘッドの増加: 不要なログによって、Cloud Logging の費用が急増する可能性があります。
    • 拡張クールダウン スリープモード: インスタンスが同じしきい値を繰り返し違反すると、適応型クールダウン バックオフ メカニズムがトリガーされます。これにより、パフォーマンス キャプチャが 24 時間のスリープモードになり、すべてのトリガー チェックと診断が一時停止されます。このスリープモード中に重大なイベントが発生すると、重要な診断データが失われる可能性があります。

始める前に

パフォーマンス キャプチャを構成する前に、次のタスクを完了します。

必要なロール

インスタンスの変更とパフォーマンス キャプチャの有効化に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

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

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

パフォーマンス キャプチャを有効にする

パフォーマンス キャプチャは、Cloud SQL インスタンスの作成時または既存のインスタンスの更新時に有効にできます。

パフォーマンス キャプチャを有効にするには、インスタンスの Query Insights を有効にします。クエリ分析情報を有効にすると、インスタンスはパフォーマンス キャプチャの基本構成と、しきい値ベースのトリガーのデフォルト値を使用します。省略可能なしきい値ベースのトリガーの場合、トリガーは無効になります。

既存のインスタンスでクエリ分析情報とパフォーマンス キャプチャを有効にするには、次の操作を行います。

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

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

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
  3. [インスタンスのカスタマイズ] セクションで、[構成オプションを表示] をクリックします。
  4. [Query Insights] を開きます。
  5. [Query Insights を有効にする] チェックボックスを選択します。
  6. [追加機能を有効にする] セクションで、[パフォーマンス キャプチャ] チェックボックスがオンになっていることを確認します。
  7. [保存] をクリックします。

パフォーマンス キャプチャを構成する

gcloud CLI または Cloud SQL Admin API を使用してインスタンスを作成または編集するときに、特定のトリガーしきい値を定義するなど、パフォーマンス キャプチャを構成できます。パフォーマンス キャプチャの構成またはパフォーマンス キャプチャ トリガーのしきい値を変更しても、インスタンスが再起動されたり、インスタンスがメンテナンス モードになったりすることはありません。

次の手順では、既存のインスタンスを編集してパフォーマンス キャプチャを構成する方法について説明します。

gcloud

既存の Cloud SQL インスタンスでパフォーマンス キャプチャを構成するには、次のコマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=true,PROBE_CONFIGURATION,PERFORMANCE_CAPTURE_THRESHOLDS"

performance-capture-config フラグには enabled=true を含めます。同じフラグに対して、PROBE_CONFIGURATION と PERFORMANCE_CAPTURE_THRESHOLDS のオプション構成を指定できます。

gcloud sql instances patch コマンドを使用して、既存のインスタンスのパフォーマンス キャプチャのしきい値構成値を変更することもできます。

パフォーマンス指標のプローブ間隔と連続プローブを構成する

PROBE_CONFIGURATION は、次のいずれかまたは両方のフラグ設定に置き換えることができます。フラグを設定しない場合、モニタリング エージェントはデフォルト値を使用します。

  • probing-interval-seconds=SECONDS: 20～86400 の整数。指標プローブ間の時間間隔（秒単位）。例: 30、60、100。デフォルトは 30 です。
  • probe-threshold=PROBES: パフォーマンス キャプチャをトリガーするためにしきい値を超過する必要がある連続回数。有効な範囲は 1～20 です。デフォルトは 3 です。

パフォーマンス キャプチャのしきい値を構成する

PERFORMANCE_CAPTURE_THRESHOLDS は、次のフラグ設定の 1 つ以上に置き換えることができます。フラグの値を設定しない場合、モニタリング エージェントはしきい値のデフォルト値を使用します。これらのフラグで設定されるトリガーの詳細については、パフォーマンス キャプチャ トリガーをご覧ください。

  • running-threads-threshold=THREADS: プライマリ インスタンスまたはレプリカ インスタンスのいずれかについて、しきい値を超えていると見なされるアクティブ スレッドの最小数。例: 1010 以上の値でなければなりません。設定しない場合、デフォルトはインスタンスのサイズに基づきます。デフォルトは MIN(600, cpuCount * 20) です。
  • seconds-behind-source-threshold=SECONDS : リードレプリカの場合、しきい値を超えていると見なされる最小レプリケーション ラグ（秒単位）。1 より大きい値にする必要があります。デフォルトは 900 です。
  • transaction-duration-threshold=SECONDS: トランザクションが追跡され、パフォーマンス キャプチャ ログに含まれるまでの、未コミット トランザクションの期間（秒単位）。例: 300最小値は 60 です。デフォルトは 3600 です。長時間実行されているトランザクションを自動的に終了することもできます。
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: 一貫して超える全体的な CPU 使用率の割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • memory-usage-threshold-percent=MEMORY_PERCENTAGE: 一貫して超えるメモリ使用率の全体的な割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • transaction-lock-wait-threshold-count=TRANSACTION_COUNT: `LOCK WAIT` 状態にできるトランザクションのしきい値。例: 50最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: SHOW ENGINE INNODB STATUS コマンドから InnoDB セマフォで待機しているスレッド数のしきい値。例: 20。最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: データベースで許容される InnoDB 履歴リストの長さ（HLL）のカウントのしきい値。例: 100000最小値は 10000、最大値は 10000000 です。デフォルトは 0（無効）です。

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

performanceCaptureConfig フィールドには、次のフラグ設定を含めます。フラグの値を設定しない場合、パフォーマンス キャプチャではしきい値のデフォルト値が使用されます。これらのフラグで設定されるトリガーの詳細については、パフォーマンス キャプチャ トリガーをご覧ください。

  • PERFORMANCE_CAPTURE_ENABLED: インスタンスのパフォーマンス キャプチャを有効にするには、true に設定します。
  • PROBING_INTERVAL_SECONDS: 30～86400 の整数。指標プローブ間の時間間隔（秒単位）。デフォルトは 30 です。
  • PROBE_THRESHOLD: パフォーマンス キャプチャをトリガーするためにしきい値を超過する必要がある連続回数。有効な範囲は 1～20 です。デフォルトは 3 です。
  • RUNNING_THREADS_THRESHOLD: プライマリ インスタンスの場合、しきい値を超えていると見なされるアクティブ スレッドの最小数。例: 1010 以上の値でなければなりません。設定しない場合、デフォルトはインスタンスのサイズに基づきます。デフォルトは MIN(600, cpuCount * 20) です。
  • SECONDS_BEHIND_SOURCE_THRESHOLD: リードレプリカの場合、しきい値を超えていると見なされる最小レプリケーション ラグ（秒単位）。1 より大きい値を入力してください。デフォルトは 900 です。
  • TRANSACTION_DURATION_THRESHOLD: トランザクションが追跡され、パフォーマンス キャプチャ ログに含まれるまでの、未確定のトランザクションの期間（秒単位）。例: 300最小値は 60 です。デフォルトは 3600 です。長時間実行されるトランザクションの自動終了を構成する場合は、performanceCaptureConfig フィールドに追加の構成設定を含めることができます。詳細については、長時間実行トランザクションを自動的に終了するをご覧ください。
  • CPU_UTILIZATION_THRESHOLD_PERCENT: 一貫して超える全体的な CPU 使用率の割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • MEMORY_USAGE_THRESHOLD_PERCENT: 一貫して超えるメモリ使用率の全体的な割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: LOCK WAIT 状態にできるトランザクションのしきい値。例: 50。最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: SHOW ENGINE INNODB STATUS コマンドから InnoDB セマフォで待機しているスレッド数のしきい値。例: 20。最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: データベースで許容される InnoDB 履歴リストの長さ（HLL）のカウントのしきい値。例: 100000最小値は 10000、最大値は 10000000 です。デフォルトは 0（無効）です。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

performanceCaptureConfig フィールドには、次のフラグ設定を含めます。フラグの値を設定しない場合、モニタリング エージェントはしきい値のデフォルト値を使用します。これらのフラグで設定されるトリガーの詳細については、パフォーマンス キャプチャ トリガーをご覧ください。

  • PERFORMANCE_CAPTURE_ENABLED: インスタンスのパフォーマンス キャプチャを有効にするには、true に設定します。
  • PROBING_INTERVAL_SECONDS: 30～86400 の整数。指標プローブ間の時間間隔（秒単位）。デフォルトは 30 です。
  • PROBE_THRESHOLD: パフォーマンス キャプチャをトリガーするためにしきい値を超過する必要がある連続回数。有効な範囲は 1～20 です。デフォルトは 3 です。
  • RUNNING_THREADS_THRESHOLD: プライマリ インスタンスの場合、しきい値を超えていると見なされるアクティブ スレッドの最小数。例: 1010 以上の値でなければなりません。設定しない場合、デフォルトはインスタンスのサイズに基づきます。デフォルトは MIN(600, cpuCount * 20) です。
  • SECONDS_BEHIND_SOURCE_THRESHOLD: リードレプリカの場合、しきい値を超えていると見なされる最小レプリケーション ラグ（秒単位）。1 より大きい値を入力してください。デフォルトは 900 です。
  • TRANSACTION_DURATION_THRESHOLD: トランザクションが追跡され、パフォーマンス キャプチャ ログに含まれるまでの、未確定のトランザクションの期間（秒単位）。例: 300最小値は 60 です。デフォルトは 3600 です。長時間実行されるトランザクションの自動終了を構成する場合は、performanceCaptureConfig フィールドに追加の構成設定を含めることができます。詳細については、長時間実行トランザクションを自動的に終了するをご覧ください。
  • CPU_UTILIZATION_THRESHOLD_PERCENT: 一貫して超える全体的な CPU 使用率の割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • MEMORY_USAGE_THRESHOLD_PERCENT: 一貫して超えるメモリ使用率の全体的な割合。例: 90最小値は 10、最大値は 99 です。デフォルトは 0（無効）です。
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: LOCK WAIT 状態に移行できるトランザクションのしきい値。例: 50。最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: SHOW ENGINE INNODB STATUS コマンドから InnoDB セマフォで待機しているスレッド数のしきい値。例: 20。最小値は 10、最大値は 10000 です。デフォルトは 0（無効）です。
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: データベースで許容される InnoDB 履歴リストの長さ（HLL）のカウントのしきい値。例: 100000最小値は 10000、最大値は 10000000 です。デフォルトは 0（無効）です。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
     "enabled": PERFORMANCE_CAPTURE_ENABLED,
     "probingIntervalSeconds": PROBING_INTERVAL_SECONDS,
     "probeThreshold": PROBE_THRESHOLD,
     "runningThreadsThreshold": RUNNING_THREADS_THRESHOLD,
     "secondsBehindSourceThreshold": SECONDS_BEHIND_SOURCE_THRESHOLD,
     "transactionDurationThreshold": TRANSACTION_DURATION_THRESHOLD,
     "cpuUtilizationThresholdPercent": CPU_UTILIZATION_THRESHOLD_PERCENT,
     "memoryUsageThresholdPercent": MEMORY_USAGE_THRESHOLD_PERCENT,
     "transactionLockWaitThresholdCount": TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT,
     "semaphoreWaitThresholdCount": SEMAPHORE_WAIT_THRESHOLD_COUNT,
     "historyListLengthThresholdCount": HISTORY_LIST_LENGTH_THRESHOLD_COUNT
  },
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

長時間実行トランザクションを自動的に終了する

パフォーマンス キャプチャを使用すると、事前定義された期間を超えるトランザクションを終了できます。これにより、インスタンスを不安定にする可能性のある暴走クエリを防ぐことができます。

長時間実行トランザクションを自動的に終了するように Cloud SQL for MySQL データベースを構成するには、gcloud CLI または Cloud SQL Admin API を使用します。

gcloud

長時間実行されるトランザクションの自動終了を有効にするには、トランザクションのしきい値制限を設定します。トランザクションの自動終了を構成するには、次のコマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS"

次のように置き換えます。

  • INSTANCE_NAME: インスタンスの名前。
  • SECONDS: 長時間実行トランザクションを自動的に終了するまでの制限時間（秒単位）。この上限は、transaction-duration-threshold または transactionDurationThreshold トリガーに設定した値よりも小さい値に設定することはできません。

自動的に終了するトランザクションのタイプ（デフォルトは READ_ONLY_TRANSACTIONS）を指定したり、除外する特定のトランザクション ユーザーまたはホストのリストをカスタマイズしたりすることもできます。これらのオプションを構成するには、次のコマンドを実行します。

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="transaction-kill-threshold-seconds=SECONDS,transaction-kill-type=TRANSACTION_TYPE,transaction-kill-excluded-user-hosts=EXCLUSION_LIST"

次のように置き換えます。

  • TRANSACTION_TYPE: 終了するトランザクションのカテゴリを決定します。次のいずれかの値を指定します。
    • READ_ONLY_TRANSACTIONS: 読み取り専用クエリまたは SELECT クエリのみを終了します。transaction-kill-type が指定されていない場合、これがデフォルトです。
    • ALL_TRANSACTIONS: 書き込みオペレーションを含む、しきい値を超える実行中のクエリを終了します。これには、INSERT、UPDATE、DELETE、その他の DDL ステートメントが含まれます。
  • EXCLUSION_LIST: 除外する文字列のリスト。エントリは、特定のデータベース ユーザー名とホストの組み合わせ（user@host など）を使用して指定できます。また、MySQL スタイルのユーザー アカウント名（デフォルトは user@%）として指定することもできます。このリストでは、ホスト部分のマッチングにワイルドカード % と _ がサポートされています。

たとえば、次のコマンドを実行して、すべての読み取りトランザクションと書き込みトランザクションを含むすべてのトランザクションの自動終了を構成し、長時間実行トランザクションの特定の既知のユーザーを除外できます。

gcloud sql instances patch example-instance \
--performance-capture-config="transaction-kill-threshold-seconds=600,transaction-kill-type=ALL_TRANSACTIONS,transaction-kill-excluded-user-hosts=report_user@%;backup_user@localhost"

REST v1

リクエストのデータを使用する前に、次のように置き換えます。

  • SECONDS: 自動的に終了する長時間実行トランザクションの期間（秒単位）。この上限は、transactionDurationThreshold フィールドに設定した値よりも小さい値に設定することはできません。
  • TRANSACTION_TYPE: 終了するトランザクションのカテゴリを決定します。次のいずれかの値を使用します。
    • READ_ONLY_TRANSACTIONS: 読み取り専用クエリまたは SELECT クエリのみを終了します。transactionKillType が指定されていない場合、これがデフォルトです。
    • ALL_TRANSACTIONS: 書き込みオペレーションを含む、しきい値を超える実行中のクエリを終了します。これには、INSERT、UPDATE、DELETE、その他の DDL ステートメントが含まれます。
  • EXCLUSION_LIST: 除外する文字列のリスト。エントリは、user@host などの特定のデータベース ユーザー名とホストの組み合わせを使用して指定できます。また、MySQL スタイルのユーザー アカウント名（デフォルトは user@%）として指定することもできます。このリストでは、ホスト部分のマッチングにワイルドカード % と _ がサポートされています。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

リクエストのデータを使用する前に、次のように置き換えます。

  • SECONDS: 自動的に終了する長時間実行トランザクションの期間（秒単位）。この上限は、transactionDurationThreshold フィールドに設定した値よりも小さい値に設定することはできません。
  • TRANSACTION_TYPE: 終了するトランザクションのカテゴリを決定します。次のいずれかの値を使用します。
    • READ_ONLY_TRANSACTIONS: 読み取り専用クエリまたは SELECT クエリのみを終了します。transactionKillType が指定されていない場合、これがデフォルトです。
    • ALL_TRANSACTIONS: 書き込みオペレーションを含む、しきい値を超える実行中のクエリを終了します。これには、INSERT、UPDATE、DELETE、その他の DDL ステートメントが含まれます。
  • EXCLUSION_LIST: 除外する文字列のリスト。エントリは、user@host などの特定のデータベース ユーザー名とホストの組み合わせを使用して指定できます。また、MySQL スタイルのユーザー アカウント名（デフォルトは user@%）として指定することもできます。このリストでは、ホスト部分のマッチングにワイルドカード % と _ がサポートされています。

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
    "transactionKillThresholdSeconds": SECONDS,
    "transactionKillType": TRANSACTION_TYPE,
    "transactionKillExcludedUserHosts": [ EXCLUSION_LIST
    ]
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

パフォーマンス キャプチャを無効にする

パフォーマンス キャプチャを無効にするには、次の操作を行います。

コンソール

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

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

  2. インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
  3. [編集] をクリックします。
  4. [インスタンスのカスタマイズ] セクションで、[構成オプションを表示] をクリックします。
  5. [Query Insights] を開きます。
  6. [追加機能を有効にする] セクションで、[パフォーマンス キャプチャ] チェックボックスをオフにします。
  7. [保存] をクリックします。

gcloud

gcloud sql instances patch INSTANCE_NAME \
  --performance-capture-config="enabled=false"

INSTANCE_NAME は、パフォーマンス キャプチャを無効にするインスタンスの名前に置き換えます。

REST v1

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "INSERT_TIME",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

HTTP メソッドと URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

リクエストの本文（JSON）: 

{
  "performanceCaptureConfig": {
     "enabled": false
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-11-10T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

次のステップ