자체 호스팅 PDB를 사용한 오라클 모니터링을 위한 NRDOT 설치 & 구성

뉴렐릭 Distribution of OpenTelemetry(NRDOT) 수집기를 사용하여 데이터베이스 모니터링, 쿼리 분석 및 시스템 상태 메트릭을 통해 오라클 플러거블 데이터베이스(PDB) 성능에 대한 포괄적인 인사이트를 얻으십시오.

가이드 설치

대신 뉴렐릭 UI를 통해 설치하려면 one.newrelic.com > Integrations & Agents > Oracle (Database 360)(으)로 이동하십시오. 이 페이지는 수동 설치만 다룹니다.

팁

개별 플러거블 데이터베이스가 아닌 전체 컨테이너 데이터베이스를 모니터해야 하는 경우 CDB 계측을 참조하십시오.

전제 조건

시작하기 전에 다음 사항이 있는지 확인하세요.

유효한 뉴렐릭 라이선스 키
지원 아키텍처: AMD64 및 ARM64 기반의 Linux
뉴렐릭 OTLP 엔드포인트에 대한 네트워크 연결
오라클 데이터베이스 19c 이상

NRDOT Collector설치하세요

사용 중인 Linux 환경에 맞는 설치 배포 방법을 선택하십시오.

Debian/Ubuntu 시스템의 경우 다음 명령을 실행하십시오.
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

RHEL/CentOS/OEL 시스템의 경우 다음 명령을 실행하십시오.

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Debian/Ubuntu 시스템의 경우 다음 명령을 실행하십시오.

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

RHEL/CentOS/OEL 시스템의 경우 다음 명령을 실행하십시오.

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

데이터베이스 사용자 구성

PDB 오라클 데이터베이스 인스턴스에 필요한 권한을 가진 모니터링 사용자를 생성하십시오.

사용자를 생성하거나 권한을 부여하기 전에 SYS로 다음 문을 실행하십시오:
```
ALTER SESSION SET CONTAINER = "<YOUR_PDB>";
```
로컬 모니터링 사용자를 생성하려면 타겟 PDB 내에서 SYS로 다음 명령문을 실행하십시오:
```
CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;
```

PDB에 대한 모니터링 권한을 부여하십시오.

PDB 내에서 SYS 사용자로 이 명령을 실행하십시오. 이를 통해 모니터링 도구가 메트릭을 수집하고, 이벤트를 추적하며, 데이터베이스 인스턴스를 찾는 데 필요한 기본 액세스 권한을 얻습니다.

GRANT SELECT ON V_$INSTANCE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$DATABASE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CONTAINERS TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$DATAFILE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SYSSTAT                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SYSMETRIC                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SESSION                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$OSSTAT                     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SGAINFO                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ROWCACHE                   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PARAMETER                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_TABLESPACES               TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_DATA_FILES                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_FREE_SPACE                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_RECYCLEBIN                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SQL            TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$LOCK           TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$SESSION_EVENT  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_PROCEDURES    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON DBA_OBJECTS       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PDBS      TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$PROCESS     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$TRANSACTION TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CON_SYSSTAT   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$CON_SYSMETRIC TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ASM_DISKGROUP_STAT TO <YOUR_DB_USERNAME>;
GRANT SELECT ON V_$ASM_DISK_STAT TO <YOUR_DB_USERNAME>;

팁

ASM 디스크 그룹 및 디스크 메트릭을 수집하려는 경우에만 V_$ASM_DISKGROUP_STAT 및 V_$ASM_DISK_STAT 권한이 필요합니다.

NRDOT Collector구성

PDB 관련 설정으로 NRDOT Collector를 설정하십시오.

