Configure o agente para cargas de trabalho do Microsoft SQL Server

Este documento mostra como instalar o agente para cargas de trabalho de computação em instâncias do Compute Engine e configurar o agente para estabelecer ligação a uma carga de trabalho do Microsoft SQL Server em execução nessas instâncias de computação.

Depois de instalar e configurar o agente, este recolhe métricas da sua carga de trabalho do SQL Server e das instâncias de computação subjacentes, e envia-as para o Workload Manager. Em seguida, pode usar a avaliação do Workload Manager para analisar as suas cargas de trabalho do SQL Server quanto a desvios das práticas recomendadas para configurações de infraestrutura, sistema operativo e carga de trabalho.

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 SQL Server numa ou mais instâncias de computação.
• Concedeu as funções de IAM necessárias para o agente.
• Ativou o acesso às APIs Cloud.
• Concedeu as autorizações necessárias no SQL Server.

Funções IAM necessárias para o agente

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:

Importante: tem de conceder estas funções à conta de serviço e não à sua conta de utilizador. Se não conceder as funções ao principal correto, podem ocorrer erros de autorização.

• 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 se ligar à instância do SQL Server.

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 Cloud e usar apenas as autorizações do IAM da conta de serviço da instância para controlar o acesso aosGoogle Cloud recursos. 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 do SQL Server 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.

Autorizações necessárias no SQL Server

Use o seguinte script para atribuir as autorizações necessárias à conta de utilizador configurada no agente.

    USE [master]
    GO 

    GRANT VIEW SERVER STATE TO [user_name]
    GRANT VIEW ANY DEFINITION TO [user_name] 

    -- Adds db_datareader role to the user
    EXEC sp_MSForEachDB
    '
    USE ?
    IF NOT EXISTS(SELECT * FROM sys.database_principals WHERE name = ''user_name'')
    BEGIN
      CREATE USER [user_name] FOR LOGIN [user_name]
    END
    EXEC sp_addrolemember ''db_datareader'', ''user_name''
    '
  

Instale e configure o agente através do gestor de pacotes

Nota: se o agente antigo para SQL Server já estiver instalado na VM, durante o processo de instalação, o agente para cargas de trabalho do Compute migra automaticamente o ficheiro de configuração do agente para a nova localização e elimina o agente para SQL Server da VM.

Esta secção mostra-lhe como 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 SQL Server através de um gestor de pacotes.

Para instalar o agente para cargas de trabalho de computação, conclua os seguintes passos:

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á em execução e, se necessário, reinicia o serviço.

Aviso: não pare o serviço do Windows manualmente nem elimine a respetiva tarefa agendada.

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:

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

2. 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
   

3. Abra o ficheiro de configuração do agente:

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

4. Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.

5. Guarde o ficheiro de configuração

6. Reinicie o agente para que as alterações entrem em vigor.

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:

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

2. 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
   

3. Abra o ficheiro de configuração do agente:

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

4. Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.

5. Guarde o ficheiro de configuração

6. 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:

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

2. 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
   

3. Abra o ficheiro de configuração do agente:

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

4. Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.

5. Guarde o ficheiro de configuração

6. 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:

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

2. 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
   

3. Abra o ficheiro de configuração do agente:

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

4. Especifique valores para todos os parâmetros obrigatórios, conforme descrito em Parâmetros de configuração.

5. Guarde o ficheiro de configuração

6. Reinicie o agente para que as alterações entrem em vigor.

Instale e faça a gestão do agente numa frota de VMs através do Gestor de extensões de VMs

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Configure o VM Extension Manager

Para configurar o VM Extension Manager, conclua os seguintes passos:

• Na documentação do Gestor de extensões de VMs, reveja a secção Antes de começar.

• Configure as funções do IAM necessárias para criar e gerir políticas do VM Extension Manager. Para mais informações, consulte o seguinte:

  • Crie políticas de extensões de VMs
  • Atualize as políticas de extensões de VMs
  • Elimine políticas de extensões de VMs
  • Liste e descreva as políticas de extensões de VMs

Instale o agente numa frota de VMs

