Configura l'agente per i workload Redis

Questo documento mostra come installare l'agente per i carichi di lavoro di calcolo su un'istanza Compute Engine e come configurarlo per la connessione a un carico di lavoro Redis in esecuzione su quell'istanza di calcolo.

Prima di iniziare

Prima di installare e configurare l'agente per i carichi di lavoro di Compute, devi assicurarti che siano soddisfatti i seguenti prerequisiti:

• Hai eseguito il deployment di un workload Redis su un'istanza di computing.
• Hai concesso i ruoli IAM richiesti al account di servizio collegato all'istanza di calcolo.
• Hai abilitato l'accesso alle API Cloud.

Ruoli IAM richiesti

L'agente per i workload di Compute utilizza il account di servizio collegato all'istanza di calcolo per l'autenticazione e per accedere alle risorse. Google Cloud

Per migliorare la sicurezza, ti consigliamo di utilizzare un service account monouso anziché l'account di servizio predefinito di Compute Engine.

Per assicurarti che il account di servizio disponga delle autorizzazioni necessarie per consentire all'agente per i carichi di lavoro di Compute di autenticarsi conGoogle Cloud e accedere alle risorse Google Cloud , chiedi all'amministratore di concedere al account di servizio i seguenti ruoli IAM sul tuo progetto:

Importante: devi concedere questi ruoli al account di servizio, non al tuo account utente. La mancata concessione dei ruoli all'entità corretta potrebbe comportare errori di autorizzazione.

• Visualizzatore Compute (roles/compute.viewer): per raccogliere le metriche dall'istanza di calcolo.
• Workload Manager Insights Writer (roles/workloadmanager.insightWriter): per scrivere dati nel data warehouse di Workload Manager.
• (Consigliato) Logs Writer (roles/logging.logWriter): per inviare i log dell'agente a Cloud Logging.
• (Facoltativo) Secret Manager Secret Accessor (roles/secretmanager.secretAccessor): se utilizzi Secret Manager per archiviare la password per connetterti all'istanza Redis.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche essere in grado di concedere al account di servizio le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Attivare l'accesso alle API Cloud

Compute Engine consiglia di configurare le istanze in modo da consentire tutti gli ambiti di accesso a tutte le API Cloud e di utilizzare solo le autorizzazioni IAM del account di servizio dell'istanza per controllare l'accesso alle risorseGoogle Cloud . Per maggiori informazioni, vedi Crea una VM che utilizza un service account gestito dall'utente.

Se limiti l'accesso alle API Cloud, l'agente per i workload di calcolo richiede almeno i seguenti ambiti di accesso alle API Cloud sull'istanza di calcolo host:

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

Per saperne di più, consulta le best practice per gli ambiti.

Se esegui applicazioni Redis su un'istanza di computing che non ha un indirizzo IP esterno, devi abilitare l'accesso privato Google nella subnet dell'istanza in modo che l'agente per i carichi di lavoro di Compute possa accedere alle API e ai servizi di Google. Per informazioni su come attivare l'accesso privato Google, consulta Configurare l'accesso privato Google.

Installa e configura l'agente

Per installare l'agente per i workload di calcolo sull'istanza di calcolo e configurarlo per la connessione a un'istanza Redis, completa i seguenti passaggi:

RHEL

Su Red Hat Enterprise Linux (RHEL), installa l'agente per i carichi di lavoro di Compute utilizzando il comando di gestione dei pacchetti yum. Questo comando completa le seguenti attività:

• Scarica l'ultima versione dell'agente.
• Crea un servizio systemd per l'agente, denominato google-cloud-workload-agent.
• Attiva e avvia il servizio google-cloud-workload-agent.

Per installare e configurare l'agente per i workload di calcolo su un'istanza di calcolo basata su RHEL, completa i seguenti passaggi:

1. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Nel terminale, installa l'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. Apri il file di configurazione dell'agente:

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

4. Specifica i valori per tutti i parametri obbligatori, come descritto in Parametri di configurazione.

5. Salvare il file di configurazione

6. Riavvia l'agente per far sì che le modifiche diventino effettive.

SLES

Su SUSE Linux Enterprise Server (SLES), installa l'agente per i carichi di lavoro di calcolo utilizzando il comando di gestione dei pacchetti zypper. Questo comando completa le seguenti attività:

• Scarica l'ultima versione dell'agente.
• Crea un servizio systemd per l'agente, denominato google-cloud-workload-agent.
• Attiva e avvia il servizio google-cloud-workload-agent.

Per installare e configurare l'agente per i workload di calcolo su un'istanza di calcolo basata su SLES, completa i seguenti passaggi:

1. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Nel terminale, installa l'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. Apri il file di configurazione dell'agente:

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

4. Specifica i valori per tutti i parametri obbligatori, come descritto in Parametri di configurazione.

5. Salvare il file di configurazione

6. Riavvia l'agente per far sì che le modifiche diventino effettive.

Debian

Su Debian, installa l'agente per i carichi di lavoro di Compute utilizzando il comando di gestione dei pacchetti apt. Questo comando completa le seguenti attività:

• Scarica l'ultima versione dell'agente.
• Crea un servizio systemd per l'agente, denominato google-cloud-workload-agent.
• Attiva e avvia il servizio google-cloud-workload-agent.

Per installare e configurare l'agente per i workload di calcolo su un'istanza di calcolo basata su Debian, completa i seguenti passaggi:

1. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Nel terminale, installa l'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. Apri il file di configurazione dell'agente:

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

4. Specifica i valori per tutti i parametri obbligatori, come descritto in Parametri di configurazione.

5. Salvare il file di configurazione

6. Riavvia l'agente per far sì che le modifiche diventino effettive.

Windows

