Se usó la API de Cloud Translation para traducir esta página.

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 Oracle Database (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 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:

Crea una instancia de Compute Engine si aún no tienes una. Configura los permisos de acceso en cloud-platform.
Configura el acceso raíz en la instancia de Compute Engine.
Revisa los requisitos del sistema.
Otorga roles de IAM a la cuenta de servicio.
Habilita la conectividad a los extremos de la API de Google Cloud , ya sea a través del acceso a la red pública o a la red privada.
Si deseas habilitar la recopilación de métricas, crea un secreto en Secret Manager para almacenar la contraseña del usuario de la base de datos que se creará más adelante en esta guía.

Para los ejemplos de esta guía, suponemos que es wlmagent-password.

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* Nota: El agente no se probó en Oracle Database 23ai que se ejecuta en Red Hat Enterprise Linux 7 ni en Oracle Linux 7.	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 a la cuenta de servicio los siguientes roles de IAM en tu proyecto:

Visualizador de Compute (roles/compute.viewer): para recopilar métricas de la instancia de procesamiento.
Escritor de estadísticas del administrador de cargas de trabajo (roles/workloadmanager.insightWriter): para escribir datos en el almacén de datos de Workload Manager
(Recomendado) Logs Writer (roles/logging.logWriter): para enviar registros del agente a Cloud Logging
(Opcional) Descriptor de acceso a secretos de Secret Manager (roles/secretmanager.secretAccessor): si usas Secret Manager para almacenar la contraseña para conectarte con la instancia de Oracle

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 Prácticas recomendadas para los permisos.

Si ejecutas aplicaciones 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 Compute 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:

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

Actualiza los metadatos del administrador de paquetes:
```
sudo yum makecache
```
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 VM Extension Manager

Configura VM Extension Manager

Para configurar VM Extension Manager, completa los siguientes pasos:

En la documentación de VM Extension Manager, revisa la sección Antes de comenzar.
Configura los roles de IAM necesarios para crear y administrar políticas de VM Extension Manager. Para obtener más información, consulta lo siguiente:

Instala el agente en una flota de VMs

Para instalar la versión más reciente del agente para cargas de trabajo de Compute en tu flota de VMs dentro de una zona específica con una política de VM Extension Manager, completa los siguientes pasos:

Console

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

Ir a Políticas de extensión de VM
Haz clic en Crear política de extensión.
En el campo Nombre, ingresa un nombre para la política.
Opcional: En el campo Descripción, ingresa una descripción para la política.
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.
En las listas Región y Zona, selecciona la zona en la que deseas aplicar esta política.
En la sección Extensiones, haz clic en Agregar extensión y, luego, haz lo siguiente:
1. En la lista Extension, selecciona Google Cloud's Extension for Compute Workloads.
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 admitidos por el agente para tu carga de trabajo de Oracle, consulta Parámetros de configuración.
  
  Nota: Si aplicas una política de VM Extension Manager a las VMs en las que ya se ejecuta el agente para cargas de trabajo de Compute, la política anula la versión y la configuración existentes del agente con lo que hayas establecido en la política.
  
  La configuración existente del agente se escribe en un archivo BAK en el directorio /etc/google-cloud-workload-agent/ de las VMs respectivas.
4. Haz clic en Listo.
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.
Haz clic en Crear.

gcloud

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

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 te 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 para tu carga de trabajo de Oracle, consulta Parámetros de configuración.
Nota: Si aplicas una política de VM Extension Manager a las VMs en las que ya se ejecuta el agente para cargas de trabajo de Compute, la política anula la versión y la configuración existentes del agente con lo que hayas establecido en la política.

La configuración existente del agente se escribe en un archivo BAK en el directorio /etc/google-cloud-workload-agent/ de las VMs respectivas.
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 beta compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

Verifica la instalación del agente

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

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

Verifica el estado del paquete del agente:

systemctl status google-cloud-workload-agent

Si el paquete del agente se ejecuta según lo previsto, 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 para cargas de trabajo de Compute 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 la detección de Oracle está activa. 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 Oracle Database 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 Oracle Database. 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:

Usa SSH para conectarte a tu instancia de VM.
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
```
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.

Nota: Si tienes una base de datos de contenedor de Oracle Multitenant, antepone el nombre de usuario con common_user_prefix, por lo general c##, para crear un usuario común. Por ejemplo, wlmagent se convierte en c##wlmagent.
```
CREATE USER wlmagent IDENTIFIED BY password;
```
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;
```
Sal de sqlplus y del usuario oracle.
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
```
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"
          }
        }
      ]
    }
  }
}
```
Guarda el archivo de configuración.
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:

En la consola de Google Cloud , ve a Monitoring.
Haz clic en Explorador de métricas.
En Buscar tipo de recurso y métrica, 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 ver 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 recopiladas por el agente, puedes crear paneles personalizados de Cloud Monitoring siguiendo las instrucciones en Crea y administra paneles personalizados.

Proporcionamos un panel de ejemplo 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:

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

En el repositorio de GitHub del agente para cargas de trabajo de Compute, 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

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 admitidas y sus rutas de Cloud Monitoring correspondientes:

Memoria del proceso
- Memoria de proceso (PGA) en uso, en bytes.
  
  process/pga_memory/total_used_size
- Memoria del 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
- Cantidad 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 en la realización de llamadas a nivel del usuario de la base de datos, en segundos
  
  sys_time/db_time
- Tiempo de CPU empleado en 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 instrucciones de SQL
  
  sys_time/sql_execute_elapsed_time
- Cantidad de tiempo transcurrido dedicado al análisis de instrucciones de SQL
  
  sys_time/parse_time_elapsed
- Cantidad de tiempo transcurrido durante la ejecución del intérprete de PL/SQL
  
  sys_time/pl_sql_execution_elapsed_time
- Tiempo transcurrido consumido por 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 de rehacer el transporte, en segundos
  
  dataguard/transport_lag

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

Usa SSH para conectarte a la instancia de VM.

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:

Usa SSH para conectarte a la instancia de VM.
Ejecuta el comando siguiente:
```
yum info google-cloud-workload-agent
```

Busca actualizaciones

Usa SSH para conectarte a la instancia de VM.

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:

Usa SSH para conectarte a la instancia de VM.

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 parámetro log_level controla el nivel de detalle del registro. Establecer el nivel de registro de 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 desde tus instancias de VM a Cloud Logging.

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

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

Ir al Explorador de registros
Ve al panel Consulta.
En el menú desplegable Recursos, selecciona Global y, luego, haz clic en Aplicar.
En el Editor de consultas, ingresa google-cloud-workload-agent.
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:

Usa SSH para conectarte a tu instancia de VM.

Reemplaza el archivo de configuración del agente:

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

Para la propiedad log_to_cloud, actualiza el valor a false.
Guarda el archivo de configuración.
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 a 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 privilegios suficientes 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 cualquiera de los roles faltantes requeridos a la cuenta de servicio.
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.

`UNKNOWN`	`0`
`STARTED`	`1`
`MOUNTED`	`2`
`OPEN`	`3`
`OPEN MIGRATE`	`4`

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

Configura el agente para las cargas de trabajo de Oracle Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Revisa los requisitos del sistema

Otorga roles de IAM a la cuenta de servicio

Habilita el acceso a las API de Cloud

Instala y configura el agente con el administrador de paquetes

Instala y administra el agente en una flota de VMs con VM Extension Manager

Configura VM Extension Manager

Instala el agente en una flota de VMs

Console

gcloud

Verifica la instalación del agente

Parámetros de configuración

Recopila y visualiza métricas de Oracle

Habilita la recopilación de métricas

Visualiza las métricas

Visualiza métricas en el Explorador de métricas

Cómo importar un panel personalizado

Métricas admitidas

Administra el agente

Reinicia el agente

Verifica la versión del agente

Busca actualizaciones

Actualiza el agente

Cómo ver los registros del agente

Configura los registros del agente en Cloud Logging

Soluciona problemas

Permisos de IAM insuficientes

Permisos de autenticación insuficientes

Las métricas no aparecen en Cloud Monitoring

No se pudo cargar el archivo de configuración

No se pudo inicializar la recopilación de datos

Configura el agente para las cargas de trabajo de Oracle