Configurar o agente para cargas de trabalho da Oracle

Neste documento, mostramos como instalar, configurar e verificar o Agente para cargas de trabalho computacionais em instâncias do Compute Engine que executam cargas de trabalho do Oracle Database.

O agente coleta várias métricas do Oracle consultando visualizações de desempenho do Oracle Database (como V$DATABASE, V$INSTANCE e V$DATAGUARD_STATS) e visualizações do dicionário de dados (como DBA_DATA_FILES e DBA_FREE_SPACE). Essas métricas são enviadas ao Cloud Monitoring, onde podem ser visualizadas e analisadas. Consulte Métricas compatíveis.

Antes de começar

Antes de instalar o Agente para cargas de trabalho computacionais para monitorar suas cargas de trabalho do Oracle Database, verifique se os seguintes pré-requisitos foram atendidos:

Revisar os requisitos do sistema

A tabela a seguir lista as edições da Oracle que podem ser usadas e as versões de sistemas operacionais compatíveis:

Sistemas operacionais Versões do Oracle Edições do Oracle
  • Red Hat Enterprise Linux versões 7, 8 e 9
  • Versões 7, 8 e 9 do Oracle Linux
  • Oracle Database 19c
  • Oracle Database 23ai*
  • Enterprise Edition
  • Standard Edition
  • Edição Express (sem custo financeiro)

Conceder papéis do IAM à conta de serviço

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

Para melhorar a segurança, recomendamos que você use uma conta de serviço de uso único em vez da conta de serviço padrão do Compute Engine.

Para garantir que a conta de serviço tenha as permissões necessárias para permitir que o agente para cargas de trabalho do Compute se autentique com Google Cloud e acesse recursos do Google Cloud , peça ao administrador para conceder os seguintes papéis do IAM à conta de serviço no seu projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à conta de serviço as permissões necessárias por meio de papéis personalizados ou outros papéis predefinidos.

Ativar o acesso às APIs do Cloud

O Compute Engine recomenda configurar as instâncias para permitir todos os escopos de acesso a todas as APIs do Cloud e usar apenas as permissões do IAM da conta de serviço da instância para controlar o acesso aos recursos doGoogle Cloud . Para mais informações, consulte Criar uma VM que usa uma conta serviço gerenciado pelo usuário.

Se você limitar o acesso às APIs do Cloud, o Agente para cargas de trabalho computacionais vai exigir, no mínimo, os seguintes escopos de acesso às APIs do Cloud na instância de computação do host:

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

Para mais informações, consulte Práticas recomendadas para escopos.

Se você estiver executando uma carga de trabalho do Oracle em uma instância de computação que não tem um endereço IP externo, ative o Acesso Privado do Google na sub-rede da instância para que o Agente para cargas de trabalho computacionais possa acessar as APIs e os serviços do Google. Para saber como ativar o Acesso privado do Google, consulte Configurar o Acesso privado do Google.

Instalar e configurar o agente usando o gerenciador de pacotes

Nesta seção, mostramos como instalar o Agente para cargas de trabalho computacionais na sua instância de computação e configurá-lo para se conectar a uma instância do Oracle usando um gerenciador de pacotes.

Para instalar o Agente para cargas de trabalho computacionais, siga estas etapas:

  1. Crie um arquivo de configuração do repositório.

    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. Atualize os metadados do gerenciador de pacotes:

    sudo yum makecache

  3. Instale o pacote rpm google-cloud-workload-agent:

    sudo yum install google-cloud-workload-agent

Depois de instalar o agente para cargas de trabalho do Oracle, verifique a instalação do agente.

Instalar e gerenciar o agente em uma frota de VMs usando o Gerenciador de extensões de VM

Nesta seção, mostramos como instalar e gerenciar o Agente para cargas de trabalho computacionais em uma frota de VMs usando o Gerenciador de extensões de VM.

