Configura l'agente per i workload Oracle

Questo documento mostra come installare, configurare e verificare l'Agent for Compute Workloads sulle istanze Compute Engine che eseguono carichi di lavoro Oracle Database.

L'agente raccoglie varie metriche Oracle eseguendo query sulle visualizzazioni delle prestazioni di Oracle Database (ad esempio V$DATABASE, V$INSTANCE e V$DATAGUARD_STATS) e sulle visualizzazioni del dizionario dei dati (ad esempio DBA_DATA_FILES e DBA_FREE_SPACE). Queste metriche vengono poi inviate a Cloud Monitoring, dove possono essere visualizzate e analizzate. Consulta Metriche supportate.

Prima di iniziare

Prima di installare Agent for Compute Workloads per monitorare i workload Oracle Database, assicurati che siano soddisfatti i seguenti prerequisiti:

Esamina i requisiti di sistema

La tabella seguente elenca le edizioni di Oracle che puoi utilizzare e le versioni del sistema operativo supportate:

Sistemi operativi Versioni di Oracle Versioni di Oracle
  • Red Hat Enterprise Linux versioni 7, 8 e 9
  • Versioni 7, 8 e 9 di Oracle Linux
  • Oracle Database 19c
  • Oracle Database 23ai*
  • Enterprise Edition
  • Standard Edition
  • Express (Free) Edition

Concedi ruoli IAM al account di servizio

Agent for Compute Workloads utilizza il account di servizio collegato all'istanza di computing 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 ad Agent for Compute Workloads di autenticarsi conGoogle Cloud e accedere alle risorse Google Cloud , chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio nel tuo progetto:

Per saperne di più 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.

Abilitare 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'Agent for Compute Workloads richiede almeno i seguenti ambiti di accesso alle API Cloud sull'istanza di computing host:

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

Per saperne di più, consulta le best practice relative agli ambiti.

Se esegui un carico di lavoro Oracle su un'istanza di computing che non ha un indirizzo IP esterno, devi attivare l'accesso privato Google sulla subnet dell'istanza in modo che l'Agent for Compute Workloads possa accedere ai servizi e alle API di Google. Per informazioni su come attivare l'accesso privato Google, consulta Configura l'accesso privato Google.

Installare e configurare l'agente utilizzando il gestore di pacchetti

Questa sezione mostra come installare l'Agent for Compute Workloads sull'istanza di computing e come configurarlo per la connessione a un'istanza Oracle utilizzando un gestore dei pacchetti.

Per installare l'Agent for Compute Workloads, completa i seguenti passaggi:

  1. Crea un file di configurazione del repository.

    sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Workload Agent
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

  2. Aggiorna i metadati del gestore di pacchetti:

    sudo yum makecache

  3. Installa il pacchetto rpm google-cloud-workload-agent:

    sudo yum install google-cloud-workload-agent

Dopo aver installato l'agente per i workload Oracle, verifica l'installazione dell'agente.

Installare e gestire l'agente su un parco risorse di VM utilizzando il gestore di estensioni VM

Questa sezione mostra come installare e gestire l'Agent for Compute Workloads su un parco risorse di VM utilizzando il gestore di estensioni VM.

La policy di gestore di estensioni VM consente di eseguire attività come le seguenti:

  • Installazione a livello di parco risorse: installa Agent for Compute Workloads su quanto segue:
    • Tutte le VM nel tuo progetto Google Cloud o un sottoinsieme di VM identificate dalle etichette.
    • Tutte le VM all'interno di una zona o un sottoinsieme di VM identificate dalle etichette.
  • Gestione della configurazione: applica una configurazione personalizzata all'agente su tutte le VM gestite da un criterio.

Per saperne di più sul gestore di estensioni VM, consulta Informazioni sul gestore di estensioni VM.

Configura Gestore di estensioni VM

Per configurare il gestore di estensioni VM, completa i seguenti passaggi:

Installare e configurare l'agente su un parco risorse di VM

Per installare l'ultima versione dell'agente per i workload di calcolo sul tuo parco VM utilizzando una policy di VM Extension Manager, consulta la sezione appropriata:

Installa e configura l'agente sulle VM all'interno del tuo progetto Google Cloud

