Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS. Pour en savoir plus, consultez Différences par rapport à Google Cloud.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer la capture des performances

MySQL | PostgreSQL | SQL Server

La capture des performances vous permet de diagnostiquer les problèmes temporaires de votre base de données en capturant des métriques détaillées pour votre instance lorsque les performances sont dégradées. Pour utiliser la capture des performances, activez-la pour votre instance et configurez les seuils qui déclenchent les instantanés détaillés basés sur les métriques de votre instance Cloud SQL.

Consignes pour configurer les déclencheurs de capture des performances

Tenez compte des consignes suivantes lorsque vous configurez des déclencheurs pour la capture des performances.

Les déclencheurs de capture des performances suivants sont désactivés par défaut :
- Une utilisation élevée du processeur
- Utilisation élevée de la mémoire
- Attentes de verrouillage des transactions
- Délais d'attente des sémaphores
- Longueur de la liste de l'historique
Si vous configurez un seuil pour l'un de ces déclencheurs, mais que vous souhaitez le désactiver par la suite, définissez la valeur du seuil sur 0.
Pour éviter les captures excessives, configurez les seuils de déclenchement en fonction des données de performances historiques.

Nous vous recommandons de définir vos seuils sur la partie supérieure de votre plage historique (par exemple, au-dessus de votre charge de travail quotidienne maximale habituelle).

Si un seuil est défini trop bas ou trop proche de votre charge de travail habituelle, l'agent peut déclencher des captures à plusieurs reprises. Cela peut entraîner :
- Coûts plus élevés et surcharge de journalisation : les journaux inutiles peuvent rapidement augmenter vos coûts Cloud Logging.
- Mode veille avec temps de latence étendu : si une instance dépasse le même seuil à plusieurs reprises, le mécanisme de latence adaptative se déclenche. La capture des performances est alors mise en mode veille de 24 heures, ce qui suspend tous les diagnostics et vérifications des déclencheurs. Vous risquez de perdre des données de diagnostic cruciales pendant ce mode veille si un événement critique réel se produit.

Avant de commencer

Effectuez les tâches suivantes avant de configurer la capture des performances.

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier une instance et activer la capture des performances, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

Administrateur Cloud SQL (roles/cloudsql.admin)
Lecteur Compute (roles/compute.viewer)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer la capture des performances

Vous pouvez activer la capture des performances lorsque vous créez votre instance Cloud SQL ou lorsque vous mettez à jour votre instance existante.

Pour activer la capture des performances, activez les insights sur les requêtes pour votre instance. Lorsque vous activez les insights sur les requêtes, votre instance utilise la configuration de base de la capture des performances et la valeur par défaut pour tous les déclencheurs basés sur des seuils. Les déclencheurs facultatifs basés sur des seuils sont désactivés.

Pour activer les insights sur les requêtes et la capture des performances sur une instance existante, procédez comme suit :

Dans la console Cloud de Confiance , accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Dans la section Personnaliser votre instance, cliquez sur Afficher les options de configuration.
Développez Insights sur les requêtes.
Cochez la case Activer Insights sur les requêtes.
Dans la section Activer des fonctionnalités supplémentaires, assurez-vous que la case Capture des performances est cochée.
Cliquez sur Enregistrer.

Configurer l'enregistrement des performances

Vous pouvez configurer la capture des performances, par exemple définir des seuils de déclenchement spécifiques, lorsque vous créez ou modifiez l'instance à l'aide de la gcloud CLI ou de l'API Cloud SQL Admin. La modification de la configuration de la capture des performances ou d'un seuil de déclenchement de la capture des performances n'entraîne pas le redémarrage de l'instance ni sa mise en maintenance.

La procédure suivante explique comment modifier une instance existante pour configurer la capture des performances.

gcloud

Pour configurer la capture des performances sur une instance Cloud SQL existante, exécutez la commande suivante :

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

Pour l'indicateur performance-capture-config, incluez enabled=true. Pour le même indicateur, vous pouvez spécifier des configurations facultatives pour PROBE_CONFIGURATION et pour PERFORMANCE_CAPTURE_THRESHOLDS.

Vous pouvez également utiliser la commande gcloud sql instances patch pour modifier les valeurs de configuration du seuil de capture des performances sur une instance existante.

Configurer l'intervalle de vérification et les vérifications consécutives des métriques de performances

Vous pouvez remplacer PROBE_CONFIGURATION par un ou plusieurs des paramètres d'option suivants. Si vous ne définissez pas les indicateurs, l'agent Monitoring utilise la valeur par défaut.

probing-interval-seconds=SECONDS : entier compris entre 20 et 86400. Intervalle de temps, en secondes, entre les vérifications des métriques. Par exemple, 30, 60, 100. La valeur par défaut est 30.
probe-threshold=PROBES : nombre de fois consécutives qu'un seuil doit être dépassé pour déclencher une capture des performances. La plage de valeurs valides est comprise entre 1 et 20. La valeur par défaut est 3.