Com a política do Gerenciador de extensões de VM, você pode realizar tarefas como as seguintes:

  • Instalação em toda a frota: instale o Agente para cargas de trabalho computacionais nos seguintes itens:
    • Todas as VMs no seu projeto Google Cloud ou um subconjunto de VMs identificadas por rótulos.
    • Todas as VMs em uma zona ou um subconjunto de VMs identificadas por rótulos.
  • Gerenciamento de configuração: aplique uma configuração personalizada ao agente em todas as VMs gerenciadas por uma política.

Para mais informações sobre o gerenciador de extensões de VM, consulte Sobre o gerenciador de extensões de VM.

Configurar o Gerenciador de extensões de VM

Para configurar o Gerenciador de extensões de VM, siga estas etapas:

Instalar e configurar o agente em uma frota de VMs

Para instalar a versão mais recente do Agente para cargas de trabalho computacionais na sua frota de VMs usando uma política do Gerenciador de extensões de VM, consulte a seção adequada:

Instale e configure o agente em VMs no seu projeto Google Cloud

Para instalar o agente em todas as VMs do projeto Google Cloud ou em um subconjunto de VMs identificadas por um rótulo usando uma política do Gerenciador de extensões de VM, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique em Criar política de extensão.

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

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

  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Na seção Escopo, selecione Implantação global.

  7. Na seção Gerenciar extensões, clique em Adicionar extensão e 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 Versão em branco.

      Isso direciona a política para instalar a versão mais recente do Agente para cargas de trabalho computacionais.

    3. No campo Conteúdo do arquivo de configuração, insira a configuração que você quer aplicar ao agente.

      Para informações sobre os parâmetros de configuração aceitos pelo agente para sua carga de trabalho do Oracle, consulte Parâmetros de configuração.

    4. Clique em Concluído.

    5. No campo Lançamento, selecione a opção de plano de lançamento que você quer usar: Lançamento lento (recomendado) ou Lançamento rápido.

      Para informações sobre planos de lançamento, consulte Sobre os planos de lançamento.

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

    1. Clique em Adicionar rótulos e inclua os rótulos que identificam as VMs necessárias.
    2. Clique em Concluído.

  9. Clique em Criar.

gcloud

No terminal ou no Cloud Shell, execute o 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]

Substitua:

  • POLICY_NAME: um nome exclusivo para a política de extensão de VM.
  • PROJECT_ID: o ID do projeto do Google Cloud projeto para o qual você está criando a política

  • ROLL_OUT_SPEED: a rapidez com que você quer lançar a política. Os valores aceitos são slow_rollout (recomendado) e fast_rollout. Para mais informações, consulte Sobre os planos de lançamento.

  • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.

  • Você pode usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

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

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração do Agente para cargas de trabalho computacionais.

    • Como 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".
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai segmentar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai segmentar todas as VMs no projeto.

  • PRIORITY: um número inteiro de 0 a 65535 que define a prioridade da política. Números menores indicam maior prioridade. O valor padrão é 1000. Para mais informações, consulte Prioridade e resolução de conflitos de políticas.

Instalar e configurar o agente em VMs em uma zona específica

Para instalar e configurar a versão mais recente do Agente para cargas de trabalho computacionais na sua frota de VMs em uma zona específica usando uma política do Gerenciador de extensões de VM, conclua as etapas a seguir:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique em Criar política de extensão.

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

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

  5. No campo Prioridade, especifique um número de prioridade para resolver conflitos entre políticas. Números menores indicam maior prioridade. O valor padrão é 1000.

  6. Nas listas Região e Zona, selecione a zona em que você quer aplicar essa política.

  7. Na seção Gerenciar extensões, clique em Adicionar extensão e 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 Versão em branco.

      Isso direciona a política para instalar a versão mais recente do Agente para cargas de trabalho computacionais.

    3. No campo Conteúdo do arquivo de configuração, insira a configuração que você quer aplicar ao agente.

      Para informações sobre os parâmetros de configuração aceitos pelo agente para sua carga de trabalho do Oracle, consulte Parâmetros de configuração.

    4. Clique em Concluído.

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

    1. Clique em Adicionar rótulos e inclua os rótulos que identificam as VMs necessárias.
    2. Clique em Concluído.

  9. Clique em Criar.

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]

