Configura el agente para las cargas de trabajo de Oracle

En este documento, se muestra cómo instalar, configurar y verificar el agente para cargas de trabajo de Compute en instancias de Compute Engine que ejecutan cargas de trabajo de Oracle Database.

El agente recopila varias métricas de Oracle consultando las vistas de rendimiento de la base de datos de Oracle (como V$DATABASE, V$INSTANCE y V$DATAGUARD_STATS) y las vistas del diccionario de datos (como DBA_DATA_FILES y DBA_FREE_SPACE). Luego, estas métricas se envían a Cloud Monitoring, donde se pueden visualizar y analizar. Consulta las métricas admitidas.

Antes de comenzar

Antes de instalar el Agente para cargas de trabajo de Compute y supervisar tus cargas de trabajo de Oracle Database, asegúrate de que se cumplan los siguientes requisitos previos:

Revisa los requisitos del sistema

En la siguiente tabla, se enumeran las ediciones de Oracle que puedes usar y las versiones de sistemas operativos compatibles:

Sistemas operativos Versiones de Oracle Ediciones de Oracle
  • Versiones 7, 8 y 9 de Red Hat Enterprise Linux
  • Versiones 7, 8 y 9 de Oracle Linux
  • Oracle Database 19c
  • Oracle Database 23ai*
  • Enterprise Edition
  • Standard Edition
  • Edición Express (gratis)

Otorga roles de IAM a la cuenta de servicio

El agente para cargas de trabajo de Compute usa la cuenta de servicio conectada a la instancia de procesamiento para la autenticación y para acceder a los recursos de Google Cloud .

Para mejorar la seguridad, te recomendamos que uses una cuenta de servicio de propósito único en lugar de la cuenta de servicio predeterminada de Compute Engine.

Para garantizar que la cuenta de servicio tenga los permisos necesarios para permitir que Agent for Compute Workloads se autentique conGoogle Cloud y acceda a los recursos de Google Cloud , pídele a tu administrador que le otorgue los siguientes roles de IAM a la cuenta de servicio en tu proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Es posible que tu administrador también pueda otorgar a la cuenta de servicio los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Habilita el acceso a las API de Cloud

Compute Engine recomienda configurar las instancias para permitir todos los permisos de acceso a todas las API de Cloud y usar solo los permisos de IAM de la cuenta de servicio de la instancia para controlar el acceso a los recursos deGoogle Cloud . Para obtener más información, consulta Crea una VM que use una cuenta de servicio administrada por el usuario.

Si limitas el acceso a las API de Cloud, el agente para cargas de trabajo de Compute requiere, como mínimo, los siguientes permisos de acceso a las API de Cloud en la instancia de procesamiento del host:

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

Para obtener más información, consulta las prácticas recomendadas para los permisos.

Si ejecutas una carga de trabajo de Oracle en una instancia de procesamiento que no tiene una dirección IP externa, debes habilitar el Acceso privado a Google en la subred de la instancia para que el Agente para cargas de trabajo de procesamiento pueda acceder a las APIs y los servicios de Google. Para obtener información sobre cómo habilitar el Acceso privado a Google, consulta Configura el Acceso privado a Google.

Instala y configura el agente con el administrador de paquetes

En esta sección, se muestra cómo instalar el agente para cargas de trabajo de Compute en tu instancia de procesamiento y configurarlo para que se conecte con una instancia de Oracle, mediante un administrador de paquetes.

Para instalar el agente para cargas de trabajo de Compute, completa los siguientes pasos:

  1. Crea un archivo de configuración del repositorio.

    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. Actualiza los metadatos del administrador de paquetes:

    sudo yum makecache

  3. Instala el paquete google-cloud-workload-agent rpm:

    sudo yum install google-cloud-workload-agent

Después de instalar el agente para las cargas de trabajo de Oracle, verifica la instalación del agente.

Instala y administra el agente en una flota de VMs con el Gestor de extensiones de VM

En esta sección, se muestra cómo instalar y administrar el agente para cargas de trabajo de Compute en una flota de VMs con el Administrador de extensiones de VM.