Configurer les seuils de capture des performances

Vous pouvez remplacer PERFORMANCE_CAPTURE_THRESHOLDS par un ou plusieurs des paramètres d'option suivants. Si vous ne définissez pas de valeurs pour les indicateurs, l'agent de surveillance utilise les valeurs par défaut pour les seuils. Pour en savoir plus sur les déclencheurs définis par ces options, consultez Déclencheurs de capture des performances.

running-threads-threshold=THREADS : pour les instances principales ou répliquées, nombre minimal de threads actifs considérés comme dépassant le seuil. Exemple :10 La valeur doit être supérieure ou égale à 10. Si elle n'est pas définie, la valeur par défaut est basée sur la taille de l'instance. La valeur par défaut est MIN(600, cpuCount * 20).
seconds-behind-source-threshold=SECONDS : pour les instances répliquées avec accès en lecture, le délai de réplication minimal, en secondes, considéré comme supérieur au seuil. Doit être supérieur à 1. La valeur par défaut est 900.
transaction-duration-threshold=SECONDS : durée, en secondes, d'une transaction non validée avant que la transaction ne soit suivie et incluse dans un journal de capture des performances. Exemple :300 La valeur minimale est de 60. La valeur par défaut est 3600. Vous pouvez également mettre fin automatiquement aux transactions de longue durée.
cpu-utilization-threshold-percent=CPU_PERCENTAGE : pourcentage d'utilisation globale du processeur à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
memory-usage-threshold-percent=MEMORY_PERCENTAGE : pourcentage global d'utilisation de la mémoire à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
transaction-lock-wait-threshold-count=TRANSACTION_COUNT : seuil pour les transactions autorisées à être dans un état "LOCK WAIT". Exemple :50 La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
semaphore-wait-threshold-count=SEMAPHORE_THREAD_COUNT : seuil du nombre de threads en attente sur les sémaphores InnoDB à partir de la commande SHOW ENGINE INNODB STATUS. Par exemple, 20. La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
history-list-length-threshold-count=HISTORY_LIST_LENGTH_COUNT : seuil autorisé pour le nombre de la liste d'historique InnoDB (HLL) pour la base de données. Exemple :100000 La valeur minimale est 10000 et la valeur maximale est 10000000. La valeur par défaut est 0 (désactivée).

REST v1

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

Pour le champ performanceCaptureConfig, incluez les paramètres d'option suivants. Si vous ne définissez pas de valeurs pour les indicateurs, la capture des performances utilise les valeurs par défaut pour les seuils. Pour en savoir plus sur les déclencheurs définis par ces options, consultez Déclencheurs de capture des performances.

PERFORMANCE_CAPTURE_ENABLED : défini sur true pour activer la capture des performances pour votre instance.
PROBING_INTERVAL_SECONDS : entier compris entre 30 et 86400. Intervalle de temps, en secondes, entre les vérifications des métriques. La valeur par défaut est 30.
PROBE_THRESHOLD : nombre de fois consécutives qu'un seuil doit être dépassé pour déclencher une capture des performances. La plage de valeurs valides est comprise entre 1 et 20. La valeur par défaut est 3.
RUNNING_THREADS_THRESHOLD : pour les instances principales, nombre minimal de threads actifs considérés comme au-dessus du seuil. Exemple :10 La valeur doit être supérieure ou égale à 10. Si elle n'est pas définie, la valeur par défaut est basée sur la taille de l'instance. La valeur par défaut est MIN(600, cpuCount * 20).
SECONDS_BEHIND_SOURCE_THRESHOLD : pour les instances répliquées avec accès en lecture, le décalage de réplication minimal, en secondes, considéré comme supérieur au seuil. Doit être supérieur à 1. La valeur par défaut est 900.
TRANSACTION_DURATION_THRESHOLD : durée, en secondes, d'une transaction non validée avant que la transaction ne soit suivie et incluse dans un journal de capture des performances. Exemple :300 La valeur minimale est de 60. La valeur par défaut est 3600. Si vous souhaitez configurer l'arrêt automatique des transactions de longue durée, vous pouvez inclure des paramètres de configuration supplémentaires dans le champ performanceCaptureConfig. Pour en savoir plus, consultez Mettre fin automatiquement aux transactions de longue durée.
CPU_UTILIZATION_THRESHOLD_PERCENT : pourcentage d'utilisation globale du processeur à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
MEMORY_USAGE_THRESHOLD_PERCENT : pourcentage global d'utilisation de la mémoire à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT : seuil pour les transactions autorisées à être dans un état LOCK WAIT. Par exemple, 50. La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
SEMAPHORE_WAIT_THRESHOLD_COUNT : seuil du nombre de threads en attente sur les sémaphores InnoDB à partir de la commande SHOW ENGINE INNODB STATUS. Par exemple, 20. La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
HISTORY_LIST_LENGTH_THRESHOLD_COUNT : seuil autorisé pour le nombre de la liste d'historique InnoDB (HLL) pour la base de données. Exemple :100000 La valeur minimale est 10000 et la valeur maximale est 10000000. La valeur par défaut est 0 (désactivée).

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