Substitua:

  • 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 em que você quer aplicar essa política.

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração para o Agente para cargas de trabalho computacionais se conectar com sua carga de trabalho do Oracle.

    • Como 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 o uso de --config-from-file.
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente para sua carga de trabalho do Oracle, consulte Parâmetros de configuração.

  • 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 os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai direcionar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai direcionar todas as VMs na zona especificada.

  • PRIORITY: um número inteiro de 0 a 65535 que define a prioridade da política. Números menores indicam maior prioridade. O valor padrão é 1000.

Exemplo:

O comando a seguir cria uma política chamada test-agent-policy no projetoGoogle Cloud chamado test-project, que instala a versão mais recente do Agente para cargas de trabalho computacionais em todas as VMs implantadas na zona us-centrail-f. A configuração especificada no agent-config.json é aplicada ao 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"

Gerenciar o agente em uma frota de VMs

Para mudar como uma política do Gerenciador de extensões de VM gerencia o Agente para cargas de trabalho computacionais, atualize a política. Quando você atualiza uma política, o Gerenciador de extensões de VM implanta as mudanças em todas as VMs aplicáveis, normalmente em um minuto. Se você modificar os rótulos de inclusão, o Agente para cargas de trabalho computacionais poderá ser instalado em novas VMs ou desinstalado de VMs atuais, dependendo se as VMs corresponderem aos rótulos atualizados.

As seções a seguir mostram como gerenciar o Agente para cargas de trabalho computacionais para fazer o seguinte:

Modificar a configuração do agente em uma frota de VMs

Para modificar a configuração das instâncias do Agente para cargas de trabalho computacionais que você instalou na sua frota de VMs usando uma política do Gerenciador de extensões de VM, edite essa política.

Para modificar a configuração do agente na sua frota de VMs, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique na política que você quer modificar.

  3. Na página Detalhes da política de extensão, clique em Editar.

  4. Na seção Gerenciar extensões, ative a Extensão do Google Cloud para cargas de trabalho computacionais.

  5. No campo Conteúdo do arquivo de configuração, insira a configuração que você quer aplicar ao agente.

    Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  6. Clique em Concluído.

  7. Clique em Salvar.

gcloud

Para modificar a configuração do Agente para cargas de trabalho computacionais na frota de VMs, execute o comando gcloud compute zone-vm-extension-policies update. Quando você atualiza uma política usando a gcloud, a solicitação funciona como uma substituição completa. Os campos opcionais omitidos voltam aos valores padrão, em vez de manter os valores da política modificada.

Para modificar a configuração do 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"]

Substitua:

  • POLICY_NAME: o nome da política de extensão de VM que você quer modificar.
  • ZONE: a Google Cloud zona em que a política é aplicada.

  • CONFIG_FILE_PATH: o caminho local para o arquivo JSON que contém a configuração do Agente para cargas de trabalho computacionais.

    • Também é possível fornecer a configuração do agente como uma string inline usando a flag --config em vez de --config-from-file. Por exemplo, --config=google-cloud-workload-extension="CONFIG". OGoogle Cloud recomenda o uso de --config-from-file.
    • É possível usar --config-from-file ou --config, mas não ambos no mesmo comando.
    • Para informações sobre os parâmetros de configuração aceitos pelo agente, consulte Parâmetros de configuração.

  • KEY_1=VALUE_1: uma lista separada por vírgulas de pares de chave-valor que definem os rótulos usados pela política para segmentar VMs.

    • Para que uma VM seja segmentada pela sua política, ela precisa ter todos os rótulos especificados.
    • Se você especificar --inclusion-labels várias vezes, a política vai direcionar VMs que correspondam a qualquer um dos seletores fornecidos (OR lógico). Se você omitir essa flag, a política vai direcionar todas as VMs na zona especificada.

  • PRIORITY_NUMBER: a prioridade que você quer definir para sua política. É possível especificar um número inteiro de 0 a 65535.

  • DESCRIPTION: uma descrição da política de extensão de VM.

Atualizar uma política global para incluir novas zonas

Quando você cria VMs em uma nova zona depois de criar e implantar uma política global, o Gerenciador de extensões de VM não aplica automaticamente a política às VMs nas novas zonas. Para incluir as VMs em novas zonas, reinicie a implantação da política global.

Para reiniciar o lançamento de uma política global, siga estas etapas:

  • No terminal ou no Cloud Shell, execute o comando gcloud compute global-vm-extension-policies update e forneça a opção --rollout-entry-uuid da seguinte maneira:

    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

    Substitua:

    • UUID: um identificador universalmente exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Repetir um lançamento.

    • ROLL_OUT_SPEED: a rapidez com que você quer lançar a política. Os valores aceitos são slow_rollout (recomendado) e fast_rollout. Para mais informações, consulte Sobre os planos de lançamento.

    • Como alternativa, é possível usar um plano de lançamento personalizado especificando a opção --rollout-custom-plan. Para mais informações, consulte Sobre os planos de lançamento.

    • Você pode usar --rollout-predefined-plan ou --rollout-custom-plan, mas não ambos no mesmo comando.

Atualizar uma política global para excluir zonas

Para atualizar uma política global e excluir zonas, siga estas etapas:

  • No terminal ou no Cloud Shell, execute o comando gcloud compute global-vm-extension-policies update e forneça um plano de lançamento personalizado que especifique as zonas em que a política será aplicada:

    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

    Substitua:

    • NEW_CUSTOM_PLAN_NAME: o nome do novo plano de implantação personalizada que identifica as zonas em que a política será aplicada. Para informações sobre como criar planos de lançamento personalizados, consulte Sobre planos de lançamento.
    • UUID: um identificador universalmente exclusivo (UUID) que identifica a solicitação de nova tentativa. Você pode usar qualquer gerador de UUID para criar um. Para mais informações, consulte Repetir um lançamento.

Desinstalar o agente de uma frota de VMs

Para desinstalar o Agente para cargas de trabalho computacionais da sua frota de VMs, exclua a política do Gerenciador de extensões de VM que gerencia a frota.

Ao excluir uma política, se outra política ativa de menor prioridade for aplicada a uma VM e declarar o Agente para cargas de trabalho computacionais, o agente vai permanecer instalado nessa VM com base na política de menor prioridade.

O Gerenciador de extensões de VM remove o agente de todas as VMs acessíveis em até um minuto após a exclusão da política. Se uma VM estiver inacessível porque o agente convidado foi removido ou a VM foi excluída, o Gerenciador de extensões de VM vai pular a exclusão do Agente para cargas de trabalho computacionais. Se uma VM assim ficar disponível novamente, o Gerenciador de extensões de VM vai remover o Agente para cargas de trabalho computacionais.

Para desinstalar o Agente para cargas de trabalho computacionais da sua frota de VMs, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Políticas de extensão de VM.

    Acessar políticas de extensão de VM

  2. Clique na política que gerencia o Agente para cargas de trabalho computacionais na sua frota de VMs.

  3. Na página Detalhes da política de extensão, clique em Excluir e confirme a exclusão.

gcloud 

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

Substitua:

  • POLICY_NAME: o nome da política de extensão de VM que você quer excluir.
  • PROJECT_ID: o ID do Google Cloud projeto em que a política está localizada.
  • ZONE: a Google Cloud zona em que a política está localizada.

Verificar a instalação do agente

