Leistungserfassung konfigurieren

Mit der Leistungserfassung können Sie vorübergehende Probleme mit Ihrer Datenbank diagnostizieren, indem Sie detaillierte Messwerte für Ihre Instanz erfassen, wenn die Leistung nachlässt. Wenn Sie die Leistungserfassung verwenden möchten, müssen Sie sie für Ihre Instanz aktivieren und die Grenzwerte konfigurieren, die die detaillierten, auf Messwerten basierenden Snapshots Ihrer Cloud SQL-Instanz auslösen.

Richtlinien zum Konfigurieren von Triggern für die Leistungserfassung

Beachten Sie beim Konfigurieren von Triggern für die Leistungserfassung die folgenden Richtlinien.

  • Die folgenden Leistungserfassungstrigger sind standardmäßig deaktiviert:

    • Hohe CPU-Auslastung
    • Hohe Arbeitsspeichernutzung
    • Wartezeiten für Transaktionssperren
    • Semaphor-Wartezeiten
    • Länge der Verlaufsliste

    Wenn Sie einen Schwellenwert für einen dieser Trigger konfigurieren, den Trigger aber später deaktivieren möchten, legen Sie den Schwellenwert auf 0 fest.

  • Um zu viele Aufnahmen zu vermeiden, sollten Sie die Trigger-Grenzwerte anhand von bisherigen Leistungsdaten konfigurieren.

    Wir empfehlen, die Grenzwerte im oberen Bereich Ihres bisherigen Bereichs festzulegen, z. B. über Ihrer normalen täglichen Spitzenarbeitslast.

    Wenn ein Schwellenwert zu niedrig oder zu nah an Ihrer typischen Arbeitslast festgelegt ist, löst der Agent möglicherweise wiederholt Erfassungen aus. Das kann zu Folgendem führen:

    • Höhere Kosten und Logging-Aufwand: Unnötige Logs können Ihre Cloud Logging-Kosten schnell in die Höhe treiben.
    • Erweiterter Ruhemodus: Wenn eine Instanz wiederholt gegen denselben Grenzwert verstößt, wird der adaptive Backoff-Mechanismus für den Ruhemodus ausgelöst. Dadurch wird die Leistungserfassung in einen 24-Stunden-Schlafmodus versetzt, in dem alle Triggerprüfungen und Diagnosen ausgesetzt werden. Wenn ein tatsächliches kritisches Ereignis eintritt, riskieren Sie, dass wichtige Diagnosedaten verloren gehen.

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie die Leistungserfassung konfigurieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Ändern einer Instanz und zum Aktivieren der Leistungserfassung haben:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Leistungserfassung aktivieren

Sie können die Leistungserfassung aktivieren, wenn Sie Ihre Cloud SQL-Instanz erstellen oder wenn Sie Ihre vorhandene Instanz aktualisieren.

Um die Leistungserfassung zu aktivieren, aktivieren Sie Query Insights für Ihre Instanz. Wenn Sie Abfrage-Insights aktivieren, verwendet Ihre Instanz die grundlegende Konfiguration der Leistungserfassung und den Standardwert für alle schwellenwertbasierten Trigger. Bei optionalen schwellenwertbasierten Triggern sind die Trigger deaktiviert.

So aktivieren Sie Query Insights und die Leistungserfassung für eine vorhandene Instanz:

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
  3. Klicken Sie im Abschnitt Instanz anpassen auf Konfigurationsoptionen einblenden.
  4. Maximieren Sie Query Insights.
  5. Klicken Sie das Kästchen Query Insights aktivieren an.
  6. Achten Sie darauf, dass im Abschnitt Zusätzliche Funktionen aktivieren das Kästchen Leistungserfassung angeklickt ist.
  7. Klicken Sie auf Speichern.

Leistungserfassung konfigurieren

Sie können die Leistungserfassung konfigurieren, z. B. bestimmte Trigger-Grenzwerte definieren, wenn Sie die Instanz mit der gcloud CLI oder der Cloud SQL Admin API erstellen oder bearbeiten. Wenn Sie die Konfiguration der Leistungserfassung oder einen Trigger-Schwellenwert für die Leistungserfassung ändern, wird die Instanz nicht neu gestartet und es wird auch keine Wartung der Instanz ausgelöst.