Su Windows, installa l'agente per i workload di calcolo utilizzando il comando di gestione dei pacchetti googet. Questo comando completa le seguenti attività:

• Scarica l'ultima versione dell'agente.
• Crea un servizio Windows denominato google-cloud-workload-agent.
• Crea un'attività pianificata che viene eseguita ogni minuto per verificare se il servizio è in esecuzione e, se necessario, riavvia il servizio.

Avviso: non interrompere manualmente il servizio Windows google-cloud-workload-agent né eliminare l'attività pianificata.

Per installare e configurare l'agente per i workload di calcolo su un'istanza di calcolo basata su Windows, completa i seguenti passaggi:

1. Stabilisci una connessione con l'istanza di computing utilizzando RDP.

   Per informazioni su come farlo, consulta Connettiti alle VM Windows utilizzando RDP.

2. In qualità di amministratore, esegui i seguenti comandi da 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. Apri il file di configurazione dell'agente:

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

4. Specifica i valori per tutti i parametri obbligatori, come descritto in Parametri di configurazione.

5. Salvare il file di configurazione

6. Riavvia l'agente per far sì che le modifiche diventino effettive.

Verifica l'installazione dell'agente

Per verificare che l'agente sia in esecuzione come previsto, completa i seguenti passaggi:

RHEL

1. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Controlla lo stato del pacchetto dell'agente:

   systemctl status google-cloud-workload-agent
   

   Se il pacchetto dell'agente è in esecuzione come previsto, l'output contiene active (running). Ad esempio:

   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. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Controlla lo stato del pacchetto dell'agente:

   systemctl status google-cloud-workload-agent
   

   Se il pacchetto dell'agente è in esecuzione come previsto, l'output contiene active (running). Ad esempio:

   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. Stabilisci una connessione SSH con l'istanza di calcolo.

2. Controlla lo stato del pacchetto dell'agente:

   systemctl status google-cloud-workload-agent
   

   Se il pacchetto dell'agente è in esecuzione come previsto, l'output contiene active (running). Ad esempio:

   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

1. Stabilisci una connessione con l'istanza di computing utilizzando RDP.

   Per informazioni su come farlo, consulta Connettiti alle VM Windows utilizzando RDP.

2. In qualità di amministratore, esegui il seguente comando da PowerShell:

   $(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
   

   Se l'agente è in esecuzione come previsto, lo stato visualizzato è Running.

File di configurazione di esempio

Di seguito è riportata una configurazione di esempio che consente all'agente per i workload di Compute di connettersi a un'istanza Redis. Per l'autenticazione, viene utilizzato un secret di Secret Manager, archiviato nello stesso progetto Google Cloud in cui è in esecuzione l'istanza Redis.

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

Parametri di configurazione

La tabella seguente descrive i parametri di configurazione di Agent for Compute Workloads che supportano le valutazioni per i workload Redis:

Parametri
log_level	String Per impostare il livello di logging dell'agente, imposta il valore richiesto. I livelli di log disponibili sono i seguenti: DEBUG INFO WARNING ERROR Il livello di log predefinito è INFO. Non modificare il livello di logging a meno che non ti venga indicato dall'assistenza clienti Google Cloud.
log_to_cloud	Boolean Per reindirizzare i log dell'agente a Cloud Logging, specifica true. Il valore predefinito è true.
agent_properties.log_usage_metrics	Boolean Per attivare la registrazione delle metriche di integrità dell'agente, imposta il valore su true. Il valore predefinito è false.
common_discovery.collection_frequency	Duration Specifica la frequenza, in secondi, con cui viene eseguito il servizio di rilevamento del workload dell'agente. Il valore predefinito è 10800s. Assicurati che il valore di questo parametro termini con s minuscolo.
redis_configuration.enabled	Boolean Per consentire all'agente di raccogliere metriche dall'istanza Redis, imposta il valore su true. Il valore predefinito è false. Importante:affinché gli altri parametri dell'agente specifici di Redis funzionino, devi impostare redis_configuration.enabled su true.
redis_configuration.connection_parameters.username	String Specifica l'account utente utilizzato dall'agente per eseguire query sull'istanza Redis.
redis_configuration.connection_parameters.password	String Specifica la password di testo normale per l'account utente utilizzato dall'agente per eseguire query sull'istanza Redis. Anziché specificare una password di testo normale, ti consigliamo di utilizzare i parametri secret.name e secret.project_id. Per l'autenticazione, l'agente utilizza il seguente ordine di preferenza: se specificato, il set di parametri secret è preferito al parametro password. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione dell'agente.
redis_configuration.connection_parameters.secret.secret_name	String Facoltativo. Per fornire in modo sicuro la password per l'account utente che l'agente utilizza per eseguire query sull'istanza Redis, specifica il nome del secret di Secret Manager che contiene la password. Per l'autenticazione, l'agente utilizza il seguente ordine di preferenza: se specificato, il set di parametri secret è preferito al parametro password. Ti consigliamo di impostare una sola opzione di autenticazione nel file di configurazione dell'agente.
redis_configuration.connection_parameters.secret.project_id	String Facoltativo. Per utilizzare il parametro secret.secret_name per autenticare l'account utente specificato, specifica l'ID progetto del progetto Google Cloud in cui è archiviato il secret di Secret Manager. Se il secret e il workload si trovano nello stesso progetto Google Cloud , imposta il valore di questo parametro su una stringa vuota ("").
redis_configuration.connection_parameters.host	String Specifica il nome host Redis.
redis_configuration.connection_parameters.port	Int Specifica la porta su cui l'istanza Redis accetta le query.

Passaggi successivi

• Crea ed esegui una valutazione
• Scopri di più sulle best practice di Gestore carichi di lavoro per Redis