Oracle Management Agent pour Enterprise Manager Cloud Control

Oracle Enterprise Manager (OEM) Management Agent est un composant logiciel qui surveille les cibles en cours d'exécution sur les hôtes et communique ces informations au Oracle Management Service (OMS) de niveau intermédiaire. Amazon RDS prend en charge Management Agen via l'utilisation due l'option OEM_AGENT.

Pour plus d'informations, consultez les présentations Overview of Oracle Enterprise Manager Cloud Control 12c et Overview of Oracle Enterprise Manager Cloud Control 13c dans la documentation Oracle.

Exigences relatives à l'agent de gestion

Les exigences générales relatives à l'utilisation de l'agent de gestion sont les suivantes :

Prérequis à la communication avec l'hôte OMS

Vérifiez que votre hôte OMS et votre instance de base de données Amazon RDS peuvent communiquer. Procédez comme suit :

Limitations pour Management Agent

Voici quelques limitations quant à l'utilisation de Management Agent :

Paramètres de l'option Management Agent

Amazon RDS prend en charge les paramètres suivants pour l'option Management Agent.

La table suivante répertorie les suites de chiffrement TLS prises en charge par l'option Management Agent.

Étape 1 : ajout de l'option d'agent de gestion à votre instance de base de données

Pour ajouter l'option d'agent de gestion à votre instance de base de données, procédez comme suit :

Si des erreurs se produisent, vous pouvez consulter les documents My Oracle Support pour savoir comment résoudre des problèmes spécifiques.

Après avoir ajouté l'option Management Agent, vous n'avez pas besoin de redémarrer votre instance de base de données. Dès que le groupe d'options est actif, l'agent OEM est actif.

Si votre hôte OMS utilise un certificat tiers non approuvé, Amazon RDS renvoie l'erreur suivante :

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.        

S'il vous renvoie une erreur, l'option Management Agent n'est pas activée avant que le problème soit résolu. Pour plus d'informations sur la résolution des problèmes, consultez le document du Support 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

Étape 2 : Déverrouillage du compte utilisateur DBSNMP

L'agent de gestion utilise le compte DBSNMP utilisateur pour se connecter à la base de données et signaler les problèmes à Oracle Enterprise Manager. Dans un CDB, DBSNMP c'est un utilisateur ordinaire. Ce compte utilisateur est nécessaire à la fois pour l'agent de gestion et pour OEM Database Express. Par défaut, ce compte est verrouillé. La procédure de déverrouillage de ce compte varie selon que votre base de données utilise une architecture non CDB ou CDB.

Étape 3 : ajout de vos cibles à la console de l'agent de gestion

Pour ajouter une instance de base de données en tant que cible, assurez-vous de connaître le point de terminaison et le port. Pour plus d'informations sur la recherche du point de terminaison de votre instance de base de données Amazon RDS, consultez Recherche du point de terminaison de votre instance de base de données RDS for Oracle. Si votre base de données utilise l'architecture CDB, ajoutez le CDB$ROOT conteneur séparément en tant que cible.

Administration de l'agent de gestion

Vous pouvez utiliser les procédures Amazon RDS for exécuter certaines commandes EMCTL sur Management Agent. Ces procédures vous permettent d'exécuter les tâches indiquées ci-après.

Obtenir le statut de l'agent de gestion

Pour obtenir le statut de l'agent de gestion, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent. Cette procédure est équivalente à la commande emctl status agent.

La procédure suivante crée une tâche permettant d'obtenir le statut du Management Agent et renvoie l'ID de la tâche.

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

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Redémarrage du Management Agent

Pour redémarrer le Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent. Cette procédure équivaut à exécuter les commandes emctl stop agent et emctl start agent.

La procédure suivante crée une tâche permettant de redémarrer Management Agent et renvoie l'ID de la tâche.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Liste des cibles surveillées par le Management Agent

Pour répertorier les cibles surveillées par le Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent. Cette procédure équivaut à exécuter la commande emctl config agent listtargets.

La procédure suivante crée une tâche pour répertorier les cibles surveillées par Management Agent et renvoie l'ID de la tâche.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Constitution de la liste des threads de collecte surveillés par Management Agent

Pour répertorier tous les threads de collecte (en cours d'exécution, prêts et planifiés) surveillés par Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent. Cette procédure est équivalente à la commande emctl status agent scheduler.

La procédure suivante crée une tâche pour répertorier les threads de collecte et renvoie l'ID de la tâche.

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

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Suppression de l'état du Management Agent

Pour supprimer l'état du Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent. Cette procédure équivaut à exécuter la commande emctl clearstate agent.

La procédure suivante crée une tâche permettant d'annuler le statut de Management Agent et renvoie l'ID de la tâche.

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

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Chargement de l'OMS par le Management Agent

Pour que le Management Agent charge l'OMS (Oracle Management Server) qui lui est associé, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent. Cette procédure équivaut à exécuter la commande emclt upload agent.

La procédure suivante crée une tâche dans laquelle Management Agent charge son OMS associé et renvoie l'ID de la tâche.

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

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Envoi de la commande Ping vers l'OMS

Pour envoyer la commande Ping à l'OMS du Management Agent, exécutez la procédure Amazon RDS rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent. Cette procédure équivaut à exécuter la commande emctl pingOMS.

La procédure suivante crée une tâche permettant de pinger l'OMS de Management Agent et renvoie l'ID de la tâche.

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

Pour voir le résultat en affichant le fichier de sortie de la tâche, veuillez consulter Affichage du statut d'une tâche en cours.

Affichage du statut d'une tâche en cours

Vous pouvez consulter le statut d'une tâche en cours dans un fichier bdump. Les fichiers bdump se trouvent dans le répertoire /rdsdbdata/log/trace. Chaque nom de fichier bdump a le format suivant.

dbtask-task-id.log 

Lorsque vous souhaitez surveiller une tâche, remplacez task-id par l'ID de la tâche que vous souhaitez surveiller.

Pour afficher le contenu des fichiers bdump, exécutez la procédure Amazon RDS rdsadmin.rds_file_util.read_text_file. La requête suivante renvoie le contenu du fichier bdump dbtask-1546988886389-2444.log.

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

Pour de plus amples informations sur la procédure Amazon RDS rdsadmin.rds_file_util.read_text_file, veuillez consulter Lecture de fichiers dans un répertoire d'instance de base de données.

Suppression de l'option Management Agent

Vous pouvez supprimer l'agent OEM d'une instance de base de données. Lorsque vous avez supprimé l'agent OEM, vous n'avez pas besoin de redémarrer votre instance de base de données.

Pour supprimer l'agent OEM d'une instance de base de données, effectuez l'une des actions suivantes :