Mengonfigurasi perekaman performa

Pengambilan performa memungkinkan Anda mendiagnosis masalah sementara pada database dengan mengambil metrik mendetail untuk instance saat performa menurun. Untuk menggunakan pengambilan performa, aktifkan pengambilan performa untuk instance Anda dan konfigurasi nilai minimum yang memicu snapshot berbasis metrik mendetail dari instance Cloud SQL Anda.

Panduan untuk mengonfigurasi pemicu pengambilan performa

Perhatikan panduan berikut saat Anda mengonfigurasi pemicu untuk pengambilan performa.

  • Pemicu perekaman performa berikut dinonaktifkan secara default:

    • Penggunaan CPU yang tinggi
    • Penggunaan memori yang tinggi
    • Penantian penguncian transaksi
    • Semaphore menunggu
    • Panjang daftar histori

    Jika Anda mengonfigurasi nilai minimum untuk salah satu pemicu ini, tetapi ingin menonaktifkan pemicu setelahnya, maka tetapkan nilai minimum ke 0.

  • Untuk membantu mencegah pengambilan berlebihan, konfigurasikan nilai minimum pemicu berdasarkan data performa historis.

    Sebaiknya tetapkan nilai minimum di ujung atas rentang historis Anda (misalnya, di atas beban kerja puncak harian normal Anda).

    Jika nilai minimum ditetapkan terlalu rendah atau terlalu dekat dengan beban kerja umum Anda, agen mungkin berulang kali memicu pengambilan data. Hal ini dapat menyebabkan:

    • Biaya yang lebih tinggi dan overhead logging: Log yang tidak perlu dapat dengan cepat meningkatkan biaya Cloud Logging Anda.
    • Mode tidur pendinginan yang diperpanjang: Jika instance berulang kali melanggar nilai minimum yang sama, mekanisme mundur pendinginan adaptif akan dipicu. Hal ini akan membuat pengambilan performa dalam mode tidur 24 jam, yang menangguhkan semua pemeriksaan pemicu dan diagnostik. Anda berisiko kehilangan data diagnostik penting selama mode tidur ini jika terjadi peristiwa penting yang sebenarnya.

Sebelum memulai

Selesaikan tugas berikut sebelum Anda mengonfigurasi pengambilan performa.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna mengubah instance dan mengaktifkan pengambilan performa, minta administrator untuk memberi Anda peran IAM berikut pada project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengaktifkan perekaman performa

Anda dapat mengaktifkan pengambilan performa saat membuat instance Cloud SQL atau saat memperbarui instance yang ada.

Untuk mengaktifkan pengambilan performa, aktifkan insight kueri untuk instance Anda. Saat Anda mengaktifkan insight kueri, instance Anda menggunakan konfigurasi dasar pengambilan performa dan nilai default untuk pemicu berbasis nilai minimum. Untuk pemicu berbasis nilai minimum opsional, pemicu dinonaktifkan.

Untuk mengaktifkan insight kueri dan pengambilan performa pada instance yang ada, lakukan hal berikut:

  1. Di Konsol Google Cloud , buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Di bagian Sesuaikan instance Anda, klik Tampilkan opsi konfigurasi.
  4. Perluas Query Insight.
  5. Centang kotak Aktifkan Query Insight.
  6. Di bagian Aktifkan fitur tambahan, pastikan kotak centang Perekaman performa dicentang.
  7. Klik Simpan.

Mengonfigurasi perekaman performa

Anda dapat mengonfigurasi pengambilan performa, seperti menentukan nilai minimum pemicu tertentu, saat membuat atau mengedit instance menggunakan gcloud CLI atau Cloud SQL Admin API. Memodifikasi konfigurasi pengambilan performa atau nilai minimum pemicu pengambilan performa tidak akan memulai ulang instance atau menyebabkan instance memasuki pemeliharaan.

Prosedur berikut menjelaskan cara mengedit instance yang ada untuk mengonfigurasi pengambilan performa.

gcloud