Im Folgenden wird beschrieben, wie Sie eine vorhandene Instanz bearbeiten, um die Leistungserfassung zu konfigurieren.

gcloud

Führen Sie den folgenden Befehl aus, um die Leistungserfassung für eine vorhandene Cloud SQL-Instanz zu konfigurieren:

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

Fügen Sie für das Flag performance-capture-config enabled=true ein. Für dasselbe Flag können Sie optionale Konfigurationen für PROBE_CONFIGURATION und für PERFORMANCE_CAPTURE_THRESHOLDS angeben.

Sie können auch den Befehl gcloud sql instances patch verwenden, um die Schwellenwertkonfigurationswerte für die Leistungserfassung in einer vorhandenen Instanz zu ändern.

Sondierungsintervall und aufeinanderfolgende Sondierungen von Leistungsmesswerten konfigurieren

Sie können PROBE_CONFIGURATION durch eine oder beide der folgenden Flageinstellungen ersetzen. Wenn Sie die Flags nicht festlegen, verwendet der Monitoring-Agent den Standardwert.

  • probing-interval-seconds=SECONDS: Eine Ganzzahl zwischen 20 und 86400. Das Zeitintervall zwischen Messwertprüfungen in Sekunden. Beispiel: 30, 60, 100. Der Standardwert ist 30.
  • probe-threshold=PROBES: Die Anzahl der aufeinanderfolgenden Male, die ein Grenzwert überschritten werden muss, um eine Leistungserfassung auszulösen. Der gültige Bereich liegt zwischen 1 und 20. Der Standardwert ist 3.

Grenzwerte für die Leistungserfassung konfigurieren

Sie können PERFORMANCE_CAPTURE_THRESHOLDS durch eine oder mehrere der folgenden Flageinstellungen ersetzen. Wenn Sie keine Werte für die Flags festlegen, verwendet der Monitoring-Agent die Standardwerte für die Grenzwerte. Weitere Informationen zu den durch diese Flags festgelegten Triggern finden Sie unter Trigger für die Leistungserfassung.

  • running-threads-threshold=THREADS: Für primäre oder Replikatinstanzen die Mindestanzahl aktiver Threads, die als über dem Schwellenwert liegend betrachtet werden. Beispiel: 10. Muss größer oder gleich 10 sein. Wenn nichts festgelegt ist, richtet sich der Standardwert nach der Größe der Instanz. Der Standardwert ist MIN(600, cpuCount * 20).
  • seconds-behind-source-threshold=SECONDS : Für Lesereplikate die minimale Replikationsverzögerung in Sekunden, die als Überschreitung des Schwellenwerts gilt. Muss größer als 1 sein. Der Standardwert ist 900.
  • transaction-duration-threshold=SECONDS: Die Dauer einer nicht committeten Transaktion in Sekunden, bevor die Transaktion erfasst und in ein Leistungsprotokoll aufgenommen wird. Beispiel: 300. Der Mindestwert ist 60. Der Standardwert ist 3600. Sie haben auch die Möglichkeit, lang laufende Transaktionen automatisch zu beenden.
  • cpu-utilization-threshold-percent=CPU_PERCENTAGE: Der Prozentsatz der gesamten CPU-Auslastung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • memory-usage-threshold-percent=MEMORY_PERCENTAGE: der Prozentsatz der gesamten Arbeitsspeichernutzung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • transaction-lock-wait-threshold-count=TRANSACTION_COUNT: Der Grenzwert für Transaktionen, die sich im Status „LOCK WAIT“ befinden dürfen. Beispiel: 50. Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT: Der Grenzwert für die Anzahl der Threads, die auf InnoDB-Semaphoren aus dem SHOW ENGINE INNODB STATUS-Befehl warten. Beispiel: 20 Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT: Der Grenzwert für die Anzahl der InnoDB-Verlaufsliste (History List Length, HLL), die für die Datenbank zulässig ist. Beispiel: 100000. Der Mindestwert ist 10000 und der Höchstwert ist 10000000. Der Standardwert ist 0 (deaktiviert).

REST Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