Per installare l'agente su tutte le VM nel tuo progetto Google Cloud o su un sottoinsieme di VM identificate da un'etichetta utilizzando una policy del gestore di estensioni VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic su Crea policy di estensione.

  3. Nel campo Nome, inserisci un nome per la policy.

  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.

  5. Nel campo Priorità, specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Nella sezione Ambito, seleziona Implementazione globale.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e poi segui questi passaggi:

    1. Dall'elenco Estensione, seleziona Estensione di Google Cloud per i workload di computing.

    2. Lascia vuoto il campo Versione.

      In questo modo, il criterio indica di installare l'ultima versione di Agent for Compute Workloads.

    3. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

      Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload Oracle, consulta Parametri di configurazione.

    4. Fai clic su Fine.

    5. Nel campo Implementazione, seleziona l'opzione del piano di implementazione che vuoi utilizzare: Implementazione lenta (consigliata) o Implementazione rapida.

      Per informazioni sui piani di implementazione, vedi Informazioni sui piani di implementazione.

  8. (Facoltativo) Per limitare l'implementazione della policy alle VM richieste:

    1. Fai clic su Aggiungi etichette e includi le etichette che identificano le VM richieste.
    2. Fai clic su Fine.

  9. Fai clic su Crea.

gcloud

Nel terminale o in Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

Sostituisci quanto segue:

  • POLICY_NAME: un nome univoco per il criterio di estensione VM.
  • PROJECT_ID: l'ID progetto del progettoGoogle Cloud per cui stai creando la policy

  • ROLL_OUT_SPEED: la velocità con cui vuoi implementare la policy. I valori supportati sono slow_rollout (consigliato) e fast_rollout. Per saperne di più, vedi Informazioni sui piani di implementazione.

  • In alternativa, puoi utilizzare un piano di implementazione personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, vedi Informazioni sui piani di implementazione.

  • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

  • DESCRIPTION: una descrizione facoltativa della policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione dell'Agent for Compute Workloads.

    • In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-workload-extension="CONFIG".
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per il targeting delle VM.

    • Affinché una VM sia presa di mira dalla tua policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno qualsiasi dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM del progetto.

  • PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Per saperne di più, consulta Priorità delle policy e risoluzione dei conflitti.

Installa e configura l'agente sulle VM all'interno di una zona specifica

Per installare e configurare l'ultima versione di Agent for Compute Workloads sul tuo parco VM all'interno di una zona specifica utilizzando una policy di gestore di estensioni VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic su Crea policy di estensione.

  3. Nel campo Nome, inserisci un nome per la policy.

  4. (Facoltativo) Nel campo Descrizione, inserisci una descrizione della policy.

  5. Nel campo Priorità, specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

  6. Utilizzando gli elenchi Regione e Zona, seleziona la zona in cui vuoi applicare questa policy.

  7. Nella sezione Gestisci estensioni, fai clic su Aggiungi estensione e poi segui questi passaggi:

    1. Dall'elenco Estensione, seleziona Estensione di Google Cloud per i workload di computing.

    2. Lascia vuoto il campo Versione.

      In questo modo, il criterio indica di installare l'ultima versione di Agent for Compute Workloads.

    3. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

      Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload Oracle, consulta Parametri di configurazione.

    4. Fai clic su Fine.

  8. (Facoltativo) Per limitare l'implementazione della policy alle VM richieste:

    1. Fai clic su Aggiungi etichette e includi le etichette che identificano le VM richieste.
    2. Fai clic su Fine.

  9. Fai clic su Crea.

gcloud 

gcloud 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]

Sostituisci quanto segue:

  • POLICY_NAME: un nome per la policy di estensione VM.

    Il comando non va a buon fine se esiste già una policy con il nome specificato nella zona.

  • ZONE: la zona in cui vuoi applicare questa policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione di Agent for Compute Workloads per la connessione al tuo workload Oracle.

    • In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-workload-extension="CONFIG". Google Cloud consiglia di utilizzare --config-from-file.
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente per il tuo workload Oracle, consulta Parametri di configurazione.

  • DESCRIPTION: una descrizione facoltativa della policy.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per il targeting delle VM.

    • Affinché una VM sia presa di mira dalla tua policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno qualsiasi dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata.

  • PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.

