온호스트 PDB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!

이 기능은 현재 사전 출시 정책 에 따라 미리보기의 일부로 제공됩니다.

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

가이드 설치

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

팁

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

전제 조건

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

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

미리보기에 등록하십시오

이 통합은 뉴렐릭 공개 프리뷰 프로그램의 일환으로 제공됩니다. Previews & Trials 페이지에서 옵트인하려면 조직 관리자에게 문의하십시오.

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 <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
GRANT CREATE SESSION TO <USER_NAME>;
```

멀티테넌트 데이터베이스에 대한 모니터링 권한을 부여합니다.

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

GRANT SELECT ON V_$INSTANCE   TO <USER_NAME>;
GRANT SELECT ON V_$DATABASE   TO <USER_NAME>;
GRANT SELECT ON V_$CONTAINERS TO <USER_NAME>;
GRANT SELECT ON V_$DATAFILE   TO <USER_NAME>;
GRANT SELECT ON V_$SYSSTAT                    TO <USER_NAME>;
GRANT SELECT ON V_$SYSMETRIC                  TO <USER_NAME>;
GRANT SELECT ON V_$SESSION                    TO <USER_NAME>;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO <USER_NAME>;
GRANT SELECT ON V_$OSSTAT                     TO <USER_NAME>;
GRANT SELECT ON V_$SGAINFO                    TO <USER_NAME>;
GRANT SELECT ON V_$ROWCACHE                   TO <USER_NAME>;
GRANT SELECT ON V_$PARAMETER                  TO <USER_NAME>;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS  TO <USER_NAME>;
GRANT SELECT ON DBA_TABLESPACES               TO <USER_NAME>;
GRANT SELECT ON DBA_DATA_FILES                TO <USER_NAME>;
GRANT SELECT ON DBA_FREE_SPACE                TO <USER_NAME>;
GRANT SELECT ON DBA_RECYCLEBIN                TO <USER_NAME>;
GRANT SELECT ON V_$SQL            TO <USER_NAME>;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO <USER_NAME>;
GRANT SELECT ON V_$LOCK           TO <USER_NAME>;
GRANT SELECT ON V_$SESSION_EVENT  TO <USER_NAME>;
GRANT SELECT ON DBA_PROCEDURES    TO <USER_NAME>;
GRANT SELECT ON DBA_OBJECTS       TO <USER_NAME>;
GRANT SELECT ON V_$PDBS      TO <USER_NAME>;
GRANT SELECT ON CDB_SERVICES TO <USER_NAME>;

NRDOT Collector구성

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

설정 파일을 생성합니다. 파일 이름은 oracle-config.yaml이어야 합니다.
bash
```
$sudo nano /etc/nrdot-collector/oracle-config.yaml
```

이전 단계에서 생성한 oracle-config.yaml 파일에 아래 설정 내용을 추가하십시오:

전체 설정

이 설정은 호스트 인프라 메트릭 없이 데이터베이스 모니터링에만 중점을 둡니다. 전체 기능 모니터링을 활성화하려면 설정 참조를 확인하십시오.

오라클 PDB 호스트명/IP

오라클 PDB 포트

데이터베이스 사용자 이름

데이터베이스 비밀번호

PDB 서비스 이름

뉴렐릭 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: 10s
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

16
top_query_collection:
17
   max_query_sample_count: 1000
18
   top_query_count: 200
19
   collection_interval: 60s
20
   allowed_comment_keys:
21
     - nr_service_guid
22

23
query_sample_collection:
24
   max_rows_per_query: 100
25
   allowed_comment_keys:
26
     - nr_service_guid
27

28
session_wait_event_collection:
29
   max_rows_per_query: 100
30

31
  # Metrics configuration - organized by category
32
metrics:
33
   # === CPU & Performance Metrics ===
34
   oracledb.cpu_time:
35
     enabled: true
36
     attributes:
37
       - oracle.db.pdb
38
   oracledb.database.cpu.utilization:
39
     enabled: true
40
     attributes:
41
       - oracle.db.pdb
42
   oracledb.host.cpu.utilization:
43
     enabled: true
44
     attributes:
45
       - oracle.db.pdb
46

47
   # === Execution & Parse Metrics ===
48
   oracledb.executions:
49
     enabled: true
50
     attributes:
51
       - oracle.db.pdb
52
   oracledb.execution.utilization:
53
     enabled: true
54
     attributes:
55
       - oracledb.parse.type
56
       - oracle.db.pdb
57
   oracledb.parse_calls:
58
     enabled: true
59
     attributes:
60
       - oracle.db.pdb
61
   oracledb.parse.rate:
62
     enabled: true
63
     attributes:
64
       - oracledb.parse.result
65
       - oracle.db.pdb
66
   oracledb.parse.utilization:
67
     enabled: true
68
     attributes:
69
       - oracle.db.pdb
70
   oracledb.hard_parses:
71
     enabled: true
72
     attributes:
73
       - oracle.db.pdb
74

75
   # === I/O & Physical Read/Write Metrics ===
76
   oracledb.logical_reads:
77
     enabled: true
78
     attributes:
79
       - oracle.db.pdb
80
   oracledb.physical_reads:
81
     enabled: true
82
     attributes:
83
       - oracle.db.pdb
84
   oracledb.physical_reads_direct:
85
     enabled: true
86
     attributes:
87
       - oracle.db.pdb
88
   oracledb.physical_writes:
89
     enabled: true
90
     attributes:
91
       - oracle.db.pdb
92
   oracledb.physical_writes_direct:
93
     enabled: true
94
     attributes:
95
       - oracle.db.pdb
96
   oracledb.physical_read_io_requests:
97
     enabled: true
98
     attributes:
99
       - oracle.db.pdb
100
   oracledb.physical_write_io_requests:
101
     enabled: true
102
     attributes:
103
       - oracle.db.pdb
104

105
   # === New Physical I/O Metrics (detailed) ===
106
   oracledb.physical_io.cache_writes:
107
     enabled: true
108
     attributes:
109
       - oracle.db.pdb
110
   oracledb.physical_io.requests:
111
     enabled: true
112
     attributes:
113
       - disk.io.direction
114
       - disk.io.block_size
115
       - oracle.db.pdb
116
   oracledb.physical_io.transferred:
117
     enabled: true
118
     attributes:
119
       - disk.io.direction
120
       - disk.io.type
121
       - oracle.db.pdb
122

123
   # === Network I/O Metrics ===
124
   oracledb.sqlnet.io.transferred:
125
     enabled: true
126
     attributes:
127
       - network.io.direction
128
       - destination.type
129
       - oracle.db.pdb
130

131
   # === Buffer & Cache Metrics ===
132
   oracledb.consistent_gets:
133
     enabled: true
134
     attributes:
135
       - oracle.db.pdb
136
   oracledb.db_block_gets:
137
     enabled: true
138
     attributes:
139
       - oracle.db.pdb
140
   oracledb.buffer_cache.utilization:
141
     enabled: true
142
     attributes:
143
       - oracle.db.pdb
144
   oracledb.library_cache.utilization:
145
     enabled: true
146
     attributes:
147
       - oracle.db.pdb
148
   oracledb.data_dictionary.hit_ratio:
149
     enabled: true
150
   oracledb.shared_pool.utilization:
151
     enabled: true
152
     attributes:
153
       - oracle.db.pdb
154

155
   # === Memory Metrics ===
156
   oracledb.pga_memory:
157
     enabled: true
158
     attributes:
159
       - oracle.db.pdb
160
   oracledb.sga.limit:
161
     enabled: true
162
   oracledb.sga.usage:
163
     enabled: true
164
     attributes:
165
       - oracledb.sga.component.name
166

167
   # === Wait & Database Time Metrics ===
168
   oracledb.database.wait.utilization:
169
     enabled: true
170
     attributes:
171
       - oracle.db.pdb
172

173
   # === Lock & Deadlock Metrics ===
174
   oracledb.dml_locks.limit:
175
     enabled: true
176
   oracledb.dml_locks.usage:
177
     enabled: true
178
   oracledb.enqueue_locks.limit:
179
     enabled: true
180
   oracledb.enqueue_locks.usage:
181
     enabled: true
182
   oracledb.enqueue_resources.limit:
183
     enabled: true
184
   oracledb.enqueue_resources.usage:
185
     enabled: true
186
   oracledb.enqueue_deadlocks:
187
     enabled: true
188
     attributes:
189
       - oracle.db.pdb
190
   oracledb.exchange_deadlocks:
191
     enabled: true
192
     attributes:
193
       - oracle.db.pdb
194

195
   # === Process & Session Metrics ===
196
   oracledb.processes.limit:
197
     enabled: true
198
   oracledb.processes.usage:
199
     enabled: true
200
   oracledb.sessions.limit:
201
     enabled: true
202
   oracledb.sessions.usage:
203
     enabled: true
204
     attributes:
205
       - session_type
206
       - session_status
207
       - oracle.db.pdb
208
   oracledb.logons:
209
     enabled: true
210
     attributes:
211
       - oracle.db.pdb
212

213
   # === Transaction Metrics ===
214
   oracledb.transactions.limit:
215
     enabled: true
216
   oracledb.transactions.usage:
217
     enabled: true
218
   oracledb.user_commits:
219
     enabled: true
220
     attributes:
221
       - oracle.db.pdb
222
   oracledb.user_rollbacks:
223
     enabled: true
224
     attributes:
225
       - oracle.db.pdb
226

227
   # === Tablespace Metrics ===
228
   oracledb.tablespace_size.limit:
229
     enabled: true
230
     attributes:
231
       - tablespace_name
232
       - oracle.db.pdb
233
   oracledb.tablespace_size.usage:
234
     enabled: true
235
     attributes:
236
       - tablespace_name
237
       - oracle.db.pdb
238

239
   # === Storage Metrics ===
240
   oracledb.storage.usage:
241
     enabled: true
242
   oracledb.storage.utilization:
243
     enabled: true
244
   oracledb.recycle_bin.limit:
245
     enabled: true
246

247
   # === Parallel Operations Metrics ===
248
   oracledb.queries_parallelized:
249
     enabled: true
250
     attributes:
251
       - oracle.db.pdb
252
   oracledb.ddl_statements_parallelized:
253
     enabled: true
254
     attributes:
255
       - oracle.db.pdb
256
   oracledb.dml_statements_parallelized:
257
     enabled: true
258
     attributes:
259
       - oracle.db.pdb
260
   oracledb.parallel_operations_not_downgraded:
261
     enabled: true
262
     attributes:
263
       - oracle.db.pdb
264
   oracledb.parallel_operations_downgraded_1_to_25_pct:
265
     enabled: true
266
     attributes:
267
       - oracle.db.pdb
268
   oracledb.parallel_operations_downgraded_25_to_50_pct:
269
     enabled: true
270
     attributes:
271
       - oracle.db.pdb
272
   oracledb.parallel_operations_downgraded_50_to_75_pct:
273
     enabled: true
274
     attributes:
275
       - oracle.db.pdb
276
   oracledb.parallel_operations_downgraded_75_to_99_pct:
277
     enabled: true
278
     attributes:
279
       - oracle.db.pdb
280
   oracledb.parallel_operations_downgraded_to_serial:
281
     enabled: true
282
     attributes:
283
       - oracle.db.pdb
284

285
   # === Redo & Sort Metrics ===
286
   oracledb.redo_allocation.utilization:
287
     enabled: true
288
     attributes:
289
       - oracle.db.pdb
290
   oracledb.sort.ratio:
291
     enabled: true
292
     attributes:
293
       - oracledb.sort.type
294
       - oracle.db.pdb
295

296
   # === Response Time Metrics ===
297
   oracledb.sql_service.response.duration:
298
     enabled: true
299
     attributes:
300
       - oracle.db.pdb
301

302
  # Resource attributes attached to all metrics/logs (all enabled by default)
303
resource_attributes:
304
   host.name:
305
     enabled: true
306
   oracle.db.hosting_type:
307
     enabled: true
308
   oracle.db.open_mode:
309
     enabled: true
310
   oracle.db.pdb:
311
     enabled: true
312
   oracle.db.role:
313
     enabled: true
314
   oracle.db.version:
315
     enabled: true
316
   oracledb.instance.name:
317
     enabled: true
318
   service.instance.id:
319
     enabled: true
320
processors:
321
batch:
322
  resource/add_event_name:
323
attributes:
324
   - key: host.address
325
     value: YOUR_DB_HOST
326
     action: upsert
327
exporters:
328
  otlp/newrelic:
329
  endpoint: https://otlp.nr-data.net:4318
330
headers:
331
   api-key: YOUR_LICENSE_KEY
332
  compression: gzip
333
retry_on_failure:
334
   enabled: true
335
   initial_interval: 5s
336
   max_interval: 30s
337
   max_elapsed_time: 300s
338
service:
339
pipelines:
340
  metrics/oracledb:
341
   receivers: [nroracledb]
342
   processors: [resource/add_event_name, batch]
343
   exporters: [otlp/newrelic]
344
  logs/oracledb:
345
   receivers: [nroracledb]
346
   processors: [resource/add_event_name, batch]
347
   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.query_sample

현재 SQL, 대기 상태 및 차단 세부 정보를 캡처하는 세션별 활성 쿼리 샘플.

db.server.top_query

실행 통계 및 쿼리 계획을 포함하여 CPU 또는 경과 시간 기준 상위 N개의 SQL 문.

db.server.session.wait_sample

v$session_event

의 세션별 누적 대기 횟수 및 기간.

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

설정 섹션	매개변수	값
`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

팁

뉴렐릭 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 모니터링을 위해 오라클 데이터베이스를 설정하는 방법을 알아보십시오.

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

온호스트 PDB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

가이드 설치

팁

전제 조건

미리보기에 등록하십시오

NRDOT Collector설치하세요

AMD64 아키텍처용

ARM64 아키텍처용

데이터베이스 사용자 구성

멀티테넌트 데이터베이스에 대한 모니터링 권한을 부여합니다.

NRDOT Collector구성

전체 설정

팁

NRDOT Collector 설정 업데이트

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

문제점 해결

지표 참조

RDS 계측

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

온호스트 PDB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

가이드 설치

팁

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

미리보기에 등록하십시오

NRDOT Collector설치하세요

ARM64 아키텍처용

데이터베이스 사용자 구성

멀티테넌트 데이터베이스에 대한 모니터링 권한을 부여합니다.

NRDOT Collector구성

전체 설정

팁

NRDOT Collector 설정 업데이트

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

관련 기사

문제점 해결

지표 참조

RDS 계측

전제 조건