Untuk mengonfigurasi pengambilan performa pada instance Cloud SQL yang ada, jalankan perintah berikut:

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

Untuk flag performance-capture-config, sertakan enabled=true. Untuk flag yang sama, Anda dapat menentukan konfigurasi opsional untuk PROBE_CONFIGURATION dan untuk PERFORMANCE_CAPTURE_THRESHOLDS.

Anda juga dapat menggunakan perintah gcloud sql instances patch untuk mengubah nilai konfigurasi batas untuk pengambilan performa pada instance yang ada.

Mengonfigurasi interval pemeriksaan dan pemeriksaan berurutan metrik performa

Anda dapat mengganti PROBE_CONFIGURATION dengan satu atau kedua setelan flag berikut. Jika Anda tidak menyetel flag, agen pemantauan akan menggunakan nilai default.

  • probing-interval-seconds=SECONDS: bilangan bulat antara 20 dan 86400. Interval waktu, dalam detik, di antara pemeriksaan metrik. Misalnya, 30, 60, 100. Default-nya adalah 30.
  • probe-threshold=PROBES: jumlah waktu berturut-turut batas harus dilampaui untuk memicu perekaman performa. Rentang yang valid adalah 1 hingga 20. Default-nya adalah 3.

Mengonfigurasi nilai minimum pengambilan performa

Anda dapat mengganti PERFORMANCE_CAPTURE_THRESHOLDS dengan satu atau beberapa setelan tanda berikut. Jika Anda tidak menetapkan nilai untuk flag, agen pemantauan akan menggunakan nilai default untuk nilai minimum dan maksimum. Untuk mengetahui informasi yang lebih mendetail tentang pemicu yang ditetapkan oleh flag ini, lihat Pemicu pengambilan performa.

  • running-threads-threshold=THREADS: untuk instance primer atau replika, jumlah minimum thread aktif yang dianggap melebihi batas. Contoh, 10. Harus lebih besar dari atau sama dengan 10. Jika tidak disetel, nilai default akan didasarkan pada ukuran instance. Default-nya adalah MIN(600, cpuCount * 20).
  • seconds-behind-source-threshold=SECONDS : untuk replika baca, keterlambatan replikasi minimum, dalam detik, yang dianggap melebihi nilai minimum. Harus lebih besar dari 1. Jumlah defaultnya adalah 900
  • transaction-duration-threshold=SECONDS: durasi, dalam detik, transaksi yang belum di-commit sebelum transaksi dilacak dan disertakan dalam log perekaman performa. Contoh, 300. Nilai minimum adalah 60. Default-nya adalah 3600. Anda juga memiliki opsi untuk mengakhiri transaksi yang berjalan lama secara otomatis.
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: persentase penggunaan CPU keseluruhan yang harus dilampaui secara konsisten. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • memory-usage-threshold-percent=MEMORY_PERCENTAGE: persentase penggunaan memori secara keseluruhan yang terus-menerus melebihi batas. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • transaction-lock-wait-threshold-count=TRANSACTION_COUNT: nilai minimum untuk transaksi yang diizinkan berada dalam status `LOCK WAIT`. Contoh, 50. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: nilai minimum jumlah thread yang menunggu semafor InnoDB dari perintah SHOW ENGINE INNODB STATUS. Misalnya, 20. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: nilai minimum untuk jumlah Panjang Daftar Histori (HLL) InnoDB yang diizinkan untuk database. Contoh, 100000. Nilai minimum adalah 10000 dan nilai maksimum adalah 10000000. Default-nya adalah 0, yang dinonaktifkan.

REST v1

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

Untuk kolom performanceCaptureConfig, sertakan setelan tanda berikut. Jika Anda tidak menetapkan nilai untuk tanda, pengambilan performa akan menggunakan nilai default untuk nilai minimum. Untuk mengetahui informasi yang lebih mendetail tentang pemicu yang ditetapkan oleh tanda ini, lihat Pemicu perekaman performa.

  • PERFORMANCE_CAPTURE_ENABLED: setel ke true untuk mengaktifkan pengambilan data performa untuk instance Anda.
  • PROBING_INTERVAL_SECONDS: bilangan bulat antara 30 dan 86400. Interval waktu, dalam detik, antara pemeriksaan metrik. Default-nya adalah 30.
  • PROBE_THRESHOLD: jumlah waktu berturut-turut yang harus dilampaui oleh nilai minimum untuk memicu perekaman performa. Rentang yang valid adalah 1 hingga 20. Default-nya adalah 3.
  • RUNNING_THREADS_THRESHOLD: untuk instance utama, jumlah minimum thread aktif yang dianggap melebihi nilai minimum. Contoh, 10. Harus lebih besar dari atau sama dengan 10. Jika tidak disetel, nilai default akan didasarkan pada ukuran instance. Default-nya adalah MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: untuk replika baca, keterlambatan replikasi minimum, dalam detik, yang dianggap melebihi nilai minimum. Harus lebih besar dari 1. Jumlah defaultnya adalah 900
  • TRANSACTION_DURATION_THRESHOLD: durasi, dalam detik, transaksi yang belum di-commit sebelum transaksi dilacak dan disertakan dalam log perekaman performa. Contoh, 300. Nilai minimum adalah 60. Default-nya adalah 3600. Jika ingin mengonfigurasi pengakhiran otomatis transaksi yang berjalan lama, Anda dapat menyertakan setelan konfigurasi tambahan di kolom performanceCaptureConfig. Untuk mengetahui informasi selengkapnya, lihat Mengakhiri transaksi yang berjalan lama secara otomatis.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: persentase penggunaan CPU keseluruhan yang harus dilampaui secara konsisten. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • MEMORY_USAGE_THRESHOLD_PERCENT: persentase penggunaan memori secara keseluruhan yang terus-menerus melebihi batas. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: nilai minimum untuk transaksi yang diizinkan berada dalam status LOCK WAIT. status. Misalnya, 50. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: nilai minimum jumlah thread yang menunggu semafor InnoDB dari perintah SHOW ENGINE INNODB STATUS. Misalnya, 20. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: nilai minimum untuk jumlah Panjang Daftar Histori (HLL) InnoDB yang diizinkan untuk database. Contoh, 100000. Nilai minimum adalah 10000 dan nilai maksimum adalah 10000000. Default-nya adalah 0, yang dinonaktifkan.

Metode HTTP dan URL: 

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

Meminta isi 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
  },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