Esempio:

Il seguente comando crea una policy denominata test-agent-policy nel progettoGoogle Cloud denominato test-project, che installa l'ultima versione di Agent for Compute Workloads su tutte le VM di cui è stato eseguito il deployment nella zona us-centrail-f. La configurazione specificata in agent-config.json viene applicata all'agente.

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

Gestisci l'agente su un parco VM

Per modificare il modo in cui una policy del gestore di estensioni VM gestisce Agent for Compute Workloads, aggiorna la policy. Quando aggiorni una policy, VM Extension Manager implementa le modifiche a tutte le VM applicabili, in genere entro un minuto. Se modifichi le etichette di inclusione, l'Agent for Compute Workloads potrebbe essere installato su nuove VM o disinstallato da VM esistenti a seconda che le VM corrispondano alle etichette aggiornate.

Le sezioni seguenti mostrano come gestire l'Agent for Compute Workloads per eseguire le seguenti operazioni:

Modifica della configurazione dell'agente su un parco risorse di VM

Per modificare la configurazione delle istanze di Agent for Compute Workloads che hai installato nel tuo parco risorse VM utilizzando una policy di gestore di estensioni VM, devi modificare la policy.

Per modificare la configurazione dell'agente nel parco VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic sulla policy che vuoi modificare.

  3. Nella pagina Dettagli della norma relativa alle estensioni, fai clic su Modifica.

  4. Nella sezione Gestisci estensioni, attiva/disattiva Estensione di Google Cloud per i workload di computing.

  5. Nel campo Contenuto del file di configurazione, inserisci la configurazione che vuoi applicare all'agente.

    Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  6. Fai clic su Fine.

  7. Fai clic su Salva.

gcloud

Per modificare la configurazione di Agent for Compute Workloads nel parco VM, esegui il comando gcloud compute zone-vm-extension-policies update. Quando aggiorni una norma utilizzando gcloud, la richiesta funge da sostituzione completa. I campi facoltativi che ometti vengono ripristinati ai valori predefiniti anziché conservare i valori esistenti del criterio modificato.

Per modificare la configurazione dell'agente:

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

Sostituisci quanto segue:

  • POLICY_NAME: il nome del criterio di estensione VM che vuoi modificare.
  • ZONE: la Google Cloud zona in cui si applica la policy.

  • CONFIG_FILE_PATH: il percorso locale del file JSON contenente la configurazione dell'Agent for Compute Workloads.

    • Puoi anche fornire la configurazione dell'agente come stringa incorporata utilizzando il flag --config anziché --config-from-file. Ad esempio --config=google-cloud-workload-extension="CONFIG". Google Cloud consiglia di utilizzare --config-from-file.
    • Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.
    • Per informazioni sui parametri di configurazione supportati dall'agente, consulta Parametri di configurazione.

  • KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette utilizzate dalla policy per il targeting delle VM.

    • Affinché una VM sia presa di mira dalla tua policy, deve avere tutte le etichette specificate.
    • Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno qualsiasi dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata.

  • PRIORITY_NUMBER: la priorità che vuoi impostare per la policy. Puoi specificare un numero intero compreso tra 0 e 65535.

  • DESCRIPTION: una descrizione della policy di estensione VM.

Aggiorna una policy globale per includere nuove zone

Quando crei VM in una nuova zona dopo aver creato e implementato una policy globale, gestore di estensioni VM non applica automaticamente la policy alle VM nelle nuove zone. Per includere le VM nelle nuove zone, devi riavviare l'implementazione della policy globale.

Per riavviare il rollout di una policy globale, completa i seguenti passaggi:

  • Nel terminale o in Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies update e fornisci l'opzione --rollout-entry-uuid nel seguente modo:

    gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID

    Sostituisci quanto segue:

    • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di ripetizione. Puoi utilizzare qualsiasi generatore di UUID per crearne uno. Per saperne di più, consulta Riprovare un'implementazione.

    • ROLL_OUT_SPEED: la velocità con cui vuoi implementare la policy. I valori supportati sono slow_rollout (consigliato) e fast_rollout. Per saperne di più, vedi Informazioni sui piani di implementazione.

    • In alternativa, puoi utilizzare un piano di implementazione personalizzato specificando l'opzione --rollout-custom-plan. Per saperne di più, vedi Informazioni sui piani di implementazione.

    • Puoi utilizzare --rollout-predefined-plan o --rollout-custom-plan, ma non entrambi nello stesso comando.

