1. Linux용 Oracle 인스턴트 클라이언트 설치 지침을 따릅니다.

2. 다음을 확인합니다.

   • Instant Client Basic과 SDK 패키지가 모두 설치되어 있습니다. Oracle 다운로드 페이지에서 해당 패키지를 찾으세요.

     Instant Client 라이브러리를 설치한 후 런타임 링커가 라이브러리를 찾을 수 있는지 확인합니다. 예를 들어 ldconfig를 사용합니다.

     # Put the library location in an ld configuration file.
     
     sudo sh -c "echo /usr/lib/oracle/12.2/client64/lib > \
         /etc/ld.so.conf.d/oracle-instantclient.conf"
     
     # Update the bindings.
     
     sudo ldconfig
     

   • 두 패키지 모두 해당 머신에서 모든 사용자가 사용할 수 있는 단일 디렉터리(예: /opt/oracle)로 압축 해제됩니다.

     mkdir -p /opt/oracle/ && cd /opt/oracle/
     unzip /opt/oracle/instantclient-basic-linux.x64-12.1.0.2.0.zip
     unzip /opt/oracle/instantclient-sdk-linux.x64-12.1.0.2.0.zip
     

1. Oracle 윈도우즈(Windows) 설치 지침에 따라 Oracle 인스턴트 클라이언트를 설정합니다.

2. 다음을 확인합니다.

   • Microsoft Visual Studio 2017 Redistributable 또는 해당 버전이 Oracle 인스턴트 클라이언트에 설치되어 있습니다.

   • Oracle의 [다운로드 페이지][18]에서 Instant Client Basic 및 SDK 패키지가 모두 설치되었습니다.

   • 두 패키지 모두 해당 머신의 모든 사용자가 사용할 수 있는 단일 디렉터리(예: C:\oracle)로 추출됩니다.

Oracle 데이터베이스 서버에 적절한 접근 권한을 가진 읽기 전용 datadog 사용자를 생성합니다. SYSDBA 또는 SYSOPER 같은 관리자 사용자로 Oracle 데이터베이스에 연결하고 다음을 실행합니다.

-- Oracle Script를 활성화합니다.
ALTER SESSION SET "_ORACLE_SCRIPT"=true;

-- datadog 사용자를 생성하고. 비밀번호 플레이스홀더를 안전한 비밀번호로 바꿉니다.
CREATE USER datadog IDENTIFIED BY <PASSWORD>;

-- datadog 사용자에 접근 권한을 부여합니다.
GRANT CONNECT TO datadog;
GRANT SELECT ON GV_$PROCESS TO datadog;
GRANT SELECT ON gv_$sysmetric TO datadog;
GRANT SELECT ON sys.dba_data_files TO datadog;
GRANT SELECT ON sys.dba_tablespaces TO datadog;
GRANT SELECT ON sys.dba_tablespace_usage_metrics TO datadog;

참고: Oracle 11g를 사용하는 경우 다음 줄을 실행할 필요가 없습니다.

ALTER SESSION SET "_ORACLE_SCRIPT"=true;

Oracle 12c 또는 19c

datadog 사용자를 생성하고 권한을 부여하려면 Administrator로 루트 데이터베이스에 로그인하세요.

alter session set container = cdb$root;
CREATE USER c##datadog IDENTIFIED BY password CONTAINER=ALL;
GRANT CREATE SESSION TO c##datadog CONTAINER=ALL;
Grant select any dictionary to c##datadog container=all;
GRANT SELECT ON GV_$PROCESS TO c##datadog CONTAINER=ALL;
GRANT SELECT ON gv_$sysmetric TO c##datadog CONTAINER=ALL;

호스트에서 실행 중인 Agent에 이 점검을 구성하는 방법:

1. Agent 구성 디렉터리 루트에 있는 conf.d/ 폴더에서 oracle.d/conf.yaml 파일을 편집합니다. server 및 port를 업데이트하여 주요 항목이 모니터링하도록 설정합니다. 사용 가능한 모든 구성 옵션은 샘플 oracle.d/conf.yaml을 참고하세요.

   init_config:
   
   instances:
      ## @param server - string - required
      ## The IP address or hostname of the Oracle Database Server.
      #
      - server: localhost:1521
   
        ## @param service_name - string - required
        ## The Oracle Database service name. To view the services available on your server,
        ## run the following query: `SELECT value FROM v$parameter WHERE name='service_names'`
        #
        service_name: <SERVICE_NAME>
   
        ## @param username - string - required
        ## The username for the Datadog user account.
        #
        username: <USERNAME>
   
        ## @param password - string - required
        ## The password for the Datadog user account.
        #
        password: <PASSWORD>
   

2. 에이전트를 재시작하세요.

커스텀 쿼리만 해당

인스턴스에 기본 메트릭 점검을 건너뛰고 기존 메트릭 수집 사용자로만 커스텀 쿼리를 실행하려면 true 값과 함께 태그 only_custom_queries를 삽입합니다. 이렇게 하면 구성된 Oracle 통합 인스턴스에서 시스템, 프로세스, 테이블스페이스 메트릭이 실행되지 않도록 할 수 있으며, Datadog 사용자 생성 섹션에 설명된 권한 없이도 커스텀 쿼리를 실행할 수 있습니다. 이 구성 항목을 생략하면 지정된 사용자에게 커스텀 쿼리 실행을 위한 해당 테이블 권한이 있어야 합니다.