Untuk kolom performanceCaptureConfig, sertakan setelan tanda berikut. Jika Anda tidak menetapkan nilai untuk flag, agen pemantauan akan menggunakan nilai default untuk nilai minimum. Untuk mengetahui informasi yang lebih mendetail tentang pemicu yang ditetapkan oleh tanda ini, lihat Pemicu perekaman performa.

  • PERFORMANCE_CAPTURE_ENABLED: setel ke true untuk mengaktifkan pengambilan data performa untuk instance Anda.
  • PROBING_INTERVAL_SECONDS: bilangan bulat antara 30 dan 86400. Interval waktu, dalam detik, antara pemeriksaan metrik. Default-nya adalah 30.
  • PROBE_THRESHOLD: jumlah waktu berturut-turut yang harus dilampaui oleh nilai minimum untuk memicu perekaman performa. Rentang yang valid adalah 1 hingga 20. Default-nya adalah 3.
  • RUNNING_THREADS_THRESHOLD: untuk instance utama, jumlah minimum thread aktif yang dianggap melebihi nilai minimum. Misalnya, 10. Harus lebih besar dari atau sama dengan 10. Jika tidak disetel, nilai default akan didasarkan pada ukuran instance. Default-nya adalah MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: untuk replika baca, keterlambatan replikasi minimum, dalam detik, yang dianggap melebihi nilai minimum. Harus lebih besar dari 1. Jumlah defaultnya adalah 900
  • TRANSACTION_DURATION_THRESHOLD: durasi, dalam detik, transaksi yang belum di-commit sebelum transaksi dilacak dan disertakan dalam log perekaman performa. Contoh, 300. Nilai minimum adalah 60. Default-nya adalah 3600. Jika ingin mengonfigurasi pengakhiran otomatis transaksi yang berjalan lama, Anda dapat menyertakan setelan konfigurasi tambahan di kolom performanceCaptureConfig. Untuk mengetahui informasi selengkapnya, lihat Mengakhiri transaksi yang berjalan lama secara otomatis.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: persentase penggunaan CPU keseluruhan yang harus dilampaui secara konsisten. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • MEMORY_USAGE_THRESHOLD_PERCENT: persentase penggunaan memori secara keseluruhan yang terus-menerus melebihi batas. Contoh, 90. Nilai minimum adalah 10 dan nilai maksimum adalah 99. Default-nya adalah 0, yang dinonaktifkan.
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: nilai minimum untuk transaksi yang diizinkan berada dalam status LOCK WAIT. Misalnya, 50. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: nilai minimum jumlah thread yang menunggu semafor InnoDB dari perintah SHOW ENGINE INNODB STATUS. Misalnya, 20. Nilai minimum adalah 10 dan nilai maksimum adalah 10000. Default-nya adalah 0, yang dinonaktifkan.
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: nilai minimum untuk jumlah Panjang Daftar Histori (HLL) InnoDB yang diizinkan untuk database. Contoh, 100000. Nilai minimum adalah 10000 dan nilai maksimum adalah 10000000. Default-nya adalah 0, yang dinonaktifkan.

Metode HTTP dan URL: 

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

Meminta isi 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
  },
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Mengakhiri transaksi yang berjalan lama secara otomatis

Anda dapat menggunakan perekaman performa untuk mengakhiri transaksi yang melebihi durasi yang telah ditentukan sebelumnya, yang dapat membantu Anda mencegah kueri yang tidak terkendali yang dapat mengganggu stabilitas instance Anda.

Untuk mengonfigurasi database Cloud SQL untuk MySQL agar mengakhiri transaksi yang berjalan lama secara otomatis, gunakan gcloud CLI atau Cloud SQL Admin API.

gcloud

Untuk mengaktifkan pengakhiran otomatis transaksi yang berjalan lama, Anda menetapkan batas nilai minimum untuk transaksi. Untuk mengonfigurasi pengakhiran transaksi otomatis, jalankan perintah berikut:

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

Ganti kode berikut:

  • INSTANCE_NAME: nama instance.
  • SECONDS: batas durasi, dalam detik, kapan transaksi yang berjalan lama harus diakhiri secara otomatis. Batas ini tidak dapat disetel ke nilai yang lebih kecil dari nilai yang Anda tetapkan untuk pemicu transaction-duration-threshold atau transactionDurationThreshold.

Anda juga dapat menentukan jenis transaksi yang akan diakhiri secara otomatis (defaultnya adalah READ_ONLY_TRANSACTIONS) dan menyesuaikan daftar pengguna atau host transaksi tertentu yang akan dikecualikan. Untuk mengonfigurasi opsi ini, jalankan perintah berikut:

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"

Ganti kode berikut:

  • TRANSACTION_TYPE: menentukan kategori transaksi yang akan diakhiri. Tentukan salah satu nilai berikut:
    • READ_ONLY_TRANSACTIONS: hanya mengakhiri kueri hanya baca atau SELECT. Nilai ini merupakan default-nya jika transaction-kill-type tidak ditentukan.
    • ALL_TRANSACTIONS: mengakhiri kueri yang sedang berjalan yang melebihi nilai minimum, termasuk kueri dengan operasi tulis. Hal ini mencakup INSERT, UPDATE, DELETE, dan pernyataan DDL lainnya.
  • EXCLUSION_LIST: daftar string yang akan dikecualikan. Anda dapat memberikan entri menggunakan kombinasi nama pengguna dan host database tertentu, seperti user@host atau sebagai nama akun pengguna gaya MySQL, yang secara default adalah user@%. Daftar ini mendukung karakter pengganti % dan _ untuk pencocokan di bagian host.