Aggiorna una policy globale per escludere le zone

Per aggiornare una policy globale in modo da escludere le zone, completa i seguenti passaggi:

  • Nel terminale o in Cloud Shell, esegui il comando gcloud compute global-vm-extension-policies update e fornisci un piano di implementazione personalizzato che specifichi le zone in cui applicare il criterio:

    gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
    --rollout-retry-uuid=UUID

    Sostituisci quanto segue:

    • NEW_CUSTOM_PLAN_NAME: il nome del nuovo piano di rollout personalizzato che identifica le zone in cui applicare la policy. Per informazioni sulla creazione di piani di implementazione personalizzati, consulta Informazioni sui piani di implementazione.
    • UUID: un identificatore univoco universale (UUID) che identifica la richiesta di ripetizione. Puoi utilizzare qualsiasi generatore di UUID per crearne uno. Per saperne di più, consulta Riprovare un'implementazione.

Disinstallare l'agente da un parco risorse di VM

Per disinstallare l'agente per i workload di calcolo dal parco VM, devi eliminare la policy di VM Extension Manager che gestisce il parco VM.

Durante l'eliminazione di una policy, se un'altra policy attiva a priorità inferiore si applica a una VM e dichiara l'Agent for Compute Workloads, l'agente rimane installato su quella VM in base alla policy a priorità inferiore.

Il gestore di estensioni VM rimuove l'agente da tutte le VM accessibili entro un minuto dall'eliminazione della policy. Se una VM non è accessibile perché l'agente guest è stato rimosso o la VM è stata eliminata, il gestore di estensioni VM salta l'eliminazione dell'Agent for Compute Workloads. Se una VM di questo tipo torna disponibile, il gestore di estensioni VM rimuove l'Agent for Compute Workloads in quel momento.

Per disinstallare l'agente per i carichi di lavoro di Compute dal parco risorse di VM, completa i seguenti passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

    Vai a Policy di estensione VM

  2. Fai clic sul criterio che gestisce l'agente per i carichi di lavoro di Compute sulla flotta di VM.

  3. Nella pagina Dettagli criterio di estensione, fai clic su Elimina e conferma l'eliminazione.

gcloud 

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

  • POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
  • PROJECT_ID: l'ID del Google Cloud progetto in cui si trova la policy.
  • ZONE: la Google Cloud zona in cui si trova la policy.