Para instalar a versão mais recente do agente para cargas de trabalho de computação na sua frota de VMs numa zona específica através de uma política do Gestor de extensões de VMs, conclua os seguintes passos:

Consola

1. Na Google Cloud consola, aceda à página Políticas de extensão de VMs.

   Aceda às políticas de extensão de VMs

2. Clique em Criar política de extensões.

3. No campo Nome, introduza um nome para a política.

4. Opcional: no campo Descrição, introduza uma descrição para a política.

5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

6. Nas listas Região e Zona, selecione a zona onde quer aplicar esta política.

7. Na secção Extensões, clique em Adicionar extensão e, de seguida, faça o seguinte:

   1. Na lista Extensão, selecione Extensão do Google Cloud para cargas de trabalho de computação.

   2. Deixe o campo Version em branco.

      Esta ação direciona a política para instalar a versão mais recente do agente para cargas de trabalho de computação.

   3. No campo Conteúdo do ficheiro de configuração, introduza a configuração que quer aplicar ao agente.

      Para ver informações sobre os parâmetros de configuração suportados pelo agente para a sua carga de trabalho do SQL Server, consulte Parâmetros de configuração.

      Nota: Se aplicar uma política do VM Extension Manager a VMs nas quais o agente para cargas de trabalho de computação já está em execução, a política substitui a versão e a configuração do agente existente pelo que definiu na política.

      A configuração existente do agente é escrita num ficheiro BAK no diretório /etc/google-cloud-workload-agent/ nas VMs respetivas.

   4. Clique em Concluído.

8. Opcional: para limitar a implementação da política às VMs necessárias, faça o seguinte:

   1. Clique em Adicionar etiquetas e inclua as etiquetas que identificam as VMs necessárias.
   2. Clique em Concluído.

9. Clique em Criar.

gcloud

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Substitua o seguinte:

• POLICY_NAME: um nome para a política de extensão de VM.

  O comando falha se já existir uma política com o nome especificado na zona.

• ZONE: a zona onde quer aplicar esta política.

• CONFIG_FILE_PATH: o caminho local para o ficheiro JSON que contém a configuração do agente para cargas de trabalho do Compute Engine para estabelecer ligação à sua carga de trabalho do SQL Server.

  • Em alternativa, para fornecer a configuração como uma string inline, use a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-workload-extension="CONFIG". OGoogle Cloud recomenda que use o --config-from-file.
  • Pode usar --config-from-file ou --config, mas não ambos no mesmo comando.
  • Para ver informações sobre os parâmetros de configuração suportados pelo agente para a sua carga de trabalho do SQL Server, consulte Parâmetros de configuração.
  Nota: se aplicar uma política do VM Extension Manager a VMs nas quais o agente para cargas de trabalho de computação já está em execução, a política substitui a versão e a configuração do agente existente pelas que definiu na política.

  A configuração existente do agente é escrita num ficheiro BAK no diretório /etc/google-cloud-workload-agent/ nas VMs respetivas.

• DESCRIPTION: uma descrição opcional da política.

• KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem as etiquetas através das quais a política segmenta as VMs.

  • Para uma VM ser segmentada pela sua política, tem de ter todas as etiquetas especificadas.
  • Se especificar --inclusion-labels várias vezes, a política segmenta as MV que correspondem a qualquer um dos seletores fornecidos (OR lógico). Se omitir esta flag, a política segmenta todas as MV na zona especificada.

• PRIORITY: um número inteiro de 0 a 65535 que define a prioridade da política. Os números mais baixos indicam uma prioridade mais elevada. O valor predefinido é 1000.

Exemplo:

O comando seguinte cria uma política denominada test-agent-policy no projeto denominado test-project, que instala a versão mais recente do agente para cargas de trabalho de computação em todas as VMs implementadas na zona us-centrail-f.Google Cloud A configuração especificada no agent-config.json é aplicada ao agente.

gcloud beta compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

Valide a instalação do agente

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

Windows

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

2. 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 como esperado, o estado é Running.

RHEL

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