Fügen Sie für das Feld performanceCaptureConfig die folgenden Flageinstellungen hinzu. Wenn Sie keine Werte für die Flags festlegen, werden die Standardwerte für die Grenzwerte verwendet. Weitere Informationen zu den durch diese Flags festgelegten Triggern finden Sie unter Performance-Erfassungstrigger.

  • PERFORMANCE_CAPTURE_ENABLED: Auf true gesetzt, um die Leistungserfassung für Ihre Instanz zu aktivieren.
  • PROBING_INTERVAL_SECONDS: Eine Ganzzahl zwischen 30 und 86400. Das Zeitintervall in Sekunden zwischen den Messwertprüfungen. Der Standardwert ist 30.
  • PROBE_THRESHOLD: Die Anzahl der aufeinanderfolgenden Male, die ein Grenzwert überschritten werden muss, um eine Leistungserfassung auszulösen. Der gültige Bereich liegt zwischen 1 und 20. Der Standardwert ist 3.
  • RUNNING_THREADS_THRESHOLD: Für primäre Instanzen die Mindestanzahl aktiver Threads, die als über dem Schwellenwert liegend betrachtet werden. Beispiel: 10. Muss größer oder gleich 10 sein. Wenn nichts festgelegt ist, richtet sich der Standardwert nach der Größe der Instanz. Der Standardwert ist MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: Für Lesereplikate die minimale Replikationsverzögerung in Sekunden, die als Überschreitung des Schwellenwerts gilt. Muss größer als 1 sein. Der Standardwert ist 900.
  • TRANSACTION_DURATION_THRESHOLD: Die Dauer einer nicht committeten Transaktion in Sekunden, bevor die Transaktion erfasst und in ein Leistungsprotokoll aufgenommen wird. Beispiel: 300. Der Mindestwert ist 60. Der Standardwert ist 3600. Wenn Sie das automatische Beenden von lang andauernden Transaktionen konfigurieren möchten, können Sie dem Feld performanceCaptureConfig zusätzliche Konfigurationseinstellungen hinzufügen. Weitere Informationen finden Sie unter Lang andauernde Transaktionen automatisch beenden.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: Der Prozentsatz der gesamten CPU-Auslastung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • MEMORY_USAGE_THRESHOLD_PERCENT: der Prozentsatz der gesamten Arbeitsspeichernutzung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: Der Schwellenwert für Transaktionen, die sich im Status LOCK WAIT befinden dürfen. Beispiel: 50 Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: Der Grenzwert für die Anzahl der Threads, die auf InnoDB-Semaphoren aus dem SHOW ENGINE INNODB STATUS-Befehl warten. Beispiel: 20 Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: Der Grenzwert für die Anzahl der InnoDB-Verlaufsliste (History List Length, HLL), die für die Datenbank zulässig ist. Beispiel: 100000. Der Mindestwert ist 10000 und der Höchstwert ist 10000000. Der Standardwert ist 0 (deaktiviert).

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