Verifica l'installazione dell'agente

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

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

  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

    Parametri di configurazione

    Agent for Compute Workloads supporta i seguenti parametri di configurazione per Oracle:

    Parametro Descrizione
    log_level

    String

    Per impostare il livello di logging dell'agente, aggiungi i livelli di log. I livelli di log disponibili sono i seguenti:
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    Il valore predefinito è INFO.
    log_to_cloud

    Boolean

    Per reindirizzare i log dell'agente a Cloud Logging, specifica true. Il valore predefinito è true.
    oracle_configuration.enabled

    Boolean

    Facoltativo. Determina se il servizio Oracle è attivo. Se impostato su true o se non è impostato e il workload è presente, puoi configurare la raccolta di metriche e il rilevamento. Se impostato su false, il servizio Oracle e le relative funzionalità sono disattivati.
    I seguenti parametri secondari sono applicabili solo quando specifichi oracle_configuration.enabled: true.
    oracle_configuration.oracle_discovery.enabled

    Boolean

    Facoltativo. Determina se Oracle Discovery è attivo.

    Il valore predefinito è true.
    oracle_configuration.oracle_discovery.update_frequency

    Int

    Facoltativo. Specifica l'intervallo di campionamento, in secondi, che determina la frequenza con cui Agent for Compute Workloads esegue il processo di rilevamento. Il valore predefinito è 3600 secondi (1 ora).

    Assicurati che il valore termini con una "s" minuscola per indicare i secondi. Ad esempio: 30s.
    oracle_configuration.oracle_metrics.enabled

    Boolean

    Facoltativo. Per consentire ad Agent for Compute Workloads di raccogliere le metriche di monitoraggio di Oracle, specifica true. Il valore predefinito è false.

    I seguenti parametri secondari sono applicabili solo quando specifichi oracle_metrics.enabled: true.
    oracle_configuration.oracle_metrics.collection_frequency

    Int

    Facoltativo. Specifica l'intervallo di campionamento, in secondi, che determina la frequenza con cui Agent for Compute Workloads esegue query sulle istanze di Oracle Database per raccogliere le metriche di monitoraggio di Oracle. Il valore predefinito è 60 secondi.

    Assicurati che il valore termini con una "s" minuscola per indicare i secondi. Ad esempio: 30s.
    oracle_configuration.oracle_metrics.query_timeout

    String

    Facoltativo. Specifica il timeout per ogni query eseguita sulle istanze del database Oracle. Il valore predefinito è 10 secondi.

    Assicurati che il valore termini con una "s" minuscola per indicare i secondi. Ad esempio: 30s.
    oracle_configuration.oracle_metrics.connection_parameters.username

    String

    Specifica l'account utente utilizzato per eseguire query sull'istanza di Oracle Database.

    Assicurati che questo utente disponga delle autorizzazioni necessarie per leggere le viste delle prestazioni nel tuo database Oracle.
    oracle_configuration.oracle_metrics.connection_parameters.host

    String

    Specifica l'identificatore della macchina locale che ospita l'istanza del database.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    Specifica la porta su cui l'istanza di Oracle Database accetta le query.
    oracle_configuration.oracle_metrics.connection_parameters.service_name

    String

    Specifica il nome del servizio per l'istanza del database Oracle che vuoi che l'agente monitori.
    oracle_configuration.oracle_metrics.connection_parameters.secret.project_id

    String

    Specifica l'ID progetto di Secret Manager per recuperare la password per l'utente che esegue query sul database.
    oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name

    String

    Specifica il nome del secret in Secret Manager che memorizza la password dell'account utente.

    Raccogliere e visualizzare le metriche Oracle

    Puoi abilitare la raccolta delle metriche per i workload Oracle Database. Consulta Metriche supportate.

    Abilita la raccolta delle metriche

    Per abilitare la raccolta delle metriche Oracle utilizzando l'Agent for Compute Workloads, esegui le seguenti operazioni:

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Come utente del sistema operativo Oracle, esegui lo strumento oraenv per impostare le variabili di ambiente. Supponiamo che tu abbia già definito l'utente oracle e ORACLE_SID nel file /etc/oratab.

      sudo su - oracle
export PATH=$PATH:/usr/local/bin
. oraenv
sqlplus / as sysdba

    3. Come utente SYSDBA o SYSOPER, in Oracle Database crea un utente per il monitoraggio con una password corrispondente al secret che hai creato nei Prerequisiti.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. In qualità di utente SYSDBA o SYSOPER, concedi le seguenti autorizzazioni all'utente di monitoraggio per eseguire query sulle visualizzazioni del rendimento:

      • SESSION
      • SELECT_CATALOG_ROLE
      • SYSDG
      GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;

    5. Esci da sqlplus e dall'utente oracle.

    6. Come utente root, modifica il file di configurazione dell'agente utilizzando il tuo editor preferito.

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

    7. Nel file di configurazione, modifica la sezione oracle_metrics per apportare i seguenti aggiornamenti:

      1. Imposta il parametro enabled su true.
      2. Imposta il parametro service_name per specificare il nome del servizio dell'istanza Oracle che vuoi che l'agente monitori.
      3. Specifica il nome utente Oracle per l'agente per connettersi al tuo database.
      4. Imposta i parametri host e port per consentire all'agente di connettersi al tuo database.
      5. Imposta il parametro secret affinché l'agente recuperi una password per il nome utente:
        • project_id: l'ID del progetto che contiene i dati di Secret Manager.
        • secret_name: il nome del secret in Secret Manager.

      Di seguito è riportato un esempio di file di configurazione:

      {
  "log_level": "INFO",
  "common_discovery": {"collection_frequency": "3600s" },
  "oracle_configuration": {
    "enabled": true,
    "oracle_metrics": {
      "enabled": true,
      "collection_frequency": "30s",
      "connection_parameters": [
        {
          "host": "localhost",
          "port": 1521,
          "service_name": "orcl",
          "username": "wlmagent",
          "secret": {
            "project_id": "my-project",
            "secret_name": "wlmagent_password"
          }
        }
      ]
    }
  }
}

    8. Salva il file di configurazione.

    9. Riavvia l'agente per applicare le nuove impostazioni.

    Visualizza le metriche

    Puoi visualizzare le metriche raccolte e monitorare le prestazioni e lo stato di Oracle utilizzando Esplora metriche o importando una dashboard personalizzata.

    Visualizzare le metriche in Metrics Explorer

    Per visualizzare le metriche Oracle in Metrics Explorer, segui questi passaggi:

    1. Nella console Google Cloud , vai a Monitoring.
    2. Fai clic su Esplora metriche.
    3. Nella sezione Trova tipo di risorsa e metrica, segui questi passaggi:
      1. In Tipo di risorsa, seleziona Istanza VM.
      2. Per Metrica, seleziona le metriche Oracle che vuoi visualizzare.

    Puoi visualizzare i dati in tempo reale e storici per le metriche Oracle selezionate, utilizzando filtri e aggregazione in base alle esigenze.

    Importare una dashboard personalizzata

    Per visualizzare le metriche Oracle raccolte dall'agente, puoi creare dashboard Cloud Monitoring personalizzate seguendo le istruzioni riportate in Crea e gestisci dashboard personalizzate.

    Forniamo una dashboard di esempio oracle-status-overview.json e istruzioni su come importarla. La dashboard oracle-status-overview.json mostra i seguenti grafici delle metriche Oracle:

    • Suddivisione del tempo di database
    • Memoria utilizzata dal database
    • Sessioni attive medie per classe di attesa
    • I/O disco
    • Utilizzo CPU
    • Traffico di rete

    Per importare la dashboard oracle-status-overview.json:

    1. Verifica che gcloud CLI sia installato e aggiornato. Per istruzioni, vedi Installa gcloud CLI.

    2. Dal repository GitHub di Agent for Compute Workloads, scarica la dashboard oracle-status-overview.json:

      $ curl -H "Accept: application/vnd.github.v3.raw" -o oracle-status-overview.json https://api.github.com/repos/GoogleCloudPlatform/workloadagent/contents/observability/dashboards/oracle-status-overview.json

    3. Esegui questo comando per importare il dashboard:

      gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json

      Dopo l'esecuzione del comando, la dashboard personalizzata viene creata in Cloud Monitoring. Per scoprire come visualizzare una dashboard, vedi Trovare e visualizzare una dashboard.

    Metriche supportate

    Tutte le metriche Oracle raccolte da Agent for Compute Workloads sono disponibili nel percorso workload.googleapis.com/oracle.

    Di seguito è riportato un elenco delle metriche Oracle supportate e dei relativi percorsi di Cloud Monitoring:

    • Memoria del processo

      • Memoria del processo (PGA) in uso, in byte.

        process/pga_memory/total_used_size

      • Memoria processo (PGA) allocata, in byte

        process/pga_memory/total_allocated_size

    • Memoria condivisa

      • Dimensioni dell'elemento della memoria condivisa (SGA), in byte

        process/sga_memory/size

    • Eventi di attesa del sistema

      • Numero totale di attese per una classe di attesa registrata

        sys_wait/count

      • Tempo totale trascorso in questa classe di attesa, in secondi

        sys_wait/time

      • Attese totali in primo piano in questa classe di attesa

        sys_wait/foreground/count

      • Tempo di attesa in primo piano aggregato per questa classe di attesa, in secondi

        sys_wait/foreground/time

    • Tempo trascorso del sistema

      • Tempo trascorso a eseguire chiamate a livello di utente del database, in secondi

        sys_time/db_time

      • Tempo CPU dedicato alle chiamate a livello di utente del database, in secondi

        sys_time/db_cpu

      • Quantità di tempo trascorso durante l'esecuzione delle istruzioni SQL

        sys_time/sql_execute_elapsed_time

      • Quantità di tempo trascorso nell'analisi delle istruzioni SQL

        sys_time/parse_time_elapsed

      • Quantità di tempo trascorso a eseguire l'interprete PL/SQL

        sys_time/pl_sql_execution_elapsed_time

      • Tempo trascorso consumato dai processi in background del database, in secondi

        sys_time/background_elapsed_time

    • Statistiche I/O

      • Conteggio totale delle operazioni di lettura (piccole + grandi)

        iostat/read_ops_count

      • Conteggio totale delle operazioni di scrittura (piccole + grandi)

        iostat/write_ops_count

      • Numero totale di byte letti

        iostat/read_bytes_count

      • Numero totale di byte scritti

        iostat/write_bytes_count

      • Latenza media per operazione di I/O

        iostat/average_latency_seconds

    • File di dati

      • Dimensioni allocate del file di dati, in byte

        data_files/total_bytes

      • Spazio del file di dati in uso, in byte

        data_files/bytes_used

      • Spazio libero nel file di dati, in byte

        data_files/available_bytes

      • Limite di estensione automatica del file di dati, in byte

        data_files/max_bytes

      • Percentuale del file di dati utilizzata

        data_files/percent_used

    • Istanza di database

      • Uptime dell'istanza, in secondi

        instance/uptime

      • Stato istanza

        instance/status

        Questa metrica può avere i seguenti valori:

        UNKNOWN 0
        STARTED 1
        MOUNTED 2
        OPEN 3
        OPEN MIGRATE 4

      • Modalità aperta

        instance/db_open_mode

        Questa metrica può avere i seguenti valori:

        UNKNOWN 0
        MOUNTED 1
        READ WRITE 2
        READ ONLY 3
        READ ONLY WITH APPLY 4

    • Oracle Data Guard

      • Ritardo di applicazione del rifacimento, in secondi

        dataguard/apply_lag

      • Ritardo di ritrasmissione, in secondi

        dataguard/transport_lag

    Gestire l'agente

    Riavvia l'agente

    Se Agent for Compute Workloads smette di funzionare o ne aggiorni la configurazione, riavvialo.

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Esegui questo comando:

      sudo systemctl restart google-cloud-workload-agent

    Controllare la versione dell'agente

    Per controllare la versione dell'agente, completa i seguenti passaggi:

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Esegui questo comando:

      yum info google-cloud-workload-agent

    Verifica la disponibilità di aggiornamenti

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Esegui questo comando:

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

    Aggiornare l'agente

    Per assicurarti di avere l'ultima versione dell'agente, controlla periodicamente la disponibilità di aggiornamenti e aggiorna l'agente:

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Esegui questo comando:

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

    Visualizzare i log dell'agente

    I log di Agent for Compute Workloads sono disponibili all'indirizzo /var/log/google-cloud-workload-agent.log.

    Il livello di dettaglio dei log è controllato dal parametro log_level. L'impostazione del livello di log DEBUG include informazioni aggiuntive per la risoluzione di problemi specifici, ma produce log molto più grandi.

    Per impostazione predefinita, i log di Agent for Compute Workloads vengono reindirizzati dalle istanze VM a Cloud Logging.

    Per visualizzare i log dell'agente in Logging, segui questi passaggi:

    1. Nella console Google Cloud , vai alla pagina Esplora log.

      Vai a Esplora log

    2. Vai al riquadro Query.

    3. Dal menu a discesa Risorse, seleziona Globale e poi fai clic su Applica.

    4. Nell'editor di query, inserisci google-cloud-workload-agent.

    5. Fai clic su Esegui query.

    Puoi visualizzare i log generati dall'agente in esecuzione su tutte le tue istanze VM. Puoi filtrare i log per un'istanza specifica.

    Configura i log dell'agente in Cloud Logging

    Per disabilitare il reindirizzamento predefinito dei log dell'agente a Cloud Logging, segui questi passaggi:

    1. Utilizza SSH per connetterti all'istanza VM.

    2. Apri il file di configurazione dell'agente:

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

    3. Per la proprietà log_to_cloud, aggiorna il valore a false.

    4. Salva il file di configurazione.

    5. Riavvia l'agente affinché questa modifica abbia effetto.

    Risoluzione dei problemi

    Le sezioni seguenti forniscono informazioni sui problemi comuni relativi all'utilizzo dell'agente per i carichi di lavoro Oracle Database, sulle relative cause e sulla risoluzione.

    Autorizzazioni IAM insufficienti

    Problema: i log dell'Agent for Compute Workloads mostrano un errore di autorizzazioni IAM insufficienti.

    googleapi: Error 403: The client is not authorized to make this request.

    Causa: il account di servizio utilizzato dall'agente non dispone delle autorizzazioni IAM richieste per accedere alle API Google Cloud o a una password per l'utente Oracle in Secret Manager.

    Risoluzione:per risolvere il problema, assicurati che il account di servizio VM disponga dei ruoli e delle autorizzazioni IAM menzionati nei prerequisiti.

    Ambiti di autenticazione insufficienti

    Problema: i log di Agent for Compute Workloads mostrano ambiti di autenticazione insufficienti.

    googleapi: Error 403: Request had insufficient authentication scopes.

    Causa: Il account di servizio utilizzato dall'agente non dispone dell'ambito di accesso richiesto.

    Soluzione:per risolvere il problema, configura gli ambiti di accesso della VM su cloud-platform.

    Le metriche non vengono visualizzate in Cloud Monitoring

    Problema: le metriche dell'Agent for Compute Workloads non sono visibili in Cloud Monitoring.

    Causa:

    Di seguito sono elencate le possibili cause di questo problema:

    • Il account di servizio utilizzato dall'Agent for Compute Workloads non dispone delle autorizzazioni IAM necessarie.
    • L'utente Oracle utilizzato dall'agente non dispone di privilegi sufficienti per eseguire query sulle viste delle prestazioni.
    • La configurazione dell'agente contiene errori.

    Risoluzione:

    • Per risolvere il problema delle autorizzazioni insufficienti per il account di servizio:

      1. Nella console Google Cloud , vai alla pagina Dettagli dell'istanza VM e annotati ilaccount di serviziot utilizzato dall'istanza che esegue l'agente.
      2. Vai alla pagina IAM e amministrazione e assicurati che il account di servizio disponga di tutti i ruoli e le autorizzazioni richiesti menzionati nei prerequisiti. Concedi all'account di servizio uno dei ruoli obbligatori mancanti.

    • Per risolvere il problema delle autorizzazioni insufficienti per l'utente Oracle:

      1. Verifica che l'utente Oracle disponga delle seguenti autorizzazioni richieste per eseguire query sulle visualizzazioni delle prestazioni:

        • SESSION
        • SELECT_CATALOG_ROLE
        • SYSDG

      2. Concedi le autorizzazioni mancanti eseguendo il seguente comando SQL:

        -- Grant the "wlmagent" user the required permissions
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;

    • Per risolvere il problema di configurazione errata dell'agente:

      1. Utilizza SSH per connetterti all'istanza VM.

      2. Esamina i log dell'agente per identificare eventuali errori o problemi che impediscono la raccolta delle metriche. Puoi trovare i log in /var/log/google-cloud-workload-agent.log.

        Cerca errori di autorizzazione, errori di configurazione o problemi di connettività.

      3. Risolvi eventuali errori.

      4. Riavvia l'agente e controlla se la raccolta delle metriche viene avviata.

    Impossibile caricare il file di configurazione

    Problema:se il file di configurazione contiene valori non validi, viene visualizzato il seguente errore. 

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

    Risoluzione:per risolvere il problema, aggiorna il file di configurazione utilizzando i dettagli in Parametri di configurazione.

    Impossibile inizializzare la raccolta dei dati

    Problema: dopo l'installazione dell'agente, se il file di configurazione non viene aggiornato, viene visualizzato il seguente errore: 

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

    Soluzione:per risolvere il problema, inizializza la configurazione delle credenziali utilizzando i parametri di configurazione.