Para verificar se o agente está sendo executado conforme o esperado, siga estas etapas:

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

  2. Verifique o status do pacote do agente:

    systemctl status google-cloud-workload-agent

    Se o pacote do agente estiver funcionando conforme esperado, a saída vai conter active (running). 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

    O Agente para cargas de trabalho computacionais é compatível com os seguintes parâmetros de configuração para o Oracle:

    Parâmetro Descrição
    log_level

    String

    Para definir o nível de geração de registros do agente, adicione-os. Os níveis de registro disponíveis são os seguintes:
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    O padrão é INFO.
    log_to_cloud

    Boolean

    Para redirecionar os registros do agente para o Cloud Logging, especifique true. O padrão é true.
    oracle_configuration.enabled

    Boolean

    Opcional. Determina se o serviço do Oracle está ativo. Quando definido como true ou se não estiver definido e a carga de trabalho estiver presente, você poderá configurar a descoberta e a coleta de métricas. Se definido como false, o serviço do Oracle e as funcionalidades relacionadas serão desativados.
    Os parâmetros filhos a seguir são aplicáveis somente quando você especifica oracle_configuration.enabled: true.
    oracle_configuration.oracle_discovery.enabled

    Boolean

    Opcional. Determina se o Oracle Discovery está ativo.

    O valor padrão é true.
    oracle_configuration.oracle_discovery.update_frequency

    Int

    Opcional. Especifique o intervalo de amostra, em segundos, que determina a frequência com que o Agente para Cargas de Trabalho Computacionais executa o processo de descoberta. O valor padrão é de 3.600 segundos (1 hora).

    Verifique se o valor termina com um "s" minúsculo para indicar segundos. Por exemplo: 30s.
    oracle_configuration.oracle_metrics.enabled

    Boolean

    Opcional. Para permitir que o Agente para cargas de trabalho computacionais colete as métricas de monitoramento do Oracle, especifique true. O valor padrão é false.

    Os parâmetros filhos a seguir são aplicáveis somente quando você especifica oracle_metrics.enabled: true.
    oracle_configuration.oracle_metrics.collection_frequency

    Int

    Opcional. Especifique o intervalo de amostra, em segundos, que determina a frequência com que o Agente para cargas de trabalho computacionais consulta as instâncias do banco de dados Oracle para coletar as métricas de monitoramento do Oracle. O valor padrão é de 60 segundos.

    Verifique se o valor termina com um "s" minúsculo para indicar segundos. Por exemplo: 30s.
    oracle_configuration.oracle_metrics.query_timeout

    String

    Opcional. Especifique o tempo limite de cada consulta feita às instâncias do Oracle Database. O valor padrão é de 10 segundos.

    Verifique se o valor termina com um "s" minúsculo para indicar segundos. Por exemplo: 30s.
    oracle_configuration.oracle_metrics.connection_parameters.username

    String

    Especifica a conta de usuário usada para consultar a instância do Oracle Database.

    Verifique se esse usuário tem as permissões necessárias para ler as visualizações de desempenho no banco de dados Oracle.
    oracle_configuration.oracle_metrics.connection_parameters.host

    String

    Especifica o identificador da máquina local que hospeda a instância do banco de dados.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    Especifica a porta em que a instância do Oracle Database aceita consultas.
    oracle_configuration.oracle_metrics.connection_parameters.service_name

    String

    Especifica o nome do serviço da instância do Oracle Database que você quer que o agente monitore.
    oracle_configuration.oracle_metrics.connection_parameters.secret.project_id

    String

    Especifica o ID do projeto do Secret Manager para recuperar a senha do usuário que faz consultas no banco de dados.
    oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name

    String

    Especifica o nome do secret no Secret Manager que armazena a senha da conta de usuário.

    Coletar e visualizar métricas do Oracle

    É possível ativar a coleta de métricas para cargas de trabalho do Oracle Database. Consulte Métricas compatíveis.

    Ativar a coleta de métricas

    Para ativar a coleta de métricas do Oracle usando o Agente para cargas de trabalho computacionais, faça o seguinte:

    1. Use o SSH para se conectar à instância de VM.

    2. Como usuário do SO Oracle, execute a ferramenta oraenv para definir as variáveis de ambiente. Presumimos que você já definiu o usuário oracle e o ORACLE_SID no arquivo /etc/oratab.

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

    3. Como usuário SYSDBA ou SYSOPER, no Oracle Database, crie um usuário para monitoramento com uma senha que corresponda ao secret criado nos Pré-requisitos.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. Como usuário SYSDBA ou SYSOPER, conceda as seguintes permissões ao usuário de monitoramento para consultar visualizações de desempenho:

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

    5. Saia do sqlplus e do usuário oracle.

    6. Como usuário raiz, edite o arquivo de configuração do agente usando o editor de sua preferência.

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

    7. No arquivo de configuração, edite a seção oracle_metrics para fazer as seguintes atualizações:

      1. Defina o parâmetro enabled como true.
      2. Defina o parâmetro service_name para especificar o nome do serviço da instância do Oracle que você quer que o agente monitore.
      3. Especifique o nome de usuário do Oracle para que o agente se conecte ao seu banco de dados.
      4. Defina os parâmetros host e port para que o agente se conecte ao seu banco de dados.
      5. Defina o parâmetro secret para que o agente recupere uma senha para o nome de usuário:
        • project_id: o ID do projeto que contém os dados do Secret Manager.
        • secret_name: o nome do secret no Secret Manager.

      Confira a seguir um exemplo de arquivo de configuração:

      {
  "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. Salve o arquivo de configuração.

    9. Reinicie o agente para que as novas configurações entrem em vigor.

    Ver as métricas

    É possível conferir as métricas coletadas e monitorar o desempenho e o status do Oracle usando o Metrics Explorer ou importando um painel personalizado.

    Ver métricas no Metrics Explorer

    Para conferir as métricas do Oracle no Metrics Explorer, faça o seguinte:

    1. No console do Google Cloud , acesse o Monitoring.
    2. Clique em Metrics Explorer.
    3. Em Encontrar tipo de recurso e métrica, faça o seguinte:
      1. Em Tipo de recurso, selecione Instância de VM.
      2. Em Métrica, selecione as métricas do Oracle que você quer visualizar.

    É possível conferir dados em tempo real e históricos das métricas do Oracle selecionadas, usando filtros e agregação conforme necessário.

    Importar um painel personalizado

    Para conferir as métricas do Oracle coletadas pelo agente, crie painéis personalizados do Cloud Monitoring seguindo as instruções em Criar e gerenciar painéis personalizados.

    Fornecemos um exemplo de painel oracle-status-overview.json e instruções sobre como importá-lo. O painel oracle-status-overview.json mostra os seguintes gráficos de métricas do Oracle:

    • Detalhamento do tempo de banco de dados
    • Uso da memória do banco de dados
    • Média de sessões ativas por classe de espera
    • E/S de disco
    • Uso da CPU
    • Tráfego de rede

    Para importar o painel oracle-status-overview.json, faça o seguinte:

    1. Verifique se a CLI gcloud está instalada e atualizada. Para instruções, consulte Instalar a CLI gcloud.

    2. No repositório do GitHub do Agente para cargas de trabalho computacionais, faça o download do painel 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. Execute o comando a seguir para importar o painel:

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

      Depois que o comando for executado, o painel personalizado será criado no Cloud Monitoring. Para saber como acessar um painel, consulte Encontrar e acessar um painel.

    Métricas disponíveis

    Todas as métricas do Oracle coletadas pelo Agente para cargas de trabalho computacionais estão disponíveis no caminho workload.googleapis.com/oracle.

    Confira a seguir uma lista de métricas do Oracle compatíveis e os caminhos correspondentes do Cloud Monitoring:

    • Memória do processo

      • Memória de processo (PGA) em uso, em bytes.

        process/pga_memory/total_used_size

      • Memória do processo (PGA) alocada, em bytes

        process/pga_memory/total_allocated_size

    • Recordação compartilhada

      • Tamanho do item de memória compartilhada (SGA) em bytes.

        process/sga_memory/size

    • Eventos de espera do sistema

      • Número total de esperas para uma classe de espera registrada

        sys_wait/count

      • Tempo agregado gasto nessa classe de espera, em segundos

        sys_wait/time

      • Total de esperas em primeiro plano nesta classe de espera

        sys_wait/foreground/count

      • Tempo agregado de espera em primeiro plano para essa classe de espera, em segundos

        sys_wait/foreground/time

    • Tempo decorrido do sistema

      • Tempo decorrido gasto na execução de chamadas no nível do usuário do banco de dados, em segundos.

        sys_time/db_time

      • Tempo de CPU gasto em chamadas no nível do usuário do banco de dados, em segundos

        sys_time/db_cpu

      • Quantidade de tempo decorrido em que as instruções SQL estão sendo executadas

        sys_time/sql_execute_elapsed_time

      • Quantidade de tempo decorrido gasto na análise de instruções SQL

        sys_time/parse_time_elapsed

      • Quantidade de tempo decorrido gasto executando o interpretador PL/SQL.

        sys_time/pl_sql_execution_elapsed_time

      • Tempo decorrido consumido por processos em segundo plano do banco de dados, em segundos.

        sys_time/background_elapsed_time

    • Estatísticas de E/S

      • Contagem total de operações de leitura (pequenas + grandes)

        iostat/read_ops_count

      • Contagem total de operações de gravação (pequenas + grandes)

        iostat/write_ops_count

      • Número total de bytes lidos

        iostat/read_bytes_count

      • Número total de bytes gravados

        iostat/write_bytes_count

      • Latência média por operação de E/S

        iostat/average_latency_seconds

    • arquivos de dados

      • Tamanho alocado do arquivo de dados, em bytes

        data_files/total_bytes

      • Espaço em uso do arquivo de dados, em bytes

        data_files/bytes_used

      • Espaço livre do arquivo de dados, em bytes

        data_files/available_bytes

      • Limite de extensão automática de arquivo de dados, em bytes

        data_files/max_bytes

      • Porcentagem do arquivo de dados usado

        data_files/percent_used

    • Instância de banco de dados

      • Tempo de atividade da instância, em segundos

        instance/uptime

      • Status da instância

        instance/status

        Essa métrica pode ter os seguintes valores:

        UNKNOWN 0
        STARTED 1
        MOUNTED 2
        OPEN 3
        OPEN MIGRATE 4

      • Modo aberto

        instance/db_open_mode

        Essa métrica pode ter os seguintes valores:

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

    • Oracle Data Guard

      • Atraso para refazer a ação, em segundos

        dataguard/apply_lag

      • Refazer o atraso do transporte, em segundos

        dataguard/transport_lag

    Gerenciar o agente

    Reinicie o agente.

    Se o Agente para cargas de trabalho computacionais parar de funcionar ou você atualizar a configuração, reinicie o agente.

    1. Use o SSH para se conectar à instância de VM.

    2. Execute este comando:

      sudo systemctl restart google-cloud-workload-agent

    Verificar a versão do agente

    Para acessar a versão do agente, siga estas etapas:

    1. Use o SSH para se conectar à instância de VM.

    2. Execute este comando:

      yum info google-cloud-workload-agent

    Verificar se há atualizações

    1. Use o SSH para se conectar à instância de VM.

    2. Execute este comando:

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

    Atualizar o agente

    Para garantir que você tenha a versão mais recente do agente, verifique se há atualizações periodicamente e atualize o agente:

    1. Use o SSH para se conectar à instância de VM.

    2. Execute este comando:

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

    Ver registros do agente

    Os registros do Agente para cargas de trabalho computacionais estão disponíveis em /var/log/google-cloud-workload-agent.log.

    O nível de detalhe do registro é controlado pelo parâmetro log_level. Definir o nível de registro DEBUG inclui mais informações para resolver problemas específicos, mas gera registros muito maiores.

    Por padrão, os registros do Agente para cargas de trabalho computacionais são redirecionados das instâncias de VM para o Cloud Logging.

    Para ver os registros do agente no Logging, siga estas etapas:

    1. No console do Google Cloud , acesse a página Análise de registros.

      Acessar o "Explorador de registros"

    2. Acesse o painel Consulta.

    3. No menu suspenso Recursos, selecione Global e clique em Aplicar.

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

    5. Clique em Executar consulta.

    É possível conferir os registros gerados pelo agente em execução em todas as instâncias de VM. É possível filtrar os registros de uma instância específica.

    Configurar registros de agente no Cloud Logging

    Para desativar o redirecionamento padrão dos registros do agente para o Cloud Logging, siga estas etapas:

    1. Use o SSH para se conectar à instância de VM.

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

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

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

    4. Salve o arquivo de configuração.

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

    Solução de problemas

    As seções a seguir fornecem informações sobre problemas comuns relacionados ao uso do agente para cargas de trabalho do Oracle Database, suas causas e resolução.

    Permissões do IAM insuficientes

    Problema:os registros do Agente para cargas de trabalho computacionais mostram um erro de permissões insuficientes do IAM.

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

    Causa:a conta de serviço usada pelo agente não tem as permissões do IAM necessárias para acessar as APIs Google Cloud ou uma senha para o usuário do Oracle no Secret Manager.

    Resolução:para resolver esse problema, verifique se a conta de serviço da VM tem os papéis e permissões do IAM mencionados em Pré-requisitos.

    Escopos de autenticação insuficientes

    Problema:os registros do Agente para cargas de trabalho computacionais mostram escopos de autenticação insuficientes.

    googleapi: Error 403: Request had insufficient authentication scopes.

    Causa:a conta de serviço usada pelo agente não tem o escopo de acesso necessário.

    Resolução:para resolver esse problema, configure os escopos de acesso da VM como cloud-platform.

    As métricas não aparecem no Cloud Monitoring

    Problema:as métricas do Agente para cargas de trabalho computacionais não estão visíveis no Cloud Monitoring.

    Causa:

    Confira as possíveis causas desse problema:

    • A conta de serviço usada pelo Agente para cargas de trabalho computacionais não tem as permissões necessárias do IAM.
    • O usuário do Oracle usado pelo agente não tem privilégios suficientes para consultar visualizações de desempenho.
    • Há erros na configuração do agente.

    Resolução:

    • Para resolver o problema de permissões insuficientes da conta de serviço, faça o seguinte:

      1. No console do Google Cloud , acesse a página Detalhes da instância de VM e anote a conta de serviço usada pela instância que executa o agente.
      2. Acesse a página IAM e administrador e verifique se a conta de serviço tem todos os papéis e permissões necessários mencionados nos Pré-requisitos. Conceda à conta de serviço qualquer um dos papéis necessários que estejam faltando.

    • Para resolver o problema de permissões insuficientes para o usuário do Oracle, faça o seguinte:

      1. Verifique se o usuário do Oracle tem as seguintes permissões necessárias para consultar visualizações de performance:

        • SESSION
        • SELECT_CATALOG_ROLE
        • SYSDG

      2. Conceda as permissões ausentes executando o seguinte comando SQL:

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

    • Para resolver o problema com a configuração incorreta do agente, faça o seguinte:

      1. Use o SSH para se conectar à instância de VM.

      2. Analise os registros do agente para identificar erros ou problemas que impeçam a coleta de métricas. Os registros podem ser encontrados em /var/log/google-cloud-workload-agent.log.

        Procure erros de permissão, configurações incorretas ou problemas de conectividade.

      3. Resolva os erros.

      4. Reinicie o agente e verifique se a coleta de métricas começa.

    Falha ao carregar o arquivo de configuração

    Problema:se o arquivo de configuração tiver valores inválidos, você vai receber o seguinte erro. 

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

    Resolução:para resolver esse problema, atualize o arquivo de configuração usando os detalhes em Parâmetros de configuração.

    Falha ao inicializar a coleta de dados

    Problema:depois de instalar o agente, se o arquivo de configuração não for atualizado, você vai receber o seguinte erro: 

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

    Resolução:para resolver esse problema, inicialize a configuração de credenciais usando os Parâmetros de configuração.