Esta página foi traduzida pela API Cloud Translation.

Configure o agente para cargas de trabalho do MySQL

Este documento mostra como instalar o agente para cargas de trabalho do Compute numa instância do Compute Engine e configurar o agente para se ligar a uma carga de trabalho do MySQL em execução nessa instância de computação.

Antes de começar

Antes de instalar e configurar o agente para cargas de trabalho de computação, tem de se certificar de que os seguintes pré-requisitos são cumpridos:

Implementou uma carga de trabalho do MySQL numa instância de computação.
Concedeu as funções do IAM necessárias à conta de serviço anexada à instância de computação.
Ativou o acesso às APIs Cloud.

Funções de IAM necessárias

O agente para cargas de trabalho de computação usa a conta de serviço anexada à instância de computação para autenticação e para aceder a Google Cloud recursos.

Para melhorar a segurança, recomendamos que use uma conta de serviço de finalidade única em vez de usar a conta de serviço predefinida do Compute Engine.

Para garantir que a conta de serviço tem as autorizações necessárias para permitir que o agente para cargas de trabalho do Compute se autentique com os recursosGoogle Cloud e aceda aos mesmos Google Cloud , peça ao seu administrador para conceder à conta de serviço as seguintes funções do IAM no seu projeto:

Compute Viewer (roles/compute.viewer): para recolher métricas da instância de computação.
Workload Manager Insights Writer (roles/workloadmanager.insightWriter): para escrever dados no data warehouse do Workload Manager.
(Recomendado) Escritor de registos (roles/logging.logWriter): para enviar registos do agente para o Cloud Logging.
(Opcional) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor): se estiver a usar o Secret Manager para armazenar a palavra-passe para estabelecer ligação à instância do MySQL.

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

O seu administrador também pode conceder à conta de serviço as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Ative o acesso às APIs Cloud

O Compute Engine recomenda que configure as suas instâncias para permitir todos os âmbitos de acesso a todas as APIs Google Cloud e usar apenas as autorizações do IAM da conta de serviço da instância para controlar o acesso aos recursos doGoogle Cloud . Para mais informações, consulte o artigo Crie uma VM que use uma conta de serviço gerida pelo utilizador.

Se limitar o acesso às APIs Cloud, o agente para cargas de trabalho de computação requer, no mínimo, os seguintes âmbitos de acesso às APIs Cloud na instância de computação do anfitrião:

https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte o artigo Práticas recomendadas de âmbitos.

Se estiver a executar aplicações MySQL numa instância de computação que não tenha um endereço IP externo, tem de ativar o acesso privado à Google na sub-rede da instância para que o agente para cargas de trabalho de computação possa aceder às APIs e aos serviços Google. Para obter informações sobre como ativar o acesso privado à Google, consulte o artigo Configure o acesso privado à Google.

Instale e configure o agente

Para instalar o agente para cargas de trabalho de computação na sua instância de computação e configurá-lo para estabelecer ligação a uma instância do MySQL, conclua os seguintes passos:

RHEL

No Red Hat Enterprise Linux (RHEL), instala o agente para cargas de trabalho de computação com o comando de gestão de pacotes yum. Este comando conclui as seguintes tarefas:

Transfere a versão mais recente do agente.
Cria um serviço systemd para o agente com o nome google-cloud-workload-agent.
Ativa e inicia o serviço google-cloud-workload-agent.

Para instalar e configurar o agente para cargas de trabalho de computação numa instância de computação baseada no RHEL, conclua os seguintes passos:

Estabeleça uma ligação SSH com a sua instância de computação.

No terminal, instale o agente:

sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Agent for Compute Workloads
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-workload-agent

Abra o ficheiro de configuração do agente:

/etc/google-cloud-workload-agent/configuration.json

Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.
Guarde o ficheiro de configuração
Reinicie o agente para que as alterações entrem em vigor.

SLES

No SUSE Linux Enterprise Server (SLES), instala o agente para cargas de trabalho de computação com o comando de gestão de pacotes zypper. Este comando conclui as seguintes tarefas:

Transfere a versão mais recente do agente.
Cria um serviço systemd para o agente com o nome google-cloud-workload-agent.
Ativa e inicia o serviço google-cloud-workload-agent.