Pour le champ performanceCaptureConfig, incluez les paramètres d'option suivants. Si vous ne définissez pas de valeurs pour les indicateurs, l'agent de surveillance utilise les valeurs par défaut pour les seuils. Pour en savoir plus sur les déclencheurs définis par ces options, consultez Déclencheurs de capture des performances.

PERFORMANCE_CAPTURE_ENABLED : défini sur true pour activer la capture des performances pour votre instance.
PROBING_INTERVAL_SECONDS : entier compris entre 30 et 86400. Intervalle de temps, en secondes, entre les vérifications des métriques. La valeur par défaut est 30.
PROBE_THRESHOLD : nombre de fois consécutives qu'un seuil doit être dépassé pour déclencher une capture des performances. La plage de valeurs valides est comprise entre 1 et 20. La valeur par défaut est 3.
RUNNING_THREADS_THRESHOLD : pour les instances principales, nombre minimal de threads actifs considérés comme au-dessus du seuil. Exemple : 10. La valeur doit être supérieure ou égale à 10. Si elle n'est pas définie, la valeur par défaut est basée sur la taille de l'instance. La valeur par défaut est MIN(600, cpuCount * 20).
SECONDS_BEHIND_SOURCE_THRESHOLD : pour les instances répliquées avec accès en lecture, le décalage de réplication minimal, en secondes, considéré comme supérieur au seuil. Doit être supérieur à 1. La valeur par défaut est 900.
TRANSACTION_DURATION_THRESHOLD : durée, en secondes, d'une transaction non validée avant que la transaction ne soit suivie et incluse dans un journal de capture des performances. Exemple :300 La valeur minimale est de 60. La valeur par défaut est 3600. Si vous souhaitez configurer l'arrêt automatique des transactions de longue durée, vous pouvez inclure des paramètres de configuration supplémentaires dans le champ performanceCaptureConfig. Pour en savoir plus, consultez Mettre fin automatiquement aux transactions de longue durée.
CPU_UTILIZATION_THRESHOLD_PERCENT : pourcentage d'utilisation globale du processeur à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
MEMORY_USAGE_THRESHOLD_PERCENT : pourcentage global d'utilisation de la mémoire à dépasser de manière constante. Exemple :90 La valeur minimale est 10 et la valeur maximale est 99. La valeur par défaut est 0 (désactivée).
TRANSACTION_LOCK_WAIT_THRESHOLD_COUNT : seuil pour les transactions qui peuvent être à l'état LOCK WAIT. Par exemple, 50. La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
SEMAPHORE_WAIT_THRESHOLD_COUNT : seuil du nombre de threads en attente sur les sémaphores InnoDB à partir de la commande SHOW ENGINE INNODB STATUS. Par exemple, 20. La valeur minimale est 10 et la valeur maximale est 10000. La valeur par défaut est 0 (désactivée).
HISTORY_LIST_LENGTH_THRESHOLD_COUNT : seuil autorisé pour le nombre de la liste d'historique InnoDB (HLL) pour la base de données. Exemple :100000 La valeur minimale est 10000 et la valeur maximale est 10000000. La valeur par défaut est 0 (désactivée).

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Mettre fin automatiquement aux transactions de longue durée

Vous pouvez utiliser la capture des performances pour mettre fin à toutes les transactions qui dépassent une durée prédéfinie. Cela peut vous aider à éviter les requêtes incontrôlables qui peuvent déstabiliser votre instance.

Pour configurer votre base de données Cloud SQL pour MySQL afin qu'elle mette fin automatiquement aux transactions de longue durée, utilisez la gcloud CLI ou l'API Cloud SQL Admin.

gcloud

Pour activer la fin automatique des transactions de longue durée, vous devez définir la limite de seuil pour les transactions. Pour configurer la fin automatique des transactions, exécutez la commande suivante :

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

Remplacez les éléments suivants :

INSTANCE_NAME : nom de l'instance.
SECONDS : limite de durée, en secondes, pour la fin automatique de la transaction de longue durée. Cette limite ne peut pas être inférieure à la valeur que vous avez définie pour le déclencheur transaction-duration-threshold ou transactionDurationThreshold.