Fügen Sie für das Feld performanceCaptureConfig die folgenden Flageinstellungen hinzu. Wenn Sie keine Werte für die Flags festlegen, verwendet der Monitoring-Agent die Standardwerte für die Grenzwerte. Weitere Informationen zu den durch diese Flags festgelegten Triggern finden Sie unter Performance-Erfassungstrigger.

  • PERFORMANCE_CAPTURE_ENABLED: Auf true gesetzt, um die Leistungserfassung für Ihre Instanz zu aktivieren.
  • PROBING_INTERVAL_SECONDS: Eine Ganzzahl zwischen 30 und 86400. Das Zeitintervall in Sekunden zwischen den Messwertprüfungen. Der Standardwert ist 30.
  • PROBE_THRESHOLD: Die Anzahl der aufeinanderfolgenden Male, die ein Grenzwert überschritten werden muss, um eine Leistungserfassung auszulösen. Der gültige Bereich liegt zwischen 1 und 20. Der Standardwert ist 3.
  • RUNNING_THREADS_THRESHOLD: Für primäre Instanzen die Mindestanzahl aktiver Threads, die als über dem Schwellenwert liegend betrachtet werden. Beispiel: 10. Muss größer oder gleich 10 sein. Wenn nichts festgelegt ist, richtet sich der Standardwert nach der Größe der Instanz. Der Standardwert ist MIN(600, cpuCount * 20).
  • SECONDS_BEHIND_SOURCE_THRESHOLD: Für Lesereplikate die minimale Replikationsverzögerung in Sekunden, die als Überschreitung des Schwellenwerts gilt. Muss größer als 1 sein. Der Standardwert ist 900.
  • TRANSACTION_DURATION_THRESHOLD: Die Dauer einer nicht committeten Transaktion in Sekunden, bevor die Transaktion erfasst und in ein Leistungsprotokoll aufgenommen wird. Beispiel: 300. Der Mindestwert ist 60. Der Standardwert ist 3600. Wenn Sie das automatische Beenden von lang andauernden Transaktionen konfigurieren möchten, können Sie dem Feld performanceCaptureConfig zusätzliche Konfigurationseinstellungen hinzufügen. Weitere Informationen finden Sie unter Lang andauernde Transaktionen automatisch beenden.
  • CPU_UTILIZATION_THRESHOLD_PERCENT: Der Prozentsatz der gesamten CPU-Auslastung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • MEMORY_USAGE_THRESHOLD_PERCENT: der Prozentsatz der gesamten Arbeitsspeichernutzung, der dauerhaft überschritten werden soll. Beispiel: 90. Der Mindestwert ist 10 und der Höchstwert ist 99. Der Standardwert ist 0 (deaktiviert).
  • TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT: Der Schwellenwert für Transaktionen, die sich im Status LOCK WAIT befinden dürfen. Beispiel: 50 Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • SEMAPHORE_WAIT_THRESHOLD_COUNT: Der Grenzwert für die Anzahl der Threads, die auf InnoDB-Semaphoren aus dem SHOW ENGINE INNODB STATUS-Befehl warten. Beispiel: 20 Der Mindestwert ist 10 und der Höchstwert ist 10000. Der Standardwert ist 0 (deaktiviert).
  • HISTORY_LIST_LENGTH_THRESHOLD_COUNT: Der Grenzwert für die Anzahl der InnoDB-Verlaufsliste (History List Length, HLL), die für die Datenbank zulässig ist. Beispiel: 100000. Der Mindestwert ist 10000 und der Höchstwert ist 10000000. Der Standardwert ist 0 (deaktiviert).

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Lang andauernde Transaktionen automatisch beenden

Mit der Leistungserfassung können Sie alle Transaktionen beenden, die eine vordefinierte Dauer überschreiten. So können Sie verhindern, dass Abfragen außer Kontrolle geraten und Ihre Instanz destabilisieren.

Wenn Sie Ihre Cloud SQL for MySQL-Datenbank so konfigurieren möchten, dass lang andauernde Transaktionen automatisch beendet werden, verwenden Sie die gcloud CLI oder die Cloud SQL Admin API.

gcloud

Wenn Sie die automatische Beendigung von lang andauernden Transaktionen aktivieren möchten, legen Sie das Schwellenwertlimit für Transaktionen fest. Führen Sie den folgenden Befehl aus, um das automatische Beenden von Transaktionen zu konfigurieren:

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name der Instanz.
  • SECONDS: Das Zeitlimit in Sekunden, nach dem die lang andauernde Transaktion automatisch beendet werden soll. Dieses Limit kann nicht auf einen Wert unter dem Wert festgelegt werden, den Sie für den transaction-duration-threshold- oder transactionDurationThreshold-Trigger festgelegt haben.

Sie können auch den Typ der Transaktionen angeben, die automatisch beendet werden sollen (Standardwert: READ_ONLY_TRANSACTIONS), und eine Liste mit bestimmten Transaktionsnutzern oder ‑hosts anpassen, die ausgenommen werden sollen. Führen Sie den folgenden Befehl aus, um diese Optionen zu konfigurieren:

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"

Ersetzen Sie Folgendes:

  • TRANSACTION_TYPE: bestimmt die Kategorien der zu beendenden Transaktionen. Geben Sie einen der folgenden Werte an:
    • READ_ONLY_TRANSACTIONS: Beendet nur schreibgeschützte oder SELECT-Abfragen. Das ist die Standardeinstellung, wenn transaction-kill-type nicht angegeben ist.
    • ALL_TRANSACTIONS: Beendet alle laufenden Abfragen, die den Grenzwert überschreiten, einschließlich Abfragen mit Schreibvorgängen. Dazu gehören INSERT-, UPDATE-, DELETE- und andere DDL-Anweisungen.
  • EXCLUSION_LIST: Eine Liste der auszuschließenden Strings. Sie können die Einträge mit einer bestimmten Kombination aus Datenbanknutzername und Host, z. B. user@host, oder als MySQL-Nutzerkontoname angeben, der standardmäßig auf user@% festgelegt ist. Die Liste unterstützt die Platzhalter % und _ für den Abgleich im Hostteil.

