Oracle Management Agent para Enterprise Manager Cloud Control

Oracle Enterprise Manager (OEM) Management Agent es un componente de software que monitoriza destinos que se ejecutan en hosts y comunica esa información al nivel intermedio de Oracle Management Service (OMS). Amazon RDS es compatible con Management Agent mediante el uso de la opción OEM_AGENT.

Para obtener más información, consulte Overview of Oracle Enterprise Manager Cloud Control 12c y Overview of Oracle Enterprise Manager Cloud Control 13c en la documentación de Oracle.

Requisitos de Management Agent

A continuación, se indican los requisitos generales para utilizar Management Agent:

Requisitos previos de comunicación del host de OMS

Asegúrese de que su host de OMS y su instancia de base de datos de Amazon RDS puedan comunicarse. Haga lo siguiente:

Limitaciones de Management Agent

A continuación se indican algunas limitaciones al utilizar Management Agent:

Configuración de opción de Management Agent

Amazon RDS admite la siguiente configuración para la opción de Management Agent.

La siguiente tabla muestra los conjuntos de cifrado TLS que admite la opción Management Agent.

Paso 1: añadir la opción Management Agent a su instancia de base de datos

Para añadir la opción Management Agent a una instancia de base de datos, haga lo siguiente:

Si se produce algún error, consulte los documentos de My Oracle Support para obtener información sobre cómo solucionar determinados problemas.

Después de agregar la opción de Management Agent, no es necesario reiniciar la instancia de base de datos. En cuanto esté activo el grupo de opciones, OEM Agent también lo estará.

Si el host OMS usa un certificado de terceros que no es de confianza, Amazon RDS devolverá el error siguiente.

You successfully installed the OEM_AGENT option. Your OMS host is using an untrusted third party certificate. 
Configure your OMS host with the trusted certificates from your third party.        

Si se devuelve este error, la opción de Management Agent no se habilitará hasta que se haya solucionado el problema. Para obtener información acerca de cómo corregir el problema, consulte el documento de soporte de My Oracle 2202569.1.

aws rds add-option-to-option-group \
    --option-group-name "myoptiongroup" \
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] \
    --apply-immediately

aws rds add-option-to-option-group ^
    --option-group-name "myoptiongroup" ^
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] ^
    --apply-immediately

Paso 2: desbloquear la cuenta de usuario de DBSNMP

Management Agent utiliza la cuenta de usuario de DBSNMP para conectarse a la base de datos y notificar los problemas a Oracle Enterprise Manager. En una CDB, DBSNMP es un usuario común. Esta cuenta de usuario es necesaria tanto para Management Agent como para OEM Database Express. De forma predeterminada, esta cuenta está bloqueada. El procedimiento para desbloquear esta cuenta varía en función de si la base de datos utiliza una arquitectura de CDB o no de CDB.

Paso 3: añadir los destinos a la consola de Management Agent

Para añadir una instancia de base de datos como destino, debe conocer el punto de conexión y el puerto. Para obtener información acerca de cómo encontrar el punto de enlace de su instancia de base de datos de Amazon RDS, consulte Búsqueda del punto de conexión de la instancia de base de datos de RDS para Oracle. Si su base de datos utiliza la arquitectura de CDB, añada el contenedor CDB$ROOT por separado como destino.

Administración de Management Agent

Puede utilizar procedimientos de Amazon RDS para ejecutar determinados comandos de EMCTL en Management Agent. Al ejecutar estos procedimientos, puede hacer las tareas que se enumeran a continuación.

Obtención del estado del agente de administración

Para obtener el estado del agente de administración, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent de Amazon RDS. Este procedimiento es equivalente al comando emctl status agent.

El siguiente procedimiento crea una tarea para obtener el estado del agente de gestión y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL;            

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Reinicio del Management Agent

Para reiniciar el Management Agent, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent de Amazon RDS. Este procedimiento es equivalente a ejecutar los comandos emctl stop agent y emctl start agent.

El siguiente procedimiento crea una tarea para reiniciar Management Agent y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Descripción de los objetivos monitoreados por el Management Agent

Para enumerar los objetivos monitorizados por el Management Agent, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent de Amazon RDS. Este procedimiento es equivalente a ejecutar el comando emctl config agent listtargets.

El siguiente procedimiento crea una tarea para mostrar los destinos monitoreados por Management Agent y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Descripción de los subprocesos de recopilación monitoreados por Management Agent

Para mostrar todos los subprocesos de recopilación en ejecución, listos y programados monitoreados por Management Agent, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent de Amazon RDS. Este procedimiento es equivalente al comando emctl status agent scheduler.

El siguiente procedimiento crea una tarea para enumerar los subprocesos de recopilación y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL;          

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Borrado del estado de Management Agent

Para borrar el estado de Management Agent, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent de Amazon RDS. Este procedimiento es equivalente a ejecutar el comando emctl clearstate agent.

El siguiente procedimiento crea una tarea que borra el estado de Management Agent y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL;

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Hacer que Management Agent cargue su OMS

Para que Management Agent cargue el Oracle Management Server (OMS) asociado al mismo, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent de Amazon RDS. Este procedimiento es equivalente a ejecutar el comando emclt upload agent.

El procedimiento siguiente crea una tarea que hace que Management Agent cargue su OMS asociado y devuelva el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL;

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Hacer ping al OMS

Para hacer ping al OMS del Management Agent, ejecute el procedimiento rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent de Amazon RDS. Este procedimiento es equivalente a ejecutar el comando emctl pingOMS.

El siguiente procedimiento crea una tarea que realiza ping al OMS de Management Agent y devuelve el ID de la tarea.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL;

Para ver el resultado mostrando el archivo de salida de la tarea, consulte Visualización del estado de una tarea en curso.

Visualización del estado de una tarea en curso

Puede ver el estado de una tarea continua en un archivo bdump. Los archivos bdump están ubicados en el directorio /rdsdbdata/log/trace. El nombre del archivo bdump está en el siguiente formato.

dbtask-task-id.log 

Si desea monitorizar una tarea, reemplace task-id por el ID de la tarea que desea monitorizar.

Para ver el contenido de los archivos bdump, ejecute el procedimiento de Amazon RDS rdsadmin.rds_file_util.read_text_file. Por ejemplo, la siguiente consulta devuelve el contenido del archivo bdump dbtask-1546988886389-2444.log.

SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log'));

Si necesita más información sobre el procedimiento rdsadmin.rds_file_util.read_text_file de Amazon RDS, consulte Lectura de archivos de un directorio de instancia de base de datos.

Eliminar la opción de Management Agent

Puede eliminar OEM Agent de una instancia de base de datos. Después de eliminar OEM Agent, no es necesario reiniciar la instancia de base de datos.

Para eliminar OEM Agent de una instancia de base de datos, realice una de las siguientes operaciones: