본문 바로가기
WIKI 기술 지식 베이스

Oracle Autonomous Database용 Database Monitoring 설정하기

원문 보기 위키 갱신

이 페이지에서는 Oracle Autonomous Database에 Database Monitoring을 설정하는 방법을 설명드릴게요. Database Monitoring은 쿼리 샘플을 노출해 각기 다른 워크로드를 프로파일링하고 문제를 진단할 수 있게 해 줍니다.

에이전트는 읽기 전용 사용자로 로그인해 데이터베이스에서 직접 원격 측정을 수집해요.

출처: 문서

본문

시작하기 전에 (Before you begin)

  • 지원되는 Oracle 버전: 11g, 12c, 18c, 19c, 21c
  • 지원되는 Agent 버전: 7.53.0+
  • 성능 영향: Database Monitoring의 기본 Agent 구성은 보수적이지만, 수집 간격이나 쿼리 샘플링 비율 같은 설정을 필요에 맞게 조정할 수 있어요. 대부분의 워크로드에서 에이전트는 데이터베이스 쿼리 실행 시간의 1% 미만, CPU의 1% 미만을 차지합니다. Database Monitoring은 기본 Agent 위에서 통합으로 실행돼요 (벤치마크 참고).
  • 프록시, 로드 밸런서, 커넥션 풀러: 에이전트는 모니터링 대상 호스트에 직접 연결해야 해요. 에이전트는 프록시, 로드 밸런서, 커넥션 풀러를 통해 데이터베이스에 연결하면 안 돼요. 각 에이전트는 기본 호스트 이름을 알고 있어야 하며, 장애 조치의 경우에도 수명 동안 단일 호스트를 고수해야 해요. Datadog Agent가 실행 중에 다른 호스트에 연결하면 메트릭 값이 부정확해져요.
  • 데이터 보안 고려 사항: 에이전트가 데이터베이스에서 수집하는 데이터와 이를 안전하게 유지하는 방법은 민감 정보 (Sensitive information) 문서를 참고하세요.

설정 (Setup)

Oracle 데이터베이스에 Database Monitoring을 활성화하려면 다음을 완료하세요.

  1. Datadog 사용자 만들기
  2. 사용자에게 데이터베이스 액세스 권한 부여하기
  3. 에이전트 설치하기
  4. 에이전트 구성하기
  5. Oracle 통합 설치 또는 확인하기
  6. 설정 검증하기

Datadog 사용자 만들기

기존의 레거시 Oracle 통합이 이미 설치되어 있다면 사용자가 이미 존재하므로 이 단계를 건너뛸 수 있어요.

서버에 연결하기 위한 읽기 전용 로그인을 만들고 필요한 권한을 부여하세요.

CREATE USER datadog IDENTIFIED BY <YOUR_PASSWORD>;

사용자에게 데이터베이스 액세스 권한 부여하기

grant create session to datadog ;
grant select on v$session to datadog ;
grant select on v$database to datadog ;
grant select on v$containers to datadog;
grant select on v$sqlstats to datadog ;
grant select on v$instance to datadog ;
grant select on dba_feature_usage_statistics to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$PROCESS to datadog ;
grant select on V$SESSION to datadog ;
grant select on V$CON_SYSMETRIC to datadog ;
grant select on CDB_TABLESPACE_USAGE_METRICS to datadog ;
grant select on CDB_TABLESPACES to datadog ;
grant select on V$SQLCOMMAND to datadog ;
grant select on V$DATAFILE to datadog ;
grant select on V$SYSMETRIC to datadog ;
grant select on V$SGAINFO to datadog ;
grant select on V$PDBS to datadog ;
grant select on CDB_SERVICES to datadog ;
grant select on V$OSSTAT to datadog ;
grant select on V$PARAMETER to datadog ;
grant select on V$SQLSTATS to datadog ;
grant select on V$CONTAINERS to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$SQL to datadog ;
grant select on V$PGASTAT to datadog ;
grant select on v$asm_diskgroup to datadog ;
grant select on v$rsrcmgrmetric to datadog ;
grant select on v$dataguard_config to datadog ;
grant select on v$dataguard_stats to datadog ;
grant select on v$transaction to datadog;
grant select on v$locked_object to datadog;
grant select on v$lock to datadog ;
grant select on gv$lock to datadog ;
grant select on dba_objects to datadog;
grant select on cdb_data_files to datadog;
grant select on dba_data_files to datadog;

비밀번호를 안전하게 저장하기

Vault 같은 비밀 관리 소프트웨어로 비밀번호를 저장하세요. 그러면 에이전트 설정 파일에서 이 비밀번호를 ENC[<SECRET_NAME>]로 참조할 수 있어요. 예: ENC[datadog_user_database_password]. 자세한 내용은 비밀 관리 (Secrets Management)를 참고하세요.

이 페이지의 예시는 비밀번호가 저장된 비밀의 이름으로 datadog_user_database_password를 사용합니다. 비밀번호를 평문으로 참조하는 것도 가능하지만 권장되지는 않아요.

에이전트 설치하기

에이전트를 어디에 설치할지 결정하려면 DBM 설정 아키텍처 문서를 참고하세요. 에이전트는 외부 Oracle 클라이언트가 필요하지 않아요.

설치 단계는 Agent 설치 지침을 참고하세요.

에이전트 구성하기

Oracle Cloud에서 지갑(wallet) zip 파일을 다운로드하고 압축을 풀어 주세요.

Oracle Agent conf 파일 /etc/datadog-agent/conf.d/oracle.d/conf.yaml을 만드세요. 모든 구성 옵션은 샘플 conf 파일을 참고하세요.

참고: 7.50.1과 7.53.0 사이의 Agent 릴리스용 구성 하위 디렉토리는 oracle-dbm.d입니다. 자세한 내용은 Agent 7.50.1+에서 Oracle 통합 구성하기를 참고하세요.

protocol과 wallet 구성 파라미터를 설정하세요.

init_config:
instances:
  - server: '<HOST_1>:<PORT>'
    service_name: "<SERVICE_NAME>" # Oracle CDB 서비스 이름
    username: 'datadog'
    password: 'ENC[datadog_user_database_password]'
    protocol: TCPS
    wallet: <YOUR_WALLET_DIRECTORY>
    dbm: true
    tags:  # 선택 사항
      - 'service:<CUSTOM_SERVICE>'
      - 'env:<CUSTOM_ENV>'
  - server: '<HOST_2>:<PORT>'
    service_name: "<SERVICE_NAME>" # Oracle CDB 서비스 이름
    username: 'datadog'
    password: 'ENC[datadog_user_database_password]'
    protocol: TCPS
    wallet: <YOUR_WALLET_DIRECTORY>
    dbm: true
    tags:  # 선택 사항
      - 'service:<CUSTOM_SERVICE>'
      - 'env:<CUSTOM_ENV>'

모든 에이전트 구성이 완료되면 Datadog Agent를 재시작하세요.

설정 검증하기

에이전트의 status 하위 명령을 실행해 Checks 섹션에서 oracle을 찾아보세요. Datadog의 DBM Oracle Database Overview 대시보드와 Databases 페이지로 이동해 시작하세요.

사용자 지정 쿼리 (Custom queries)

Database Monitoring은 Oracle 데이터베이스에 대한 사용자 지정 쿼리를 지원합니다. 사용 가능한 구성 옵션에 대해 알아보려면 conf.yaml.example을 참고하세요.

{% alert level="danger" %} 사용자 지정 쿼리를 실행하면 Oracle이 부과하는 추가 비용이나 수수료가 발생할 수 있어요. {% /alert %}

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 글: