ADB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

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

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

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

가이드 설치

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

전제 조건

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

유효한 뉴렐릭 클러스터
지원 아키텍처: 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_aarch64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

데이터베이스 사용자 구성

ADB 오라클 데이터베이스 인스턴스에 필요한 권한을 가진 모니터링 사용자를 생성합니다. 타겟 ADB 내에서 SYS로 다음 문을 실행하여 로컬 모니터링 사용자를 생성합니다:

CREATE USER <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
GRANT CREATE SESSION TO <USER_NAME>;

Autonomous Database에 대한 모니터링 권한 부여

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

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

NRDOT Collector구성

ADB 관련 설정으로 NRDOT Collector를 설정하십시오. 다음 내용으로 설정 파일(예: adb-config.yaml)을 생성하십시오:

데이터베이스 사용자 이름

데이터베이스 비밀번호

오라클 ADB 호스트명

오라클 ADB 포트

서비스 이름

뉴렐릭 OTLP 엔드포인트

뉴렐릭 라이선스 키

adb-config.yaml

1
receivers:
2
  nroracledb/adb:
3
  datasource: "oracle://newrelic:YOUR_PASSWORD@adb.example.oraclecloud.com:1522/YOUR_SERVICE_NAME?ssl=true&ssl%20verify=true"
4
  collection_interval: 10s
5
events:
6
   db.server.query_sample:
7
     enabled: true
8
   db.server.top_query:
9
     enabled: true
10
   db.server.session.wait_sample:
11
     enabled: true
12

13
top_query_collection:
14
   max_query_sample_count: 1000
15
   top_query_count: 200
16
   collection_interval: 60s
17
   allowed_comment_keys:
18
     - nr_service_guid
19

20
query_sample_collection:
21
   max_rows_per_query: 100
22
   allowed_comment_keys:
23
     - nr_service_guid
24

25
session_wait_event_collection:
26
   max_rows_per_query: 100
27

28
metrics:
29
   oracledb.cpu_time:
30
     enabled: true
31
   oracledb.executions:
32
     enabled: true
33
   oracledb.parse_calls:
34
     enabled: true
35
   oracledb.hard_parses:
36
     enabled: true
37
   oracledb.logical_reads:
38
     enabled: true
39
   oracledb.physical_reads:
40
     enabled: true
41
   oracledb.physical_reads_direct:
42
     enabled: true
43
   oracledb.physical_writes:
44
     enabled: true
45
   oracledb.physical_writes_direct:
46
     enabled: true
47
   oracledb.physical_read_io_requests:
48
     enabled: true
49
   oracledb.physical_write_io_requests:
50
     enabled: true
51
   oracledb.physical_io.cache_writes:
52
     enabled: true
53
   oracledb.physical_io.requests:
54
     enabled: true
55
     attributes:
56
       - disk.io.direction
57
       - disk.io.block_size
58
   oracledb.physical_io.transferred:
59
     enabled: true
60
     attributes:
61
       - disk.io.direction
62
       - disk.io.type
63
   oracledb.sqlnet.io.transferred:
64
     enabled: true
65
     attributes:
66
       - network.io.direction
67
       - destination.type
68
   oracledb.consistent_gets:
69
     enabled: true
70
   oracledb.db_block_gets:
71
     enabled: true
72
   oracledb.data_dictionary.hit_ratio:
73
     enabled: true
74
   oracledb.pga_memory:
75
     enabled: true
76
   oracledb.enqueue_deadlocks:
77
     enabled: true
78
   oracledb.exchange_deadlocks:
79
     enabled: true
80
   oracledb.sessions.usage:
81
     enabled: true
82
     attributes:
83
       - session_type
84
       - session_status
85
   oracledb.logons:
86
     enabled: true
87
   oracledb.user_commits:
88
     enabled: true
89
   oracledb.user_rollbacks:
90
     enabled: true
91
   oracledb.tablespace_size.limit:
92
     enabled: true
93
     attributes:
94
       - tablespace_name
95
   oracledb.tablespace_size.usage:
96
     enabled: true
97
     attributes:
98
       - tablespace_name
99
   oracledb.storage.usage:
100
     enabled: true
101
   oracledb.storage.utilization:
102
     enabled: true
103
   oracledb.recycle_bin.limit:
104
     enabled: true
105
   oracledb.queries_parallelized:
106
     enabled: true
107
   oracledb.ddl_statements_parallelized:
108
     enabled: true
109
   oracledb.dml_statements_parallelized:
110
     enabled: true
111
   oracledb.parallel_operations_not_downgraded:
112
     enabled: true
113
   oracledb.parallel_operations_downgraded_1_to_25_pct:
114
     enabled: true
115
   oracledb.parallel_operations_downgraded_25_to_50_pct:
116
     enabled: true
117
   oracledb.parallel_operations_downgraded_50_to_75_pct:
118
     enabled: true
119
   oracledb.parallel_operations_downgraded_75_to_99_pct:
120
     enabled: true
121
   oracledb.parallel_operations_downgraded_to_serial:
122
     enabled: true
123

124
processors:
125
batch:
126
  resource/add_event_name:
127
attributes:
128
   - key: host.address
129
     value: YOUR_DB_HOST
130
     action: upsert
131

132
exporters:
133
  otlphttp/newrelic:
134
  endpoint: https://otlp.nr-data.net:4318
135
headers:
136
   api-key: YOUR_LICENSE_KEY
137
  compression: gzip
138
retry_on_failure:
139
   enabled: true
140
   initial_interval: 5s
141
   max_interval: 30s
142
   max_elapsed_time: 300s
143

144
service:
145
telemetry:
146
metrics:
147
   level: none
148
pipelines:
149
  metrics/oracledb:
150
   receivers: [nroracledb/adb]
151
   processors: [resource/add_event_name, batch]
152
   exporters: [otlphttp/newrelic]
153
  logs/oracledb:
154
   receivers: [nroracledb/adb]
155
   processors: [resource/add_event_name, batch]
156
   exporters: [otlphttp/newrelic]

다음 메트릭은 ADB에서 지원되지 않습니다:

oracledb.database.cpu.utilization
oracledb.database.wait.utilization
oracledb.host.cpu.utilization
oracledb.execution.utilization
oracledb.parse.rate
oracledb.parse.utilization
oracledb.sort.ratio
oracledb.sql_service.response.duration
oracledb.buffer_cache.utilization
oracledb.library_cache.utilization
oracledb.shared_pool.utilization
oracledb.redo_allocation.utilization
oracledb.processes.limit
oracledb.processes.usage
oracledb.sessions.limit
oracledb.transactions.limit
oracledb.transactions.usage
oracledb.dml_locks.limit
oracledb.dml_locks.usage
oracledb.enqueue_locks.limit
oracledb.enqueue_locks.usage
oracledb.enqueue_resources.limit
oracledb.enqueue_resources.usage

팁

당신은 또한 수:

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

NRDOT Collector를 다시 시작하십시오

수집기를 구성한 후 NRDOT Collector 서비스를 다시 시작하여 변경 사항을 적용합니다:

bash

$sudo systemctl restart nrdot-collector

수집기가 제대로 실행되고 있는지 확인하려면 서비스 상태를 확인하십시오:

bash

$sudo systemctl status nrdot-collector

팁

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

데이터 찾기 및 사용

오라클 ADB 통합을 설정한 후, 뉴렐릭에서 데이터베이스 성능 모니터링 및 분석을 시작할 수 있습니다:

one.newrelic.com > All Entities로 이동합니다.
Oracle [오라클]로 필터링하여 데이터베이스 엔티티를 찾으십시오.
대시보드, 메트릭 및 로그를 보려면 오라클 ADB 엔티티를 선택하십시오.
오라클 데이터베이스 모니터링에 대한 자세한 내용은 데이터베이스 모니터링 문서를 참조하십시오.

문제점 해결

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

지표 참조

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

RDS 계측

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

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

ADB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

가이드 설치

전제 조건

미리보기에 등록하십시오

NRDOT Collector설치하세요

AMD64 아키텍처용

ARM64 아키텍처용

데이터베이스 사용자 구성

Autonomous Database에 대한 모니터링 권한 부여

NRDOT Collector구성

지원되지 않는 ADB 메트릭

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

문제점 해결

지표 참조

RDS 계측

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

ADB 모니터링을 위한 NRDOT Collector 설치 및 구성

시사

가이드 설치

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

미리보기에 등록하십시오

NRDOT Collector설치하세요

ARM64 아키텍처용

데이터베이스 사용자 구성

Autonomous Database에 대한 모니터링 권한 부여

NRDOT Collector구성

지원되지 않는 ADB 메트릭

팁

NRDOT Collector를 다시 시작하십시오

팁

데이터 찾기 및 사용

관련 기사

문제점 해결

지표 참조

RDS 계측

전제 조건