Para instalar e configurar o agente para cargas de trabalho de computação numa instância de computação baseada no SLES, conclua os seguintes passos:

Estabeleça uma ligação SSH com a sua instância de computação.

No terminal, instale o agente:

sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
google-cloud-workload-agent
sudo zypper install google-cloud-workload-agent

Abra o ficheiro de configuração do agente:

/etc/google-cloud-workload-agent/configuration.json

Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.
Guarde o ficheiro de configuração
Reinicie o agente para que as alterações entrem em vigor.

Debian

No Debian, instala o agente para cargas de trabalho de computação através do comando de gestão de pacotes.apt Este comando conclui as seguintes tarefas:

Transfere a versão mais recente do agente.
Cria um serviço systemd para o agente com o nome google-cloud-workload-agent.
Ativa e inicia o serviço google-cloud-workload-agent.

Para instalar e configurar o agente para cargas de trabalho de computação numa instância de computação baseada no Debian, conclua os seguintes passos:

Estabeleça uma ligação SSH com a sua instância de computação.

No terminal, instale o agente:

echo 'deb https://packages.cloud.google.com/apt google-cloud-workload-agent-x86-64-apt main' | sudo tee -a /etc/apt/sources.list.d/google-cloud-workload-agent.list
sudo apt-get update
sudo apt-get install google-cloud-workload-agent

Abra o ficheiro de configuração do agente:

/etc/google-cloud-workload-agent/configuration.json

Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.
Guarde o ficheiro de configuração
Reinicie o agente para que as alterações entrem em vigor.

Windows

No Windows, instala o agente para cargas de trabalho de computação através do comando de gestão de pacotes googet. Este comando conclui as seguintes tarefas:

Transfere a versão mais recente do agente.
Cria um serviço do Windows com o nome google-cloud-workload-agent.
Cria uma tarefa agendada que é executada a cada minuto para verificar se o serviço está a ser executado e, se necessário, reinicia o serviço.

google-cloud-workload-agent

Para instalar e configurar o agente para cargas de trabalho de computação numa instância de computação baseada no Windows, conclua os seguintes passos:

Estabeleça uma ligação com a sua instância de computação através do RDP.

Para obter informações sobre como o fazer, consulte o artigo Estabeleça ligação a VMs do Windows através do RDP.

Como administrador, execute os seguintes comandos a partir do PowerShell:

googet addrepo google-cloud-workload-agent  https://packages.cloud.google.com/yuck/repos/google-cloud-workload-agent-windows-x86_64
googet install google-cloud-workload-agent

Abra o ficheiro de configuração do agente:

%ProgramFiles%\Google\google-cloud-workload-agent\conf\configuration.json

Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.
Guarde o ficheiro de configuração
Reinicie o agente para que as alterações entrem em vigor.

Valide a instalação do agente

Para verificar se o agente está a ser executado conforme esperado, conclua os seguintes passos:

RHEL

Estabeleça uma ligação SSH com a sua instância de computação.

Verifique o estado do pacote do agente:

systemctl status google-cloud-workload-agent

Se o pacote do agente estiver a ser executado conforme esperado, a saída contém active (running). Por exemplo:

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

SLES

Estabeleça uma ligação SSH com a sua instância de computação.

Verifique o estado do pacote do agente:

systemctl status google-cloud-workload-agent

Se o pacote do agente estiver a ser executado conforme esperado, a saída contém active (running). Por exemplo:

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Debian

Estabeleça uma ligação SSH com a sua instância de computação.

Verifique o estado do pacote do agente:

systemctl status google-cloud-workload-agent

Se o pacote do agente estiver a ser executado conforme esperado, a saída contém active (running). Por exemplo:

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Windows

Estabeleça uma ligação com a sua instância de computação através do RDP.

Para obter informações sobre como o fazer, consulte o artigo Estabeleça ligação a VMs do Windows através do RDP.
Como administrador, execute o seguinte comando a partir do PowerShell:
```
$(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
```
Se o agente estiver a ser executado conforme esperado, o estado é apresentado como Running.

Exemplo de ficheiro de configuração

Segue-se um exemplo de configuração que permite que o agente para cargas de trabalho do Compute se ligue a uma instância do MySQL. Para a autenticação, é usado um segredo do Secret Manager, que é armazenado no mesmo projeto Google Cloud onde a instância do MySQL está a ser executada.