Mit dem folgenden Befehl können Sie beispielsweise das automatische Beenden _aller_ Transaktionen konfigurieren, einschließlich aller Lese- und Schreibtransaktionen, aber bestimmte bekannte Nutzer von lang laufenden Transaktionen ausschließen.

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 Version 1

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SECONDS: Die Dauer in Sekunden, nach der Vorgänge mit langer Ausführungszeit automatisch beendet werden sollen. Dieses Limit kann nicht auf einen Wert festgelegt werden, der niedriger ist als der Wert, den Sie für das Feld transactionDurationThreshold festgelegt haben.
  • TRANSACTION_TYPE: bestimmt die Kategorien der zu beendenden Transaktionen. Verwenden Sie einen der folgenden Werte:
    • READ_ONLY_TRANSACTIONS: Beendet nur schreibgeschützte oder SELECT-Abfragen. Das ist die Standardeinstellung, wenn transactionKillType nicht angegeben ist.
    • ALL_TRANSACTIONS: Beendet alle laufenden Abfragen, die den Grenzwert überschreiten, einschließlich Abfragen mit Schreibvorgängen. Dazu gehören INSERT, UPDATE, DELETE und andere DDL-Anweisungen.
  • EXCLUSION_LIST: Eine Liste der auszuschließenden Strings. Sie können die Einträge mit einer bestimmten Kombination aus Datenbanknutzername und Host, z. B. user@host, oder als MySQL-Nutzerkontoname angeben, der standardmäßig auf user@% festgelegt ist. Die Liste unterstützt die Platzhalter % und _ für den Abgleich im Hostteil.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

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

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SECONDS: Die Dauer in Sekunden, nach der Vorgänge mit langer Ausführungszeit automatisch beendet werden sollen. Dieses Limit kann nicht auf einen Wert festgelegt werden, der niedriger ist als der Wert, den Sie für das Feld transactionDurationThreshold festgelegt haben.
  • TRANSACTION_TYPE: bestimmt die Kategorien der zu beendenden Transaktionen. Verwenden Sie einen der folgenden Werte:
    • READ_ONLY_TRANSACTIONS: Beendet nur schreibgeschützte oder SELECT-Abfragen. Das ist die Standardeinstellung, wenn transactionKillType nicht angegeben ist.
    • ALL_TRANSACTIONS: Beendet alle laufenden Abfragen, die den Grenzwert überschreiten, einschließlich Abfragen mit Schreibvorgängen. Dazu gehören INSERT, UPDATE, DELETE und andere DDL-Anweisungen.
  • EXCLUSION_LIST: Eine Liste der auszuschließenden Strings. Sie können die Einträge mit einer bestimmten Kombination aus Datenbanknutzername und Host, z. B. user@host, oder als MySQL-Nutzerkontoname angeben, der standardmäßig auf user@% festgelegt ist. Die Liste unterstützt die Platzhalter % und _ für den Abgleich im Hostteil.

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Leistungserfassung deaktivieren

So deaktivieren Sie die Leistungserfassung:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

    Cloud SQL-Instanzen aufrufen

  2. Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
  3. Klicken Sie auf Bearbeiten.
  4. Klicken Sie im Abschnitt Instanz anpassen auf Konfigurationsoptionen einblenden.
  5. Maximieren Sie Query Insights.
  6. Entfernen Sie im Abschnitt Zusätzliche Funktionen aktivieren das Häkchen bei Leistungserfassung.
  7. Klicken Sie auf Speichern.

gcloud

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

Ersetzen Sie INSTANCE_NAME durch den Namen der Instanz, für die Sie die Leistungserfassung deaktivieren möchten.

REST Version 1

HTTP-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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-Methode und URL: 

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

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Nächste Schritte