설정 파일을 생성합니다. 파일 이름은 oracle-config.yaml이어야 합니다.
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```
이전 단계에서 생성한 oracle-config.yaml 파일에 아래 설정 내용을 추가하십시오:
전체 설정
이 설정은 필수 기준 메트릭을 캡처합니다. 전체 메트릭 카탈로그를 보려면 설정 참조를 확인하십시오.
오라클 PDB 호스트명/IP
오라클 데이터베이스 호스트명 또는 IP 주소를 입력하십시오.
오라클 PDB 포트
오라클 데이터베이스 포트 번호를 입력하십시오. 기본값은 1521입니다.
데이터베이스 사용자 이름
인증을 위해 데이터베이스 사용자 이름을 입력하세요.
데이터베이스 비밀번호
모니터링 사용자에 대해 설정한 비밀번호를 입력하십시오.
PDB 서비스 이름
오라클 PDB 서비스 이름을 입력하십시오.
뉴렐릭 OTLP 엔드포인트
뉴렐릭 OTLP 엔드포인트를 입력하십시오. 자세한 내용은 https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/를 참조하십시오.
뉴렐릭 라이선스 키
뉴렐릭 라이선스 키를 입력하십시오.
oracle-config.yaml
1 receivers: 2 nroracledb: 3 endpoint: oracle.example.com:1521 4 username: newrelic 5 password: YOUR_PASSWORD 6 service: YOUR_PDB_SERVICE_NAME 7 collection_interval: 15s 8 events: 9 db.server.query_sample: 10 enabled: true 11 db.server.top_query: 12 enabled: true 13 db.server.session.wait_sample: 14 enabled: true 15 db.server.top_procedure: 16 enabled: true 17 db.server.query_plan: 18 enabled: true 19 20 top_query_collection: 21 max_query_sample_count: 1000 22 top_query_count: 200 23 collection_interval: 60s 24 allowed_comment_keys: 25 - nr_service_guid 26 27 query_sample_collection: 28 max_rows_per_query: 100 29 allowed_comment_keys: 30 - nr_service_guid 31 32 session_wait_event_collection: 33 max_rows_per_query: 100 34 35 top_procedure_collection: 36 max_procedure_sample_count: 1000 37 top_procedure_count: 250 38 collection_interval: 60s 39 40 # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation 41 metrics: 42 oracledb.buffer_cache.utilization: 43 enabled: true 44 attributes: 45 - oracle.db.pdb 46 oracledb.consistent_gets: 47 enabled: true 48 attributes: 49 - oracle.db.pdb 50 oracledb.cpu_time: 51 enabled: true 52 attributes: 53 - oracle.db.pdb 54 oracledb.database.cpu.utilization: 55 enabled: true 56 attributes: 57 - oracle.db.pdb 58 oracledb.database.wait.utilization: 59 enabled: true 60 attributes: 61 - oracle.db.pdb 62 oracledb.db_block_gets: 63 enabled: true 64 attributes: 65 - oracle.db.pdb 66 oracledb.enqueue_deadlocks: 67 enabled: true 68 attributes: 69 - oracle.db.pdb 70 oracledb.execution.utilization: 71 enabled: true 72 attributes: 73 - oracledb.parse.type 74 - oracle.db.pdb 75 oracledb.executions: 76 enabled: true 77 attributes: 78 - oracle.db.pdb 79 oracledb.hard_parses: 80 enabled: true 81 attributes: 82 - oracle.db.pdb 83 oracledb.host.cpu.utilization: 84 enabled: true 85 attributes: 86 - oracle.db.pdb 87 oracledb.library_cache.utilization: 88 enabled: true 89 attributes: 90 - oracle.db.pdb 91 oracledb.logical_reads: 92 enabled: true 93 attributes: 94 - oracle.db.pdb 95 oracledb.logons: 96 enabled: true 97 attributes: 98 - oracle.db.pdb 99 oracledb.parse.rate: 100 enabled: true 101 attributes: 102 - oracledb.parse.result 103 - oracle.db.pdb 104 oracledb.parse_calls: 105 enabled: true 106 attributes: 107 - oracle.db.pdb 108 oracledb.pga_memory: 109 enabled: true 110 attributes: 111 - oracle.db.pdb 112 oracledb.physical_io.requests: 113 enabled: true 114 attributes: 115 - disk.io.direction 116 - disk.io.block_size 117 - oracle.db.pdb 118 oracledb.physical_reads: 119 enabled: true 120 attributes: 121 - oracle.db.pdb 122 oracledb.physical_writes: 123 enabled: true 124 attributes: 125 - oracle.db.pdb 126 oracledb.processes.usage: 127 enabled: true 128 oracledb.sessions.usage: 129 enabled: true 130 attributes: 131 - session_type 132 - session_status 133 - oracle.db.pdb 134 oracledb.sga.usage: 135 enabled: true 136 attributes: 137 - oracledb.sga.component.name 138 oracledb.shared_pool.utilization: 139 enabled: true 140 attributes: 141 - oracle.db.pdb 142 oracledb.sql_service.response.duration: 143 enabled: true 144 attributes: 145 - oracle.db.pdb 146 oracledb.sqlnet.io.transferred: 147 enabled: true 148 attributes: 149 - network.io.direction 150 - destination.type 151 - oracle.db.pdb 152 oracledb.tablespace_size.usage: 153 enabled: true 154 attributes: 155 - tablespace_name 156 - oracle.db.pdb 157 oracledb.transactions.usage: 158 enabled: true 159 oracledb.user_commits: 160 enabled: true 161 attributes: 162 - oracle.db.pdb 163 oracledb.user_rollbacks: 164 enabled: true 165 attributes: 166 - oracle.db.pdb 167 168 # Resource attributes attached to all metrics/logs (all enabled by default) 169 resource_attributes: 170 oracle.db.edition: 171 enabled: true 172 exporters: 173 otlp/newrelic: 174 endpoint: https://otlp.nr-data.net:4318 175 headers: 176 api-key: YOUR_LICENSE_KEY 177 compression: gzip 178 retry_on_failure: 179 enabled: true 180 initial_interval: 5s 181 max_interval: 30s 182 max_elapsed_time: 300s 183 sending_queue: 184 enabled: true 185 sizer: bytes 186 queue_size: 100_000_000 187 num_consumers: 10 188 batch: 189 sizer: bytes 190 max_size: 1_000_000 191 min_size: 0 192 flush_timeout: 5s 193 service: 194 pipelines: 195 metrics/oracledb: 196 receivers: [nroracledb] 197 exporters: [otlp/newrelic] 198 logs/oracledb: 199 receivers: [nroracledb] 200 exporters: [otlp/newrelic]

이벤트 섹션에서 이러한 이벤트 유형을 활성화하여 해당 메트릭을 수집합니다:

이벤트	설명
`db.server.query_sample`	현재 SQL, 대기 상태 및 차단 세부 정보를 캡처하는 세션별 활성 쿼리 샘플.
`db.server.top_query`	실행 통계 및 쿼리 계획을 포함하여 CPU 또는 경과 시간 기준 상위 N개의 SQL 문.
`db.server.session.wait_sample`	`v$session_event` 의 세션별 누적 대기 횟수 및 기간.
`db.server.top_procedure`	실행 통계를 포함하여 리소스 사용량에 따라 순위가 매겨진 상위 N개의 저장 프로시저입니다.
`db.server.query_plan`	상위 및 샘플링된 쿼리에 대한 실행 계획 세부 정보입니다.

각 이벤트 유형에 대한 수집 설정을 구성하십시오:

설정 섹션	매개변수	값
`top_query_collection`	`max_query_sample_count`	1000
`top_query_collection`	`top_query_count`	200
`top_query_collection`	`collection_interval`	60초
`query_sample_collection`	`max_rows_per_query`	도면 1
`session_wait_event_collection`	`max_rows_per_query`	도면 1
`top_procedure_collection`	`max_procedure_sample_count`	1000
`top_procedure_collection`	`top_procedure_count`	250
`top_procedure_collection`	`collection_interval`	60초

팁

뉴렐릭 OTLP 엔드포인트 설정 및 OpenTelemetry 모범 사례에 대한 자세한 내용은 OpenTelemetry OTLP 설명서를 참조하십시오.

NRDOT Collector 설정 업데이트

oracle-config.yaml 파일을 사용하도록 NRDOT Collector 설정을 업데이트하십시오:

bash

$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/oracle-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

팁

당신은 또한 수:

여러 수신자 구성: 하나의 수집기에서 여러 오라클 데이터베이스 인스턴스를 모니터할 때 사용합니다.
SQL 쿼리 수신기 구성: 오라클 데이터베이스에서 커스텀 지표를 수집합니다.
오라클 데이터베이스를 APM과 연결: 애플리케이션 성능을 데이터베이스 작업과 연관시킵니다. 이를 통해 어떤 애플리케이션이 특정 데이터베이스 워크로드를 생성하는지 정확히 확인할 수 있습니다.
시크릿 관리 설정: 데이터베이스 자격 증명과 같은 민감한 정보를 안전하게 관리할 수 있습니다. 이는 설정 파일에 민감한 데이터를 하드코딩하는 것을 방지하여 모니터링 설정의 보안을 강화하는 데 도움이 됩니다.

NRDOT Collector를 다시 시작하십시오

설정을 업데이트한 후 NRDOT Collector를 다시 시작하십시오:

bash

$sudo systemctl restart nrdot-collector.service
$sudo systemctl status nrdot-collector.service

팁

새 설정이 적용되도록 설정을 변경한 후에는 항상 NRDOT Collector를 다시 시작하십시오.

데이터 찾기 및 사용

데이터가 수집되면 뉴렐릭 UI를 통해 포괄적인 오라클 데이터베이스 모니터링에 액세스할 수 있습니다.

뉴렐릭에서 오라클 데이터베이스 엔티티를 찾으려면 다음을 수행하세요:

https://one.newrelic.com > All Capabilities > Databases 으)로 이동합니다.
검색 기준을 instrumentation.provider = opentelemetry 으로 설정합니다.
엔티티 목록에서 오라클 데이터베이스를 선택합니다.

문제점 해결

뉴렐릭에서 오라클 PDB 모니터링 설정 문제를 해결하는 방법을 알아보십시오.

지표 참조

NRDOT Collector가 수집하는 사용 가능한 메트릭에 대해 알아보십시오.

RDS 계측

뉴렐릭에서 RDS 모니터링을 위해 오라클 데이터베이스를 설정하는 방법을 알아보십시오.

도커 설치

도커에서 이미 실행 중인 오라클 데이터베이스 인스턴스의 형제 컨테이너로 NRDOT Collector를 실행하는 방법을 알아보십시오.

사용자의 편의를 위해 제공되는 기계 번역입니다.

자체 호스팅 PDB를 사용한 오라클 모니터링을 위한 NRDOT 설치 & 구성

가이드 설치

팁

전제 조건

NRDOT Collector설치하세요

AMD64 아키텍처용

ARM64 아키텍처용

데이터베이스 사용자 구성

PDB에 대한 모니터링 권한을 부여하십시오.

팁

NRDOT Collector구성

전체 설정

팁

NRDOT Collector 설정 업데이트

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

문제점 해결

지표 참조

RDS 계측

도커 설치

사용자의 편의를 위해 제공되는 기계 번역입니다.

자체 호스팅 PDB를 사용한 오라클 모니터링을 위한 NRDOT 설치 & 구성

가이드 설치

팁

전제 조건 .css-21sua1{background:none;border:none;width:0;padding:0;}

NRDOT Collector설치하세요

ARM64 아키텍처용

데이터베이스 사용자 구성

PDB에 대한 모니터링 권한을 부여하십시오.

팁

NRDOT Collector구성

전체 설정

팁

NRDOT Collector 설정 업데이트

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

관련 기사

문제점 해결

지표 참조

RDS 계측

도커 설치

전제 조건