La política del Gestor de extensiones de VM te permite realizar tareas como las siguientes:

  • Instalación en toda la flota: Instala el agente para cargas de trabajo de Compute en los siguientes elementos:
    • Todas las VMs de tu proyecto Google Cloud o un subconjunto de VMs identificadas por etiquetas
    • Todas las VMs dentro de una zona o un subconjunto de VMs identificadas por etiquetas
  • Administración de la configuración: Aplica una configuración personalizada al agente en todas las VMs administradas por una política.

Para obtener más información sobre el Gestor de extensiones de VM, consulta Acerca del Gestor de extensiones de VM.

Configura el Gestor de extensiones de VM

Para configurar el Administrador de extensiones de VM, completa los siguientes pasos:

Instala y configura el agente en una flota de VMs

Para instalar la versión más reciente del Agente de cargas de trabajo de procesamiento en tu flota de VMs con una política de Gestor de extensiones de VM, consulta la sección correspondiente:

Instala y configura el agente en las VMs de tu proyecto de Google Cloud

Para instalar el agente en todas las VMs de tu proyecto Google Cloud , o en un subconjunto de VMs identificadas por una etiqueta, con una política del Gestor de extensiones de VM, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones de VM.

    Ir a las políticas de extensión de VM

  2. Haz clic en Crear política de extensión.

  3. En el campo Nombre, ingresa un nombre para la política.

  4. Opcional: En el campo Descripción, ingresa una descripción para la política.

  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000.

  6. En la sección Alcance, selecciona Lanzamiento global.

  7. En la sección Administrar extensiones, haz clic en Agregar extensión y, luego, haz lo siguiente:

    1. En la lista Extension, selecciona Extensión de Google Cloud para cargas de trabajo de procesamiento.

    2. Deja en blanco el campo Versión.

      Esto indica a la política que instale la versión más reciente del agente para cargas de trabajo de Compute.

    3. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

      Para obtener información sobre los parámetros de configuración que admite el agente para tu carga de trabajo de Oracle, consulta Parámetros de configuración.

    4. Haz clic en Listo.

    5. En el campo Lanzamiento, selecciona la opción del plan de lanzamiento que deseas usar: Lanzamiento lento (recomendado) o Lanzamiento rápido.

      Para obtener información sobre los planes de lanzamiento, consulta Acerca de los planes de lanzamiento.

  8. Opcional: Para limitar el lanzamiento de la política a las VMs requeridas, haz lo siguiente:

    1. Haz clic en Agregar etiquetas y agrega las etiquetas que identifican las VMs requeridas.
    2. Haz clic en Listo.

  9. Haz clic en Crear.

gcloud

En tu terminal o Cloud Shell, ejecuta el 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]

Reemplaza lo siguiente:

  • POLICY_NAME: Es un nombre único para la política de extensión de VM.
  • PROJECT_ID: ID del proyecto deGoogle Cloud para el que creas la política

  • ROLL_OUT_SPEED: La rapidez con la que deseas lanzar la política. Los valores admitidos son slow_rollout (recomendado) y fast_rollout. Para obtener más información, consulta Acerca de los planes de lanzamiento.

  • Como alternativa, puedes usar un plan de lanzamiento personalizado especificando la opción --rollout-custom-plan. Para obtener más información, consulta Acerca de los planes de lanzamiento.

  • Puedes usar --rollout-predefined-plan o --rollout-custom-plan, pero no ambos en el mismo comando.

  • DESCRIPTION: Es una descripción opcional de la política.

  • CONFIG_FILE_PATH: Es la ruta local al archivo JSON que contiene la configuración del agente para cargas de trabajo de Compute.

    • Como alternativa, para proporcionar la configuración como una cadena intercalada, usa la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG".
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs del proyecto.

  • PRIORITY: Es un número entero del 0 al 65535 que define la prioridad de la política. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000. Para obtener más información, consulta Prioridad de las políticas y resolución de conflictos.

Instala y configura el agente en las VMs dentro de una zona específica