2. Verifique o estado do pacote do agente:

   systemctl status google-cloud-workload-agent
   

   Se o pacote do agente estiver a ser executado conforme esperado, o resultado 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

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

2. Verifique o estado do pacote do agente:

   systemctl status google-cloud-workload-agent
   

   Se o pacote do agente estiver a ser executado conforme esperado, o resultado 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

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

2. Verifique o estado do pacote do agente:

   systemctl status google-cloud-workload-agent
   

   Se o pacote do agente estiver a ser executado conforme esperado, o resultado 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

Parâmetros de configuração

A tabela seguinte descreve os parâmetros do ficheiro de configuração do agente.

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 do 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.
sqlserver_configuration.enabled	Boolean Para ativar as recolhas de métricas do SQL Server no agente, defina o valor como true. A predefinição é false. Nota: para que outros parâmetros de configuração específicos do agente do SQL Server entrem em vigor, defina sqlserver_configuration.enabled como true.
sqlserver_configuration.collection_configuration.collect_guest_os_metrics	Boolean Para ativar a recolha de métricas do SO, defina o valor como true. A predefinição é true. Não defina sqlserver_configuration.collection_configuration.collect_guest_os_metrics como false a menos que lhe seja indicado pelo Cloud Customer Care.
sqlserver_configuration.collection_configuration.collect_sql_metrics	Boolean Para ativar a recolha de métricas do SQL Server, especifique true. A predefinição é true. Não defina sqlserver_configuration.collection_configuration.collect_sql_metrics como false , a menos que lhe seja indicado pelo Cloud Customer Care.
sqlserver_configuration.collection_configuration.collection_frequency	Duration Agente para a frequência de recolha de métricas de cargas de trabalho de computação, em segundos. A predefinição é 3600s. Pode atualizar a frequência da recolha. No entanto, recomendamos que mantenha o valor predefinido.
sqlserver_configuration.credential_configurations[].connection_parameters[].host	String O nome do anfitrião do SQL Server.
sqlserver_configuration.credential_configurations[].connection_parameters[].username	String Especifique a conta de utilizador que é usada para consultar a instância do SQL Server. Para configurar as autorizações da conta, reveja as autorizações necessárias no script de autorizações e conceda-as de acordo com as suas políticas internas. Nota: se estiver a usar a autenticação do Windows, certifique-se de que especifica o nome de utilizador no seguinte formato: domain-name\\user-name
sqlserver_configuration.credential_configurations[].connection_parameters[].secret.project_id	String O ID do projeto onde o segredo está armazenado. Defina-o como uma string vazia ("") se o segredo e a instância de VM do anfitrião existirem no mesmo projeto Google Cloud .
sqlserver_configuration.credential_configurations[].connection_parameters[].secret.secret_name	String Para fornecer de forma segura a palavra-passe da conta de utilizador da base de dados que o agente usa para consultar o SQL Server, especifique o nome do segredo no Secret Manager que contém as credenciais de segurança da conta de utilizador da base de dados. Nota: o segredo e a instância de VM anfitriã têm de existir no mesmo Google Cloud projeto.
sqlserver_configuration.credential_configurations[].connection_parameters[].port	Int Especifique a porta na qual a instância do SQL Server aceita consultas.
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.host	String Endereço IP ou FQDN da VM do Windows remota
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.username	String Especifique a conta de utilizador que é usada para estabelecer ligação remotamente à VM do Windows.
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.secret.secret_name	String Para fornecer de forma segura a palavra-passe da conta de utilizador do Windows que o agente usa para se ligar remotamente à VM, especifique o nome do segredo no Secret Manager que contém as credenciais de segurança da conta de utilizador da base de dados. Nota: o segredo e a instância de VM anfitriã têm de existir no mesmo Google Cloud projeto.
sqlserver_configuration.credential_configurations[].local_collection	Boolean Especifique true para indicar que o agente está a fazer a recolha de dados locais. A predefinição é true.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameters.host	String Endereço IP ou FQDN da VM Linux remota.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameters.username	String Especifique a conta de utilizador que é usada para estabelecer ligação remotamente à VM do Linux.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameter.port	Int Especifique o número da porta SSH para a VM Linux remota.
sqlserver_configuration.credential_configurations[].remote_linux.linux_ssh_private_key_path	String Especifique o caminho para o ficheiro de chave privada de SSH.
sqlserver_configuration.credential_configurations[].vm_properties.instance_name	String Especifique o nome da instância de VM do Compute Engine. Nota: opcional para recolha local.
sqlserver_configuration.credential_configurations[].vm_properties.instance_id	String Especifique o ID da instância de VM do Compute Engine. Nota: opcional para recolha local.
sqlserver_configuration.collection_timeout	Duration O limite de tempo para a recolha de métricas, em segundos. A predefinição é "10s".
sqlserver_configuration.max_retries	Int O número máximo de tentativas quando ocorre uma recolha falhada. O valor predefinido é `3`.
sqlserver_configuration.retry_frequency	Duration Especifique a frequência com que o agente deve tentar novamente quando uma recolha falha. O valor predefinido é `3600s`.
sqlserver_configuration.remote_collection	Boolean Especifique true para indicar que o agente está a fazer a recolha de dados remota. A predefinição é false.

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 SQL Server:

Recolha local

{
"log_level": "INFO",
"common_discovery": {
    "collection_frequency": "10800s"
},
"sqlserver_configuration": {
    "enabled": true,
    "collection_configuration": {
        "collect_guest_os_metrics": true,
        "collect_sql_metrics": true,
        "collection_frequency": "60s"
    },
    "credential_configurations": [
        {
            "connection_parameters": [
                {
                    "host": ".",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "idb_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "local_collection": true
        }
    ],
    "collection_timeout": "60s",
    "max_retries": 5,
    "retry_frequency": "3600s"
}
}

Recolha remota

{
"log_level": "INFO",
"common_discovery": {
    "collection_frequency": "10800s"
},
"sqlserver_configuration": {
    "enabled": true,
    "collection_configuration": {
        "collect_guest_os_metrics": true,
        "collect_sql_metrics": true,
        "collection_frequency": "60s"
    },
    "credential_configurations": [
        {
            "connection_parameters": [
                {
                    "host": "sql_server_instance",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "db_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "remote_win": {
                "connection_parameters": {
                    "host": "sql_server_instance",
                    "username": "user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "pwd_secret_name"
                    }
                }
            },
            "vm_properties": {
                "instance_name": "db01",
                "instance_id": "9999999999999999999"
            }
        },
        {
            "connection_parameters": [
                {
                    "host": "sql_server_instance",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "db_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "remote_linux": {
                "connection_parameters": {
                    "host": "sql_server_instance",
                    "username": "user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "pwd_secret_name"
                    },
                    "port": 22
                },
                "linux_ssh_private_key_path": "path of the private key"
            },
            "vm_properties": {
                "instance_name": "db02",
                "instance_id": "9999999999999999999"
            }
        }
    ],
    "collection_timeout": "10s",
    "max_retries": 3,
    "retry_frequency": "3600s",
    "remote_collection": true
}
}

Verifique a versão do agente

Para verificar a versão do seu agente, conclua os seguintes passos:

Windows

1. Use o RDP para estabelecer ligação à máquina anfitriã.
2. Como administrador, execute o seguinte comando a partir do PowerShell:

   googet installed google-cloud-workload-agent

RHEL

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   yum info google-cloud-workload-agent

SUSE

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   zypper info google-cloud-workload-agent

Debian

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   dpkg -s google-cloud-workload-agent | grep version

Reinicie o agente

Se o agente para cargas de trabalho de computação parar de funcionar ou atualizar a respetiva configuração, reinicie o agente.

Selecione o seu sistema operativo e, em seguida, siga os passos:

Windows

1. Use o RDP para estabelecer ligação à máquina anfitriã.
2. Como administrador, execute o seguinte comando a partir do PowerShell:

   Restart-Service -Name 'google-cloud-workload-agent' -Force

Linux

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo systemctl restart google-cloud-workload-agent

Atualize o agente

Para garantir que tem a versão mais recente do agente, tem de verificar periodicamente se existem atualizações e atualizar o agente.

Procure atualizações

Selecione o seu sistema operativo e, em seguida, siga os passos:

Windows

1. Use o RDP para estabelecer ligação à máquina anfitriã.
2. Como administrador, execute o seguinte comando a partir do PowerShell:

   googet latest google-cloud-workload-agent

RHEL

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo yum check-update google-cloud-workload-agent

SLES

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo zypper list-updates -r google-cloud-workload-agent

Debian

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo apt list google-cloud-workload-agent

Instale uma atualização

Selecione o seu sistema operativo e, em seguida, siga os passos:

Windows

1. Use o RDP para estabelecer ligação à máquina anfitriã.
2. Como administrador, execute o seguinte comando a partir do PowerShell:

   googet install google-cloud-workload-agent

RHEL

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo yum --nogpgcheck update google-cloud-workload-agent

SLES

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo zypper --no-gpg-checks update google-cloud-workload-agent

Debian

1. Use o SSH para se ligar à máquina anfitriã.
2. Execute o seguinte comando:

   sudo apt-get install google-cloud-workload-agent

Veja os registos do agente em Registos na nuvem

Por predefinição, os registos do agente para cargas de trabalho de computação são redirecionados das suas instâncias de VM para o Cloud Logging.

Para ver os registos do agente no Logging, siga estes passos:

1. Na Google Cloud consola, aceda à página Explorador de registos.

   Aceda ao Explorador de registos

2. Aceda ao painel Consulta.

3. No menu pendente Recursos, selecione Global e, de seguida, clique em Aplicar.

4. No editor de consultas, introduza google-cloud-workload-agent.

5. Clique em Executar consulta.

   Deverá ver os registos gerados pelas instâncias do agente em execução em todas as suas instâncias de VM. Para filtrar os registos de uma máquina específica, use os filtros disponíveis na interface.

Desative os registos do agente no Cloud Logging

Para desativar o redirecionamento predefinido dos registos do agente para o Cloud Logging, siga estes passos:

1. Estabeleça uma ligação RDP ou SSH com a instância da VM do anfitrião.

2. Abra o ficheiro de configuração do agente:

   Windows

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

   Linux

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

3. Para a propriedade log_to_cloud, atualize o valor para false.

4. Guarde o ficheiro de configuração.

5. Reinicie o agente para que esta alteração entre em vigor.

Resolver problemas

As secções seguintes fornecem informações sobre problemas comuns relacionados com a utilização do agente para cargas de trabalho de computação, as respetivas causas e resolução.

Âmbitos de autenticação insuficientes

Problema: se limitar os âmbitos de acesso na instância de VM do anfitrião, os registos do agente para cargas de trabalho do Compute podem apresentar um erro de autorizações do IAM insuficientes.

  googleapi: Error 403: Request had insufficient authentication scopes.
  Details:
  [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "domain": "googleapis.com",
      "metadata": {
        "method": "google.cloud.workloadmanager.datawarehouse.v1.DataCollectService.WriteInsight",
        "service": "workloadmanager.googleapis.com"
      },
      "reason": "ACCESS_TOKEN_SCOPE_INSUFFICIENT"
    }
  ]


More details:
  Reason: insufficientPermissions, Message: Insufficient Permission

Causa: o agente para cargas de trabalho de computação requer âmbitos de acesso mínimos da API Cloud na instância de VM do anfitrião.

Resolução: para resolver este problema, ative os âmbitos de acesso necessários

Falha ao carregar o ficheiro de configuração

Problema: se o ficheiro de configuração tiver valores inválidos, é apresentado o seguinte erro.

"Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown
field "{field_name}"

Resolução: para resolver este problema, atualize o ficheiro de configuração com os detalhes em Parâmetros de configuração.

Falha ao inicializar a recolha de dados

Problema: após a instalação do agente, se o ficheiro de configuração não for atualizado, é apresentado o seguinte erro:

"Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"

Resolução: para resolver este problema, inicialize a configuração das credenciais com os parâmetros de configuração.

O que se segue?

• Saiba mais sobre as avaliações da carga de trabalho.