Vous pouvez également spécifier le type de transactions à clôturer automatiquement (READ_ONLY_TRANSACTIONS par défaut) et personnaliser une liste d'utilisateurs ou d'hôtes de transactions spécifiques à exempter. Pour configurer ces options, exécutez la commande suivante :

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"

Remplacez les éléments suivants :

TRANSACTION_TYPE : détermine les catégories de transactions à clôturer. Spécifiez l'une des valeurs suivantes :
- READ_ONLY_TRANSACTIONS : met fin aux requêtes en lecture seule ou SELECT. Il s'agit de la valeur par défaut si transaction-kill-type n'est pas spécifié.
- ALL_TRANSACTIONS : met fin à toute requête en cours qui dépasse le seuil, y compris les requêtes avec des opérations d'écriture. Cela inclut INSERT, UPDATE, DELETE et d'autres instructions DDL.
EXCLUSION_LIST : liste de chaînes à exclure. Vous pouvez fournir les entrées à l'aide d'une combinaison spécifique de nom d'utilisateur et d'hôte de base de données, telle que user@host, ou en tant que nom de compte utilisateur de style MySQL, qui est défini par défaut sur user@%. La liste accepte les caractères génériques % et _ pour la mise en correspondance dans la partie hôte.

Par exemple, vous pouvez exécuter la commande suivante pour configurer l'arrêt automatique de _toutes les transactions_, y compris toutes les transactions de lecture et d'écriture, mais exclure des utilisateurs connus spécifiques de transactions de longue durée.

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

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

SECONDS : durée, en secondes, des transactions de longue durée à clôturer automatiquement. Cette limite ne peut pas être inférieure à la valeur que vous avez définie pour le champ transactionDurationThreshold.
TRANSACTION_TYPE : détermine les catégories de transactions à clôturer. Utilisez l'une des valeurs suivantes :
- READ_ONLY_TRANSACTIONS : met fin aux requêtes en lecture seule ou SELECT. Il s'agit de la valeur par défaut si transactionKillType n'est pas spécifié.
- ALL_TRANSACTIONS : met fin à toute requête en cours qui dépasse le seuil, y compris les requêtes avec des opérations d'écriture. Cela inclut INSERT, UPDATE, DELETE et d'autres instructions DDL.
EXCLUSION_LIST : liste de chaînes à exclure. Vous pouvez fournir les entrées à l'aide d'une combinaison spécifique de nom d'utilisateur et d'hôte de base de données, telle que user@host, ou en tant que nom de compte utilisateur de style MySQL, qui est défini par défaut sur user@%. La liste est compatible avec les caractères génériques % et _ pour la mise en correspondance dans la partie hôte.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

SECONDS : durée, en secondes, des transactions de longue durée à clôturer automatiquement. Cette limite ne peut pas être inférieure à la valeur que vous avez définie pour le champ transactionDurationThreshold.
TRANSACTION_TYPE : détermine les catégories de transactions à clôturer. Utilisez l'une des valeurs suivantes :
- READ_ONLY_TRANSACTIONS : met fin aux requêtes en lecture seule ou SELECT. Il s'agit de la valeur par défaut si transactionKillType n'est pas spécifié.
- ALL_TRANSACTIONS : met fin à toute requête en cours qui dépasse le seuil, y compris les requêtes avec des opérations d'écriture. Cela inclut INSERT, UPDATE, DELETE et d'autres instructions DDL.
EXCLUSION_LIST : liste de chaînes à exclure. Vous pouvez fournir les entrées à l'aide d'une combinaison spécifique de nom d'utilisateur et d'hôte de base de données, telle que user@host, ou en tant que nom de compte utilisateur de style MySQL, qui est défini par défaut sur user@%. La liste est compatible avec les caractères génériques % et _ pour la mise en correspondance dans la partie hôte.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Désactiver la capture des performances

Pour désactiver la capture des performances, procédez comme suit.

Console

Dans la console Cloud de Confiance , accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Modifier.
Dans la section Personnaliser votre instance, cliquez sur Afficher les options de configuration.
Développez Insights sur les requêtes.
Dans la section Activer des fonctionnalités supplémentaires, décochez la case Capture des performances.
Cliquez sur Enregistrer.

gcloud

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

Remplacez INSTANCE_NAME par le nom de l'instance sur laquelle vous souhaitez désactiver la capture des performances.

REST v1

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

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

Configurer la capture des performances

Consignes pour configurer les déclencheurs de capture des performances

Avant de commencer

Rôles requis

Activer la capture des performances

Configurer l'enregistrement des performances

gcloud

Configurer l'intervalle de vérification et les vérifications consécutives des métriques de performances

Configurer les seuils de capture des performances

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Mettre fin automatiquement aux transactions de longue durée

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Désactiver la capture des performances

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Étapes suivantes