Para instalar y configurar la versión más reciente del Agente de cargas de trabajo de procesamiento en tu flota de VMs dentro de una zona específica con una política del Gestor de extensiones de VM, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones de VM.

    Ir a las políticas de extensión de VM

  2. Haz clic en Crear política de extensión.

  3. En el campo Nombre, ingresa un nombre para la política.

  4. Opcional: En el campo Descripción, ingresa una descripción para la política.

  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000.

  6. En las listas Región y Zona, selecciona la zona en la que deseas aplicar esta política.

  7. En la sección Administrar extensiones, haz clic en Agregar extensión y, luego, haz lo siguiente:

    1. En la lista Extension, selecciona Extensión de Google Cloud para cargas de trabajo de procesamiento.

    2. Deja en blanco el campo Versión.

      Esto indica a la política que instale la versión más reciente del agente para cargas de trabajo de Compute.

    3. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

      Para obtener información sobre los parámetros de configuración que admite el agente para tu carga de trabajo de Oracle, consulta Parámetros de configuración.

    4. Haz clic en Listo.

  8. Opcional: Para limitar el lanzamiento de la política a las VMs requeridas, haz lo siguiente:

    1. Haz clic en Agregar etiquetas y agrega las etiquetas que identifican las VMs requeridas.
    2. Haz clic en Listo.

  9. Haz clic en Crear.

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]

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.

    El comando falla si ya existe una política con el nombre especificado en la zona.

  • ZONE: Es la zona en la que deseas aplicar esta política.

  • CONFIG_FILE_PATH: Es la ruta de acceso local al archivo JSON que contiene la configuración para que el agente de Compute Workloads se conecte con tu carga de trabajo de Oracle.

    • Como alternativa, para proporcionar la configuración como una cadena intercalada, usa la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG". Google Cloud recomienda que uses --config-from-file.
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración que admite el agente para tu carga de trabajo de Oracle, consulta Parámetros de configuración.

  • DESCRIPTION: Es una descripción opcional de la política.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs de la zona especificada.

  • PRIORITY: Es un número entero del 0 al 65535 que define la prioridad de la política. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000.

Ejemplo:

El siguiente comando crea una política llamada test-agent-policy en el proyectoGoogle Cloud llamado test-project, que instala la versión más reciente del agente para cargas de trabajo de Compute en todas las VMs implementadas en la zona us-centrail-f. La configuración especificada en agent-config.json se aplica al 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"

Administra el agente en una flota de VMs

Para cambiar la forma en que una política del Gestor de extensiones de VM administra el Agente de cargas de trabajo de procesamiento, actualiza la política. Cuando actualizas una política, el Gestor de extensiones de VM implementa los cambios en todas las VMs aplicables, por lo general, en un minuto. Si modificas las etiquetas de inclusión, es posible que el agente para cargas de trabajo de Compute se instale en VMs nuevas o se desinstale de VMs existentes según si las VMs coinciden con las etiquetas actualizadas.

En las siguientes secciones, se muestra cómo administrar el Agente para cargas de trabajo de Compute para realizar las siguientes acciones:

Modifica la configuración del agente en una flota de VMs

Para modificar la configuración de las instancias del Agente de cargas de trabajo de procesamiento que instalaste en tu flota de VMs con una política del Gestor de extensiones de VM, debes editar esa política.

Para modificar la configuración del agente en tu flota de VM, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones de VM.

    Ir a las políticas de extensión de VM

  2. Haz clic en la política que deseas modificar.

  3. En la página Detalles de la política de extensiones, haz clic en Editar.

  4. En la sección Administrar extensiones, activa Extensión de Google Cloud para cargas de trabajo de procesamiento.

  5. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

    Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  6. Haz clic en Listo.

  7. Haz clic en Guardar.

gcloud

Para modificar la configuración del agente para cargas de trabajo de Compute en tu flota de VM, ejecuta el comando gcloud compute zone-vm-extension-policies update. Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas volverá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para modificar la configuración del agente, haz lo siguiente:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas modificar.
  • ZONE: Es la Google Cloud zona en la que se aplica la política.

  • CONFIG_FILE_PATH: Es la ruta local al archivo JSON que contiene la configuración del agente para cargas de trabajo de Compute.

    • También puedes proporcionar la configuración del agente como una cadena intercalada con la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG". Google Cloud recomienda que uses --config-from-file.
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs de la zona especificada.

  • PRIORITY_NUMBER: Es la prioridad que deseas establecer para tu política. Puedes especificar un número entero del 0 al 65535.

  • DESCRIPTION: Es una descripción de la política de extensión de VM.

