Oracle Management Agent for Enterprise Manager Cloud Control

Oracle Enterprise Manager(OEM) Management Agent는 호스트에서 실행되는 대상을 모니터링하고 해당 정보를 미들티어 Oracle Management Service(OMS)에 전달하는 소프트웨어 구성 요소입니다. Amazon RDS는 OEM_AGENT 옵션 사용을 통해 Management Agent를 지원합니다.

자세한 내용은 Oracle 설명서에서 Overview of Oracle Enterprise Manager Cloud Control 12c 및 Overview of Oracle Enterprise Manager Cloud Control 13c 단원을 참조하십시오.

Management Agent 요구 사항

다음은 Management Agent 사용을 위한 일반적인 요구 사항입니다.

OMS 호스트 통신 사전 요구 사항

OMS 호스트와 Amazon RDS DB 인스턴스가 통신해야 합니다. 다음을 수행합니다.

Management Agent의 제한 사항

다음은 Management Agent를 사용할 때 적용되는 몇 가지 제한 사항입니다.

Management Agent 옵션 설정

Amazon RDS는 Management Agent 옵션에 대해 다음 설정을 지원합니다.

다음 표에는 관리 에이전트 옵션에서 지원하는 TLS 암호 그룹이 나와 있습니다.

1단계: Management Agent 옵션을 DB 인스턴스에 추가

DB 인스턴스에 Management Agent 옵션을 추가하려면 다음을 수행하세요.

오류가 발생할 경우 My Oracle Support 문서에서 특정 문제를 해결하는 자세한 내용을 확인합니다.

Management Agent 옵션을 추가한 후 DB 인스턴스를 재시작할 필요가 없습니다. 옵션 그룹이 활성화되자마자 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.        

이 오류가 반환되면 문제가 해결될 때까지 관리 에이전트 옵션을 사용할 수 없습니다. 문제 해결에 대한 정보는 My Oracle Support 설명서 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 콘솔에 대상 추가

DB 인스턴스를 대상으로 추가하려면 엔드포인트와 포트를 알고 있어야 합니다. 사용자의 Amazon RDS DB 인스턴스에 대한 엔드포인트를 찾는 방법은 RDS for Oracle DB 인스턴스의 엔드포인트 찾기 단원을 참조하십시오. 데이터베이스에서 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 명령과 동일합니다.

다음 절차에서는 Management 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 명령을 실행하는 것과 동일합니다.

다음 절차에서는 Management 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 명령을 실행하는 것과 동일합니다.

다음 절차에서는 Management Agent가 모니터링하는 대상을 나열하는 작업을 생성하고 작업 ID를 반환합니다.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

작업의 출력 파일을 표시하여 결과를 보려면 진행 중인 작업 상태 보기 단원을 참조하십시오.

Management Agent가 모니터링하는 수집 스레드 나열

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 명령을 실행하는 것과 동일합니다.

다음 절차에서는 Management Agent의 상태를 지우는 작업을 생성하고 작업 ID를 반환합니다.

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

작업의 출력 파일을 표시하여 결과를 보려면 진행 중인 작업 상태 보기 단원을 참조하십시오.

Management Agent에서 OMS 업로드

Management Agent가 관련 OMS(Oracle Management Server)를 업로드하도록 하려면 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 명령을 실행하는 것과 동일합니다.

다음 절차에서는 Management Agent의 OMS에 대해 ping을 수행하는 작업을 생성하고 작업 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에 대한 자세한 내용은 DB 인스턴스 디렉터리의 파일 목록 읽기 단원을 참조하십시오.

Management Agent 옵션 제거

DB 인스턴스에서 OEM Agent를 제거할 수 있습니다. OEM Agent를 제거한 후 DB 인스턴스를 재시작할 필요가 없습니다.

DB 인스턴스에서 OEM Agent를 제거하려면 다음 중 하나를 수행합니다.