适用于 Enterprise Manager Cloud Control 的 Oracle Management Agent

Oracle Enterprise Manager (OEM) Management Agent 是一种软件组件，可监控在主机上运行的目标并将该信息传达到中间层 Oracle Management Service (OMS)。Amazon RDS 通过使用 OEM_AGENT 选项支持 Management Agent。

有关更多信息，请参阅 Oracle 文档中的 Oracle Enterprise Manager Cloud Control 12c 概述和 Oracle Enterprise Manager Cloud Control 13c 概述。

Management Agent 的要求

以下是使用 Management Agent 的一般要求：

OMS 主机通信先决条件

确保您的 OMS 主机和您的 Amazon RDS 数据库实例可以通信。执行以下操作：

Management Agent 的限制

以下是使用 Management Agent 的一些限制：

Management Agent 的选项设置

Amazon RDS 支持 Management Agent 选项的以下设置。

下表列出了 Management Agent 选项支持的 TLS 密码套件。

步骤 1：将 Management Agent 选项添加到数据库实例

要将 Management Agent 选项添加到数据库实例，请执行以下操作：

如果遇到错误，请查看我的 Oracle 支持文档以了解有关解决特定问题的信息。

在添加“Management Agent”选项后，您无需重新启动数据库实例。只要选项组处于活动状态，OEM Agent 就处于活动状态。

如果 OMS 主机使用的是不受信任的第三方证书，则 Amazon RDS 将返回以下错误。

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.        

如果返回此错误，则在更正问题之前，不会启用 Management Agent 选项。有关更正问题的信息，请参阅“我的 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

步骤 2：解锁 DBSNMP 用户账户

Management Agent 使用 DBSNMP 用户账户连接到数据库，并向 Oracle Enterprise Manager 报告问题。在 CDB 中，DBSNMP 是普通用户。Management Agent 和 OEM Database Express 都需要此用户账户。默认情况下，此账户处于锁定状态。解锁此账户的过程会有所不同，具体取决于数据库使用的是非 CDB 还是 CDB 架构。

步骤 3：将目标添加到 Management Agent 控制台

要将数据库实例添加为目标，请确保您知道端点和端口。有关查找 Amazon RDS 数据库实例的终端节点的信息，请参阅 查找 RDS for Oracle 数据库实例的端点。如果数据库使用 CDB 架构，则将 CDB$ROOT 容器单独添加为目标。

管理 Management Agent

您可以使用 Amazon RDS 过程在 Management Agent 上运行某些 EMCTL 命令。通过运行这些过程，您可以执行下面列出的任务。

获取 Management Agent 的状态

要获取 Management Agent 的状态，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent。该过程相当于 emctl status agent 命令。

以下过程创建一个任务来获取管理代理的状态，并返回任务的 ID。

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

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

重新启动 Management Agent

要重新启动 Management Agent，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent。该过程相当于运行 emctl stop agent 和 emctl start agent 命令。

以下过程创建一个任务来重新启动管理代理并返回任务的 ID。

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;    

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

列出 Management Agent 监控的目标

要列出 Management Agent 监控的目标，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent。该过程相当于运行 emctl config agent listtargets 命令。

以下过程创建一个任务来列出管理代理监控的目标并返回任务的 ID。

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

列出 Management Agent 监控的收集线程

要列出管理代理监控的所有正在运行、就绪和计划的收集线程，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent。该过程相当于 emctl status agent scheduler 命令。

以下过程创建一个任务来列出收集线程并返回任务的 ID。

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

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

清除 Management Agent 的状态

要清除 Management Agent 的状态，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent。该过程相当于运行 emctl clearstate agent 命令。

以下过程创建一个任务来清除管理代理的状态并返回任务的 ID。

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

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

让 Management Agent 上载其 OMS

要让 Management Agent 上载与其关联的 Oracle Management Server (OMS)，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent。该过程相当于运行 emclt upload agent 命令。

以下过程创建一个任务，使 Management Agent 上传其关联的 OMS 并返回任务的 ID。

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

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

为 OMS 执行 ping 操作

要为 Management Agent 的 OMS 执行 ping 操作，请运行 Amazon RDS 过程 rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent。该过程相当于运行 emctl pingOMS 命令。

以下过程创建一个任务来 Ping 管理代理的 OMS 并返回任务的 ID。

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

要通过显示任务的输出文件来查看结果，请参阅查看正在执行的任务的状态。

查看正在执行的任务的状态

您可以查看 bdump 文件中的持续任务的状态。bdump 文件位于 /rdsdbdata/log/trace 目录下。每个 bdump 文件名称格式如下。

dbtask-task-id.log 

如果要监控任务，请将 task-id 替换为要监控的任务的 ID。

要查看 bdump 文件的内容，请运行 Amazon RDS 过程 rdsadmin.rds_file_util.read_text_file。以下查询返回 dbtask-1546988886389-2444.log bdump 文件的内容。

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

有关 Amazon RDS 过程 rdsadmin.rds_file_util.read_text_file 的更多信息，请参阅读取数据库实例目录中的文件。

删除 Management Agent 选项

可以从数据库实例中删除 OEM Agent。删除 OEM Agent 后，您无需重新启动数据库实例。

要从数据库实例中删除 OEM Agent，请执行下列操作之一：