Actualiza una política global para incluir zonas nuevas

Cuando creas VMs en una zona nueva después de haber creado y lanzado una política global, Gestor de extensiones de VM no aplica automáticamente la política a las VMs en las zonas nuevas. Para incluir las VMs en zonas nuevas, debes reiniciar la implementación de la política global.

Para reiniciar el lanzamiento de una política global, completa los siguientes pasos:

  • En tu terminal o Cloud Shell, ejecuta el comando gcloud compute global-vm-extension-policies update y proporciona la opción --rollout-entry-uuid de la siguiente manera:

    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

    Reemplaza lo siguiente:

    • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar un lanzamiento.

    • ROLL_OUT_SPEED: La rapidez con la que deseas lanzar la política. Los valores admitidos son slow_rollout (recomendado) y fast_rollout. Para obtener más información, consulta Acerca de los planes de lanzamiento.

    • Como alternativa, puedes usar un plan de lanzamiento personalizado especificando la opción --rollout-custom-plan. Para obtener más información, consulta Acerca de los planes de lanzamiento.

    • Puedes usar --rollout-predefined-plan o --rollout-custom-plan, pero no ambos en el mismo comando.

Actualiza una política global para excluir zonas

Para actualizar una política global y excluir zonas, completa los siguientes pasos:

  • En tu terminal o Cloud Shell, ejecuta el comando gcloud compute global-vm-extension-policies update y proporciona un plan de lanzamiento personalizado que especifique las zonas en las que se aplicará la política:

    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

    Reemplaza lo siguiente:

    • NEW_CUSTOM_PLAN_NAME: Es el nombre del nuevo plan de lanzamiento personalizado que identifica las zonas en las que se aplicará la política. Para obtener información sobre cómo crear planes de lanzamiento personalizados, consulta Acerca de los planes de lanzamiento.
    • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar un lanzamiento.

Desinstala el agente de una flota de VM

Para desinstalar el agente para cargas de trabajo de Compute de tu flota de VMs, debes borrar la política del Administrador de extensiones de VM que administra la flota de VMs.

Mientras se borra una política, si otra política activa de menor prioridad se aplica a una VM y declara el agente para cargas de trabajo de Compute, el agente permanece instalado en esa VM según la política de menor prioridad.

El Gestor de extensiones de VM quita el agente de todas las VMs accesibles en el plazo de un minuto después de que se borra la política. Si no se puede acceder a una VM porque se quitó el agente invitado o se borró la VM, el Administrador de extensiones de VM omitirá el borrado del Agente para cargas de trabajo de Compute. Si una VM de este tipo vuelve a estar disponible, Gestor de extensiones de VM quitará el Agente de cargas de trabajo de procesamiento en ese momento.

Para desinstalar el agente de Compute Workloads de tu flota de VM, completa los siguientes pasos:

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones de VM.

    Ir a las políticas de extensión de VM

  2. Haz clic en la política que administra el agente para cargas de trabajo de procesamiento en tu flota de VM.

  3. En la página Detalles de la política de extensiones, haz clic en Borrar y confirma la eliminación.

gcloud 

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas borrar.
  • PROJECT_ID: Es el ID del Google Cloud proyecto en el que se encuentra la política.
  • ZONE: La Google Cloud zona en la que se encuentra la política.

Verifica la instalación del agente