{
  "log_level": "INFO",
  "common_discovery": {
    "collection_frequency": "10800s"
  },
  "mysql_configuration": {
    "enabled": true,
    "connection_parameters": {
      "username": "db_user_name",
      "secret": {
        "secret_name": "db_pwd_secret_name",
        "project_id": ""
      },
      "host": "localhost",
      "port": 1433
    }
  }
}

Parâmetros de configuração

A tabela seguinte descreve os parâmetros de configuração do agente para cargas de trabalho de computação que suportam avaliações para cargas de trabalho do MySQL:

Parâmetros
`log_level`	`String` Para definir o nível de registo do agente, defina o valor necessário. Os níveis de registo disponíveis são os seguintes: `DEBUG` `INFO` `WARNING` `ERROR` O nível de registo predefinido é `INFO`. Não altere o nível de registo, a menos que receba instruções do apoio técnico ao cliente da Google Cloud.
`log_to_cloud`	`Boolean` Para redirecionar os registos do agente para o Cloud Logging, especifique `true`. O valor predefinido é `true`.
`agent_properties.log_usage_metrics`	`Boolean` Para ativar o registo das métricas de saúde do agente, defina o valor como `true`. O valor predefinido é `false`.
`common_discovery.collection_frequency`	`Duration` Especifique a frequência, em segundos, com que o serviço de deteção da carga de trabalho do agente é executado. O valor predefinido é `10800s`. Certifique-se de que o valor deste parâmetro termina com um `s` em minúsculas.
`mysql_configuration.enabled`	`Boolean` Para permitir que o agente recolha métricas da instância do MySQL, defina o valor como `true`. O valor predefinido é `false`. Importante: para que os outros parâmetros do agente específicos do MySQL funcionem, tem de definir `mysql_configuration.enabled` como `true`.
`mysql_configuration.connection_parameters.username`	`String` Especifique a conta de utilizador que o agente usa para consultar a instância do MySQL.
`mysql_configuration.connection_parameters.password`	`String` Especifique a palavra-passe de texto simples da conta de utilizador que o agente usa para consultar a instância do MySQL. Em vez de especificar uma palavra-passe de texto simples, recomendamos que use os parâmetros `secret.name` e `secret.project_id`. Para a autenticação, o agente usa a seguinte ordem de preferência: se especificado, o `secret` conjunto de parâmetros é preferível ao parâmetro `password`. Recomendamos que defina apenas uma opção de autenticação no ficheiro de configuração do agente.
`mysql_configuration.connection_parameters.secret.secret_name`	`String` Opcional. Para fornecer em segurança a palavra-passe da conta de utilizador que o agente usa para consultar a instância do MySQL, especifique o nome do segredo do Secret Manager que contém a palavra-passe. Para a autenticação, o agente usa a seguinte ordem de preferência: se especificado, o `secret` conjunto de parâmetros é preferível ao parâmetro `password`. Recomendamos que defina apenas uma opção de autenticação no ficheiro de configuração do agente.
`mysql_configuration.connection_parameters.secret.project_id`	`String` Opcional. Para usar o parâmetro `secret.secret_name` para autenticar a conta de utilizador especificada, especifique o ID do projeto do projeto Google Cloud onde o segredo do Secret Manager está armazenado. Se o segredo e a carga de trabalho estiverem no mesmo Google Cloud projeto, defina o valor deste parâmetro como uma string vazia (`""`).
`mysql_configuration.connection_parameters.host`	`String` Especifique o nome do anfitrião do MySQL.
`mysql_configuration.connection_parameters.port`	`Int` Especifique a porta na qual a sua instância do MySQL aceita consultas.

O que se segue?

Crie e execute uma avaliação
Saiba mais sobre as práticas recomendadas do Workload Manager para o MySQL

Configure o agente para cargas de trabalho do MySQL Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Funções de IAM necessárias

Ative o acesso às APIs Cloud

Instale e configure o agente

RHEL

SLES

Debian

Windows

Valide a instalação do agente

RHEL

SLES

Debian

Windows

Exemplo de ficheiro de configuração

Parâmetros de configuração

O que se segue?

Configure o agente para cargas de trabalho do MySQL