Misalnya, Anda dapat menjalankan perintah berikut untuk mengonfigurasi pengakhiran _semua transaksi_ secara otomatis, termasuk semua transaksi baca dan tulis, tetapi mengecualikan pengguna tertentu yang diketahui memiliki transaksi yang berjalan lama.

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SECONDS: durasi, dalam detik, dari transaksi yang berjalan lama yang akan diakhiri secara otomatis. Batas ini tidak dapat ditetapkan ke nilai yang lebih kecil daripada nilai yang Anda tetapkan untuk kolom transactionDurationThreshold.
  • TRANSACTION_TYPE: menentukan kategori transaksi yang akan diakhiri. Gunakan salah satu nilai berikut:
    • READ_ONLY_TRANSACTIONS: hanya mengakhiri kueri hanya baca atau SELECT. Nilai ini merupakan default-nya jika transactionKillType tidak ditentukan.
    • ALL_TRANSACTIONS: mengakhiri kueri yang sedang berjalan yang melebihi nilai minimum, termasuk kueri dengan operasi tulis. Ini mencakup INSERT, UPDATE, DELETE, dan pernyataan DDL lainnya.
  • EXCLUSION_LIST: daftar string yang akan dikecualikan. Anda dapat memberikan entri menggunakan kombinasi nama pengguna dan host database tertentu, seperti user@host atau sebagai nama akun pengguna gaya MySQL, yang secara default adalah user@%. Daftar ini mendukung karakter pengganti % dan _ untuk pencocokan di bagian host.

Metode HTTP dan URL: 

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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • SECONDS: durasi, dalam detik, dari transaksi yang berjalan lama yang akan diakhiri secara otomatis. Batas ini tidak dapat ditetapkan ke nilai yang lebih kecil daripada nilai yang Anda tetapkan untuk kolom transactionDurationThreshold.
  • TRANSACTION_TYPE: menentukan kategori transaksi yang akan diakhiri. Gunakan salah satu nilai berikut:
    • READ_ONLY_TRANSACTIONS: hanya mengakhiri kueri hanya baca atau SELECT. Nilai ini merupakan default-nya jika transactionKillType tidak ditentukan.
    • ALL_TRANSACTIONS: mengakhiri kueri yang sedang berjalan yang melebihi nilai minimum, termasuk kueri dengan operasi tulis. Ini mencakup INSERT, UPDATE, DELETE, dan pernyataan DDL lainnya.
  • EXCLUSION_LIST: daftar string yang akan dikecualikan. Anda dapat memberikan entri menggunakan kombinasi nama pengguna dan host database tertentu, seperti user@host atau sebagai nama akun pengguna gaya MySQL, yang secara default adalah user@%. Daftar ini mendukung karakter pengganti % dan _ untuk pencocokan di bagian host.

Metode HTTP dan URL: 

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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Menonaktifkan perekaman performa

Untuk menonaktifkan pengambilan performa, lakukan hal berikut.

Konsol

  1. Di Konsol Google Cloud , buka halaman Instance Cloud SQL.

    Buka Instance Cloud SQL

  2. Untuk membuka halaman Ringkasan instance, klik nama instance.
  3. Klik Edit.
  4. Di bagian Sesuaikan instance Anda, klik Tampilkan opsi konfigurasi.
  5. Perluas Query Insight.
  6. Di bagian Aktifkan fitur tambahan, hapus centang pada kotak Perekaman performa.
  7. Klik Simpan.

gcloud

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

Ganti INSTANCE_NAME dengan nama instance tempat Anda ingin menonaktifkan pengambilan performa.

REST v1

Metode HTTP dan URL: 

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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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

Metode HTTP dan URL: 

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

Meminta isi JSON: 

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "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"
}

Langkah berikutnya