Para verificar que el agente se ejecute según lo previsto, completa los siguientes pasos:

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. Verifica el estado del paquete del agente:

    systemctl status google-cloud-workload-agent

    Si el paquete del agente se ejecuta como se espera, el resultado contiene active (running). Por ejemplo:

    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 configuración

    El agente de cargas de trabajo de procesamiento admite los siguientes parámetros de configuración para Oracle:

    Parámetro Descripción
    log_level

    String

    Para configurar el nivel de registro del agente, agrega los niveles de registro. Los niveles de registro disponibles son los siguientes:
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    El valor predeterminado es INFO.
    log_to_cloud

    Boolean

    Para redireccionar los registros del agente a Cloud Logging, especifica true. El valor predeterminado es true.
    oracle_configuration.enabled

    Boolean

    Es opcional. Determina si el servicio de Oracle está activo. Cuando se establece en true, o si no se establece y la carga de trabajo está presente, puedes configurar la detección y la recopilación de métricas. Si se configura como false, se inhabilitan el servicio de Oracle y sus funcionalidades relacionadas.
    Los siguientes parámetros secundarios solo se aplican cuando especificas oracle_configuration.enabled: true.
    oracle_configuration.oracle_discovery.enabled

    Boolean

    Es opcional. Determina si el Oracle Discovery está activo.

    El valor predeterminado es true.
    oracle_configuration.oracle_discovery.update_frequency

    Int

    Es opcional. Especifica el intervalo de muestra, en segundos, que determina la frecuencia con la que el agente de cargas de trabajo de procesamiento ejecuta el proceso de detección. El valor predeterminado es 3,600 segundos (1 hora).

    Asegúrate de que el valor termine con una "s" en minúscula para indicar segundos. Por ejemplo: 30s.
    oracle_configuration.oracle_metrics.enabled

    Boolean

    Es opcional. Para permitir que el agente para cargas de trabajo de Compute recopile las métricas de supervisión de Oracle, especifica true. El valor predeterminado es false.

    Los siguientes parámetros secundarios solo se aplican cuando especificas oracle_metrics.enabled: true.
    oracle_configuration.oracle_metrics.collection_frequency

    Int

    Es opcional. Especifica el intervalo de muestra, en segundos, que determina la frecuencia con la que el agente para cargas de trabajo de Compute consulta tus instancias de la base de datos de Oracle para recopilar las métricas de supervisión de Oracle. El valor predeterminado es 60 segundos.

    Asegúrate de que el valor termine con una "s" en minúscula para indicar segundos. Por ejemplo: 30s.
    oracle_configuration.oracle_metrics.query_timeout

    String

    Es opcional. Especifica el tiempo de espera para cada consulta realizada a las instancias de la base de datos de Oracle. El valor predeterminado es 10 segundos.

    Asegúrate de que el valor termine con una "s" en minúscula para indicar segundos. Por ejemplo: 30s.
    oracle_configuration.oracle_metrics.connection_parameters.username

    String

    Especifica la cuenta de usuario que se usa para consultar la instancia de la base de datos de Oracle.

    Asegúrate de que este usuario tenga los permisos necesarios para leer las vistas de rendimiento en tu base de datos de Oracle.
    oracle_configuration.oracle_metrics.connection_parameters.host

    String

    Especifica el identificador de la máquina local que aloja la instancia de la base de datos.
    oracle_configuration.oracle_metrics.connection_parameters.port

    Int

    Especifica el puerto en el que la instancia de Oracle Database acepta consultas.
    oracle_configuration.oracle_metrics.connection_parameters.service_name

    String

    Especifica el nombre del servicio de la instancia de Oracle Database que deseas que supervise el agente.
    oracle_configuration.oracle_metrics.connection_parameters.secret.project_id

    String

    Especifica el ID del proyecto de Secret Manager para recuperar la contraseña del usuario que realiza consultas a la base de datos.
    oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name

    String

    Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.

    Recopila y visualiza métricas de Oracle

    Puedes habilitar la recopilación de métricas para las cargas de trabajo de la base de datos de Oracle. Consulta las métricas admitidas.

    Habilita la recopilación de métricas

    Para habilitar la recopilación de métricas de Oracle con el agente para cargas de trabajo de Compute, haz lo siguiente:

    1. Usa SSH para conectarte a tu instancia de VM.

    2. Como usuario del SO de Oracle, ejecuta la herramienta oraenv para establecer las variables de entorno. Suponemos que ya definiste el usuario oracle y el ORACLE_SID en el archivo /etc/oratab.

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

    3. Como usuario SYSDBA o SYSOPER, en la base de datos de Oracle, crea un usuario para la supervisión con una contraseña que coincida con el secreto que creaste en los requisitos previos.

      CREATE USER wlmagent IDENTIFIED BY password;

    4. Como usuario SYSDBA o SYSOPER, otorga los siguientes permisos al usuario de supervisión para consultar las vistas de rendimiento:

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

    5. Sal de sqlplus y del usuario oracle.

    6. Como usuario raíz, edita el archivo de configuración del agente con tu editor preferido.

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

    7. En el archivo de configuración, edita la sección oracle_metrics para realizar las siguientes actualizaciones:

      1. Establece el parámetro enabled en true.
      2. Establece el parámetro service_name para especificar el nombre del servicio de la instancia de Oracle que deseas que supervise el agente.
      3. Especifica el nombre de usuario de Oracle para que el agente se conecte a tu base de datos.
      4. Establece los parámetros host y port para que el agente se conecte a tu base de datos.
      5. Establece el parámetro secret para que el agente recupere una contraseña para el nombre de usuario:
        • project_id: Es el ID del proyecto que contiene los datos de Secret Manager.
        • secret_name: Es el nombre del secreto en Secret Manager.

      A continuación, se muestra un ejemplo de archivo de configuración:

      {
  "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. Guarda el archivo de configuración.

    9. Reinicia el agente para que se aplique la configuración nueva.

    Visualiza las métricas

    Puedes ver las métricas recopiladas y supervisar el rendimiento y el estado de Oracle con el Explorador de métricas o importando un panel personalizado.

    Visualiza métricas en el Explorador de métricas

    Para ver las métricas de Oracle en el Explorador de métricas, haz lo siguiente:

    1. En la consola de Google Cloud , ve a Monitoring.
    2. Haz clic en Explorador de métricas.
    3. En Find resource type and metric, haz lo siguiente:
      1. En Tipo de recurso, seleccione Instancia de VM.
      2. En Métrica, selecciona las métricas de Oracle que deseas ver.

    Puedes consultar los datos históricos y en tiempo real de las métricas de Oracle seleccionadas, y usar filtros y agregaciones según sea necesario.

    Cómo importar un panel personalizado

    Para ver las métricas de Oracle que recopila el agente, puedes crear paneles personalizados de Cloud Monitoring siguiendo las instrucciones que se indican en Crea y administra paneles personalizados.

    Proporcionamos un ejemplo de panel oracle-status-overview.json y las instrucciones para importarlo. En el panel de oracle-status-overview.json, se muestran los siguientes gráficos de métricas de Oracle:

    • Desglose del tiempo de la base de datos
    • Uso de memoria de la base de datos
    • Promedio de sesiones activas por clase de espera
    • E/S de disco
    • Uso de CPU
    • Tráfico de red

    Para importar el panel de oracle-status-overview.json, haz lo siguiente:

    1. Verifica que gcloud CLI esté instalada y actualizada. Para obtener instrucciones, consulta Instala gcloud CLI.

    2. En el repositorio de GitHub del agente de cargas de trabajo de procesamiento, descarga el panel 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. Ejecuta el siguiente comando para importar el panel:

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

      Después de ejecutar el comando, se creará el panel personalizado en Cloud Monitoring. Para obtener información sobre cómo ver un panel, consulta Cómo encontrar y ver un panel.

    Métricas admitidas

    Todas las métricas de Oracle que recopila el Agente de cargas de trabajo de procesamiento están disponibles en la ruta de acceso workload.googleapis.com/oracle.

    A continuación, se incluye una lista de las métricas de Oracle compatibles y sus rutas correspondientes en Cloud Monitoring:

    • Memoria del proceso

      • Es la memoria del proceso (PGA) en uso, en bytes.

        process/pga_memory/total_used_size

      • Memoria de proceso (PGA) asignada, en bytes

        process/pga_memory/total_allocated_size

    • Memoria compartida

      • Tamaño del elemento de memoria compartida (SGA), en bytes

        process/sga_memory/size

    • Eventos de espera del sistema

      • Cantidad total de esperas para una clase de espera registrada

        sys_wait/count

      • Tiempo agregado dedicado a esta clase de espera, en segundos

        sys_wait/time

      • Total de esperas en primer plano en esta clase de espera

        sys_wait/foreground/count

      • Tiempo de espera en primer plano agregado para esta clase de espera, en segundos

        sys_wait/foreground/time

    • Tiempo transcurrido del sistema

      • Tiempo transcurrido dedicado a realizar llamadas a nivel del usuario de la base de datos, en segundos

        sys_time/db_time

      • Tiempo de CPU dedicado a llamadas a nivel del usuario de la base de datos, en segundos

        sys_time/db_cpu

      • Cantidad de tiempo transcurrido durante la ejecución de las sentencias de SQL

        sys_time/sql_execute_elapsed_time

      • Cantidad de tiempo transcurrido dedicado al análisis de sentencias de SQL

        sys_time/parse_time_elapsed

      • Cantidad de tiempo transcurrido que se dedicó a ejecutar el intérprete de PL/SQL

        sys_time/pl_sql_execution_elapsed_time

      • Tiempo transcurrido que consumen los procesos en segundo plano de la base de datos, en segundos

        sys_time/background_elapsed_time

    • Estadísticas de E/S

      • Recuento total de operaciones de lectura (pequeñas y grandes)

        iostat/read_ops_count

      • Recuento total de operaciones de escritura (pequeñas y grandes)

        iostat/write_ops_count

      • Cantidad total de bytes leídos

        iostat/read_bytes_count

      • Cantidad total de bytes escritos

        iostat/write_bytes_count

      • Latencia promedio por operación de E/S

        iostat/average_latency_seconds

    • Archivos de datos

      • Tamaño asignado del archivo de datos, en bytes

        data_files/total_bytes

      • Espacio de archivo de datos en uso, en bytes

        data_files/bytes_used

      • Espacio libre del archivo de datos, en bytes

        data_files/available_bytes

      • Límite de extensión automática de archivos de datos, en bytes

        data_files/max_bytes

      • Porcentaje del archivo de datos utilizado

        data_files/percent_used

    • Instancia de base de datos

      • Tiempo de actividad de la instancia, en segundos

        instance/uptime

      • Estado de la instancia

        instance/status

        Esta métrica puede tener los siguientes valores:

        UNKNOWN 0
        STARTED 1
        MOUNTED 2
        OPEN 3
        OPEN MIGRATE 4

      • Modo abierto

        instance/db_open_mode

        Esta métrica puede tener los siguientes valores:

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

    • Oracle Data Guard

      • Retraso de aplicación de rehacer, en segundos

        dataguard/apply_lag

      • Retraso del transporte de rehacer, en segundos

        dataguard/transport_lag

    Cómo administrar el agente

    Reinicia el agente

    Si el agente para cargas de trabajo de Compute deja de funcionar o actualizas su configuración, reinicia el agente.

    1. Usa SSH para conectarte a la instancia de VM.

    2. Ejecuta el comando siguiente:

      sudo systemctl restart google-cloud-workload-agent

    Verifica la versión del agente

    Para ver la versión de tu agente, completa los siguientes pasos:

    1. Usa SSH para conectarte a la instancia de VM.

    2. Ejecuta el comando siguiente:

      yum info google-cloud-workload-agent

    Busca actualizaciones

    1. Usa SSH para conectarte a la instancia de VM.

    2. Ejecuta el comando siguiente:

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

    Actualiza el agente

    Para asegurarte de tener la versión más reciente del agente, verifica si hay actualizaciones periódicamente y actualiza el agente:

    1. Usa SSH para conectarte a la instancia de VM.

    2. Ejecuta el comando siguiente:

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

    Cómo ver los registros del agente

    Los registros del agente de cargas de trabajo de procesamiento están disponibles en /var/log/google-cloud-workload-agent.log.

    El nivel de detalle del registro se controla con el parámetro log_level. Establecer el nivel de registro DEBUG incluye información adicional para solucionar problemas específicos, pero genera registros mucho más grandes.

    De forma predeterminada, los registros del agente para cargas de trabajo de Compute se redireccionan de tus instancias de VM a Cloud Logging.

    Para ver los registros del agente en Logging, sigue estos pasos:

    1. En la consola de Google Cloud , accede a la página Explorador de registros.

      Ir al Explorador de registros

    2. Ve al panel Consulta.

    3. En el menú desplegable Recursos, selecciona Global y, luego, haz clic en Aplicar.

    4. En el Editor de consultas, ingresa google-cloud-workload-agent.

    5. Haz clic en Ejecutar consulta.

    Puedes ver los registros que genera el agente que se ejecuta en todas tus instancias de VM. Puedes filtrar los registros de una instancia específica.

    Configura los registros del agente en Cloud Logging

    Para inhabilitar el redireccionamiento predeterminado de los registros del agente a Cloud Logging, sigue estos pasos:

    1. Usa SSH para conectarte a tu instancia de VM.

    2. Reemplaza el archivo de configuración del agente:

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

    3. Para la propiedad log_to_cloud, actualiza el valor a false.

    4. Guarda el archivo de configuración.

    5. Reinicia el agente para que se aplique este cambio.

    Soluciona problemas

    En las siguientes secciones, se proporciona información sobre problemas habituales relacionados con el uso del agente para cargas de trabajo de Oracle Database, sus causas y la resolución.

    Permisos de IAM insuficientes

    Problema: Los registros del Agente para cargas de trabajo de Compute muestran un error de permisos de IAM insuficientes.

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

    Causa: La cuenta de servicio que usa el agente no tiene los permisos de IAM necesarios para acceder a las APIs de Google Cloud o una contraseña para el usuario de Oracle en Secret Manager.

    Resolución: Para resolver este problema, asegúrate de que la cuenta de servicio de la VM tenga los roles y permisos de IAM que se mencionan en Requisitos previos.

    Permisos de autenticación insuficientes

    Problema: Los registros del Agente para cargas de trabajo de Compute muestran permisos de autenticación insuficientes.

    googleapi: Error 403: Request had insufficient authentication scopes.

    Causa: La cuenta de servicio que usa el agente no tiene el permiso de acceso requerido.

    Resolución: Para resolver este problema, configura los permisos de acceso de la VM en cloud-platform.

    Las métricas no aparecen en Cloud Monitoring

    Problema: Las métricas del agente para cargas de trabajo de Compute no se ven en Cloud Monitoring.

    Causa:

    A continuación, se indican las posibles causas de este problema:

    • La cuenta de servicio que usa el agente para cargas de trabajo de Compute no tiene los permisos de IAM necesarios.
    • El usuario de Oracle que usa el agente no tiene suficientes privilegios para consultar las vistas de rendimiento.
    • Hay errores en la configuración del agente.

    Resolución:

    • Para resolver el problema de permisos insuficientes para la cuenta de servicio, haz lo siguiente:

      1. En la Google Cloud consola, ve a la página Detalles de instancia de VM y anota la cuenta de servicio que usa la instancia que ejecuta el agente.
      2. Ve a la página IAM y administración y asegúrate de que la cuenta de servicio tenga todos los roles y permisos necesarios que se mencionan en los requisitos previos. Otorga a la cuenta de servicio cualquiera de los roles faltantes requeridos.

    • Para resolver el problema de permisos insuficientes para el usuario de Oracle, haz lo siguiente:

      1. Verifica que el usuario de Oracle tenga los siguientes permisos necesarios para consultar las vistas de rendimiento:

        • SESSION
        • SELECT_CATALOG_ROLE
        • SYSDG

      2. Ejecuta el siguiente comando de SQL para otorgar cualquiera de los permisos faltantes:

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

    • Para resolver el problema de configuración incorrecta del agente, haz lo siguiente:

      1. Usa SSH para conectarte a tu instancia de VM.

      2. Revisa los registros del agente para identificar errores o problemas que impidan la recopilación de métricas. Puedes encontrar los registros en /var/log/google-cloud-workload-agent.log.

        Busca errores de permisos, parámetros de configuración incorrectos o problemas de conectividad.

      3. Resuelve cualquier error.

      4. Reinicia el agente y verifica si se inicia la recopilación de métricas.

    No se pudo cargar el archivo de configuración

    Problema: Si el archivo de configuración tiene valores no válidos, verás el siguiente error. 

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

    Resolución: Para resolver este problema, actualiza el archivo de configuración con los detalles que se indican en Parámetros de configuración.

    No se pudo inicializar la recopilación de datos

    Problema: Después de instalar el agente, si no se actualiza el archivo de configuración, verás el siguiente error: 

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

    Resolución: Para resolver este problema, inicializa la configuración de credenciales con Parámetros de configuración.