init_config:

instances:
  ## @param server - 문자열 - 필수
  ## Oracle 데이터베이스 서버의 IP 주소 또는 호스트 이름.
  #
  - server: localhost:1521

    ## @param service_name - 문자열 - 필수
    ## Oracle 데이터베이스 서비스 이름. 서버에서 사용 가능한 서비스를 보려면
    ## 다음 쿼리를 실행하세요.
    ## `SELECT value FROM v$parameter WHERE name='service_names'`
    #
    service_name: "<SERVICE_NAME>"

    ## @param username - 문자열 - 필수
    ## 사용자 계정 사용자 이름.
    #
    username: <USER>

    ## @param password - 문자열 - 필수
    ## 사용자 계정 비밀번호.
    #
    password: "<PASSWORD>"

    ## @param only_custom_queries - 문자열 - 선택 사항
    ## 이 인스턴스에 대해서만 커스텀 쿼리를 실행하려면 
    ## 이 파라미터를 아무 값으로 설정하세요.
    #
    only_custom_queries: true

TCPS를 통해 Oracle에 연결

1. TCPS(SSL을 사용한 TCP)를 통해 Oracle에 연결하려면 protocol 설정 옵션의 주석을 해제하고 TCPS를 선택합니다. server 옵션을 업데이트하여 TCPS 서버가 모니터링하도록 설정합니다.

   init_config:
   
   instances:
     ## @param server - string - required
     ## The IP address or hostname of the Oracle Database Server.
     #
     - server: localhost:1522
   
       ## @param service_name - string - required
       ## The Oracle Database service name. To view the services available on your server,
       ## run the following query:
       ## `SELECT value FROM v$parameter WHERE name='service_names'`
       #
       service_name: "<SERVICE_NAME>"
   
       ## @param username - string - required
       ## The username for the user account.
       #
       username: <USER>
   
       ## @param password - string - required
       ## The password for the user account.
       #
       password: "<PASSWORD>"
   
       ## @param protocol - string - optional - default: TCP
       ## The protocol to connect to the Oracle Database Server. Valid protocols include TCP and TCPS.
       ##
       ## When connecting to Oracle Database via JDBC, `jdbc_truststore` and `jdbc_truststore_type` are required.
       ## More information can be found from Oracle Database's whitepaper:
       ##
       ## https://www.oracle.com/technetwork/topics/wp-oracle-jdbc-thin-ssl-130128.pdf
       #
       protocol: TCPS
   

2. Oracle 데이터베이스에서 TCPS 연결을 허용하려면 sqlnet.ora, listener.ora, tnsnames.ora를 업데이트합니다.

JDBC 없이 Oracle을 통한 TCPS

JDBC를 사용하지 않는다면 Datadog Agent가 데이터베이스에 연결할 수 있는지 확인합니다. 설정 옵션에 입력한 정보와 함께 sqlplus 명령줄 도구를 사용하세요.

sqlplus <USER>/<PASSWORD>@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=<HOST>)(PORT=<PORT>))(SERVICE_NAME=<SERVICE_NAME>)))

Oracle Instant Client 연결 사용 시 애플리케이션에서 사용하는 클라이언트 라이브러리 network/admin 디렉토리로 세 개의 파일을 이동합니다.

• tnsnames.ora: 애플리케이션 연결 문자열에 사용되는 넷 서비스 이름을 데이터베이스 서비스에 매핑합니다.
• sqlnet.ora: Oracle Network 설정을 구성합니다.
• cwallet.sso: SSL 또는 TLS 연결을 활성화합니다. 이 파일을 안전하게 보관하세요.

JDBC를 통한 TCPS

JDBC를 사용하여 Oracle Database에 연결 시 truststore에 비밀번호가 있다면 jdbc_truststore_path, jdbc_truststore_type, jdbc_truststore_password(선택 사항)도 지정해야 합니다.

참고: SSO truststore에는 비밀번호가 필요하지 않습니다.

    # `instances:` 섹션에서
    ...

    ## @param jdbc_truststore_path - 문자열 - 선택 사항
    ## JDBC truststore 파일 경로.
    #
    jdbc_truststore_path: /path/to/truststore

    ## @param jdbc_truststore_type - 문자열 - 선택 사항
    ## JDBC truststore 파일 유형. 지원되는 truststore 유형은 JKS, SSO, PKCS12.
    #
    jdbc_truststore_type: SSO

    ## @param jdbc_truststore_password - 문자열 - 선택 사항
    ## JDBC를 통해 연결할 때 truststore 비밀 번호.
    #
    # jdbc_truststore_password: <JDBC_TRUSTSTORE_PASSWORD>

JDBC에서 TCPS를 통해 Oracle Database에 연결하는 방법은 공식 Oracle 백서를 참고하세요.

컨테이너화된 환경에서 아래의 파라미터를 적용하려면 Autodiscovery 통합 템플릿을 참고하세요.