도커를 사용한 오라클 모니터링을 위한 NRDOT 설치 및 구성

도커에서 이미 실행 중인 오라클 데이터베이스 인스턴스의 형제 컨테이너로 실행되는 뉴렐릭 OpenTelemetry 배포판(NRDOT) Collector를 사용하여 데이터베이스 모니터링, 쿼리 분석 및 시스템 상태 메트릭을 통해 오라클 데이터베이스 성능에 대한 포괄적인 인사이트를 얻으십시오.

가이드 설치

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

팁

대신 대규모로 이를 자동화하시겠습니까? Kubernetes의 경우 Ansible 설치, Chef 설치 또는 Helm 차트 설치를 참조하십시오.

전제 조건

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

호스트에 도커가 설치되어 있습니다.
이미 실행 중인 오라클 데이터베이스 컨테이너(오라클 데이터베이스 19c 이상)로, 내부에 sqlplus이(가) 사용 가능해야 합니다.
해당 컨테이너의 sys 비밀번호.
유효한 뉴렐릭 라이선스 키.
수집기 컨테이너에서 뉴렐릭 OTLP 엔드포인트로의 네트워크 연결.

데이터베이스 사용자를 구성하고 권한을 부여하십시오.

docker exec을(를) 사용하여 오라클 컨테이너에 대해 SQL을 실행하여 모니터링 사용자를 생성하고 메트릭, 쿼리 및 이벤트 수집에 필요한 뷰를 부여하십시오. 멀티테넌트 컨테이너 데이터베이스(CDB) 또는 단일 플러거블 데이터베이스(PDB) 중 배포에 맞는 탭을 선택하십시오:

이렇게 하면 공통 사용자(C## 접두사를 사용해야 함)가 생성되고 CDB 아래의 모든 PDB에 대한 가시성이 부여됩니다. <YOUR_ORACLE_CONTAINER_NAME>, <YOUR_SYS_PASSWORD>, <YOUR_DB_USERNAME>, <YOUR_DB_PASSWORD>을(를) 사용자 고유의 값으로 바꾸십시오:

bash

$docker exec -i <YOUR_ORACLE_CONTAINER_NAME> sqlplus sys/'<YOUR_SYS_PASSWORD>' as sysdba << 'EOF'
$ALTER SESSION SET CONTAINER = CDB$ROOT;
$
$-- Create the common user and set container-data visibility
$CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>" CONTAINER=ALL;
$GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;
$
$-- Grant system and dynamic performance views
$GRANT SELECT ON V_$INSTANCE                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$DATABASE                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$CONTAINERS                 TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$DATAFILE                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SYSSTAT                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$CON_SYSSTAT                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SYSMETRIC                  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$CON_SYSMETRIC              TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SESSION                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$RESOURCE_LIMIT             TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$OSSTAT                     TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SGAINFO                    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$ROWCACHE                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$PARAMETER                  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_TABLESPACE_USAGE_METRICS  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_TABLESPACES               TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON DBA_DATA_FILES                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON DBA_FREE_SPACE                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON DBA_RECYCLEBIN                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SQL                        TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL    TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$LOCK                       TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$SESSION_EVENT              TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON DBA_PROCEDURES                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON DBA_OBJECTS                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$PDBS                       TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_SERVICES                  TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_DATA_FILES                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_PROCEDURES                TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON CDB_OBJECTS                   TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$ASM_DISKGROUP_STAT          TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$GRANT SELECT ON V_$ASM_DISK_STAT               TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
$
$EXIT;
$EOF

팁

오라클은 공통 사용자에게 C## 접두사를 요구합니다. 마지막 두 권한(V_$ASM_DISKGROUP_STAT 및 V_$ASM_DISK_STAT)은 ASM 디스크 그룹 및 디스크 메트릭을 수집하려는 경우에만 필요합니다. ASM을 사용하지 않는 경우 건너뛰십시오.

이는 단일 타겟 PDB 내에 로컬 사용자를 생성합니다. <YOUR_ORACLE_CONTAINER_NAME>, <YOUR_SYS_PASSWORD>, <YOUR_PDB_SERVICE_NAME>, <YOUR_DB_USERNAME>, <YOUR_DB_PASSWORD>를 여러분의 값으로 바꾸십시오:

bash

$docker exec -i <YOUR_ORACLE_CONTAINER_NAME> sqlplus sys/'<YOUR_SYS_PASSWORD>'@//localhost:1521/<YOUR_PDB_SERVICE_NAME> as sysdba << 'EOF'
$ALTER SESSION SET CONTAINER = <YOUR_PDB_SERVICE_NAME>;
$
$-- Create the local user in the PDB
$CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
$GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;
$
$-- Grant system and dynamic performance views
$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>;
$
$EXIT;
$EOF

팁

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

팁

개별 플러거블 데이터베이스가 아닌 전체 컨테이너 데이터베이스를 모니터해야 하는 경우, 대신 CDB 탭을 사용하십시오.

도커 네트워크 연결을 확인하십시오.

공유 사용자 정의 네트워크를 생성하고(아직 없는 경우) 오라클 컨테이너를 해당 네트워크에 연결하여 수집기 컨테이너가 이름으로 확인할 수 있도록 하십시오:

bash

$docker network create <YOUR_DOCKER_NETWORK> 2>/dev/null || true
$docker network connect <YOUR_DOCKER_NETWORK> <YOUR_ORACLE_CONTAINER_NAME> 2>/dev/null || true

팁

두 명령 모두 다시 실행해도 안전합니다: || true은(는) 이전 실행의 "already exists" 또는 "already connected" 오류를 무시합니다.

NRDOT Collector 설정을 생성하십시오.

데이터베이스 사용자 구성 및 권한 부여에서 생성한 사용자와 일치하는 탭을 선택하십시오:

전체 설정

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

oracle-config.yaml을(를) 생성하려면 도커 호스트에서 다음을 실행하십시오:

bash

$cat << 'EOF' > oracle-config.yaml
$receivers:
$  nroracledb:
$    endpoint: "<YOUR_ORACLE_CONTAINER_NAME>:1521"
$    username: "c##<YOUR_DB_USERNAME>"
$    password: "<YOUR_DB_PASSWORD>"
$    service: "<YOUR_CDB_SERVICE_NAME>"
$    collection_interval: 15s
$    events:
$      db.server.query_sample:
$        enabled: true
$      db.server.top_query:
$        enabled: true
$      db.server.session.wait_sample:
$        enabled: true
$      db.server.top_procedure:
$        enabled: true
$      db.server.query_plan:
$        enabled: true
$
$    top_query_collection:
$      max_query_sample_count: 1000
$      top_query_count: 200
$      collection_interval: 60s
$      allowed_comment_keys:
$        - nr_service_guid
$
$    query_sample_collection:
$      max_rows_per_query: 100
$      allowed_comment_keys:
$        - nr_service_guid
$
$    session_wait_event_collection:
$      max_rows_per_query: 100
$
$    top_procedure_collection:
$      max_procedure_sample_count: 1000
$      top_procedure_count: 250
$      collection_interval: 60s
$
$    # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
$    metrics:
$      oracledb.buffer_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.consistent_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.cpu_time:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.wait.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.db_block_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.enqueue_deadlocks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.execution.utilization:
$        enabled: true
$        attributes:
$          - oracledb.parse.type
$          - oracle.db.pdb
$      oracledb.executions:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.hard_parses:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.host.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.library_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logons:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.parse.rate:
$        enabled: true
$        attributes:
$          - oracledb.parse.result
$          - oracle.db.pdb
$      oracledb.parse_calls:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.pga_memory:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_io.requests:
$        enabled: true
$        attributes:
$          - disk.io.direction
$          - disk.io.block_size
$          - oracle.db.pdb
$      oracledb.physical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_writes:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.processes.usage:
$        enabled: true
$      oracledb.sessions.usage:
$        enabled: true
$        attributes:
$          - session_type
$          - session_status
$          - oracle.db.pdb
$      oracledb.sga.usage:
$        enabled: true
$        attributes:
$          - oracledb.sga.component.name
$      oracledb.shared_pool.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sql_service.response.duration:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sqlnet.io.transferred:
$        enabled: true
$        attributes:
$          - network.io.direction
$          - destination.type
$          - oracle.db.pdb
$      oracledb.tablespace_size.usage:
$        enabled: true
$        attributes:
$          - tablespace_name
$          - oracle.db.pdb
$      oracledb.transactions.usage:
$        enabled: true
$      oracledb.user_commits:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.user_rollbacks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$
$    # Resource attributes attached to all metrics/logs (all enabled by default)
$    resource_attributes:
$      oracle.db.edition:
$        enabled: true
$
$exporters:
$  otlp/newrelic:
$    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$    headers:
$      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
$    compression: gzip
$    retry_on_failure:
$      enabled: true
$      initial_interval: 5s
$      max_interval: 30s
$      max_elapsed_time: 300s
$    sending_queue:
$      enabled: true
$      sizer: bytes
$      queue_size: 100_000_000
$      num_consumers: 10
$      batch:
$        sizer: bytes
$        max_size: 1_000_000
$        min_size: 0
$        flush_timeout: 5s
$
$service:
$  pipelines:
$    metrics/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$    logs/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$EOF

전체 설정

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

oracle-config.yaml을(를) 생성하려면 도커 호스트에서 다음을 실행하십시오:

bash

$cat << 'EOF' > oracle-config.yaml
$receivers:
$  nroracledb:
$    endpoint: "<YOUR_ORACLE_CONTAINER_NAME>:1521"
$    username: "<YOUR_DB_USERNAME>"
$    password: "<YOUR_DB_PASSWORD>"
$    service: "<YOUR_PDB_SERVICE_NAME>"
$    collection_interval: 15s
$    events:
$      db.server.query_sample:
$        enabled: true
$      db.server.top_query:
$        enabled: true
$      db.server.session.wait_sample:
$        enabled: true
$      db.server.top_procedure:
$        enabled: true
$      db.server.query_plan:
$        enabled: true
$
$    top_query_collection:
$      max_query_sample_count: 1000
$      top_query_count: 200
$      collection_interval: 60s
$      allowed_comment_keys:
$        - nr_service_guid
$
$    query_sample_collection:
$      max_rows_per_query: 100
$      allowed_comment_keys:
$        - nr_service_guid
$
$    session_wait_event_collection:
$      max_rows_per_query: 100
$
$    top_procedure_collection:
$      max_procedure_sample_count: 1000
$      top_procedure_count: 250
$      collection_interval: 60s
$
$    # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
$    metrics:
$      oracledb.buffer_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.consistent_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.cpu_time:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.database.wait.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.db_block_gets:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.enqueue_deadlocks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.execution.utilization:
$        enabled: true
$        attributes:
$          - oracledb.parse.type
$          - oracle.db.pdb
$      oracledb.executions:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.hard_parses:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.host.cpu.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.library_cache.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.logons:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.parse.rate:
$        enabled: true
$        attributes:
$          - oracledb.parse.result
$          - oracle.db.pdb
$      oracledb.parse_calls:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.pga_memory:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_io.requests:
$        enabled: true
$        attributes:
$          - disk.io.direction
$          - disk.io.block_size
$          - oracle.db.pdb
$      oracledb.physical_reads:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.physical_writes:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.processes.usage:
$        enabled: true
$      oracledb.sessions.usage:
$        enabled: true
$        attributes:
$          - session_type
$          - session_status
$          - oracle.db.pdb
$      oracledb.sga.usage:
$        enabled: true
$        attributes:
$          - oracledb.sga.component.name
$      oracledb.shared_pool.utilization:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sql_service.response.duration:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.sqlnet.io.transferred:
$        enabled: true
$        attributes:
$          - network.io.direction
$          - destination.type
$          - oracle.db.pdb
$      oracledb.tablespace_size.usage:
$        enabled: true
$        attributes:
$          - tablespace_name
$          - oracle.db.pdb
$      oracledb.transactions.usage:
$        enabled: true
$      oracledb.user_commits:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$      oracledb.user_rollbacks:
$        enabled: true
$        attributes:
$          - oracle.db.pdb
$
$    # Resource attributes attached to all metrics/logs (all enabled by default)
$    resource_attributes:
$      oracle.db.edition:
$        enabled: true
$
$exporters:
$  otlp/newrelic:
$    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
$    headers:
$      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
$    compression: gzip
$    retry_on_failure:
$      enabled: true
$      initial_interval: 5s
$      max_interval: 30s
$      max_elapsed_time: 300s
$    sending_queue:
$      enabled: true
$      sizer: bytes
$      queue_size: 100_000_000
$      num_consumers: 10
$      batch:
$        sizer: bytes
$        max_size: 1_000_000
$        min_size: 0
$        flush_timeout: 5s
$
$service:
$  pipelines:
$    metrics/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$    logs/oracledb:
$      receivers: [nroracledb]
$      exporters: [otlp/newrelic]
$EOF

구성 매개변수

매개변수	설명
`<YOUR_ORACLE_CONTAINER_NAME>`	실행 중인 오라클 데이터베이스 컨테이너의 이름(또는 도커 DNS 해석 가능한 호스트명)
`<YOUR_DB_USERNAME>`	데이터베이스 사용자 구성 및 권한 부여에서 생성한 모니터링 사용자입니다(CDB의 경우 `C##` 접두사가 자동으로 추가됩니다).
`<YOUR_DB_PASSWORD>`	데이터베이스 사용자 설정 및 권한 부여에서 생성한 모니터링 사용자의 비밀번호입니다.
`<YOUR_CDB_SERVICE_NAME>` / `<YOUR_PDB_SERVICE_NAME>`	CDB 또는 PDB의 오라클 서비스 이름입니다.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	사용자의 뉴렐릭 OTLP 엔드포인트. 자세한 내용은 뉴렐릭 OTLP 엔드포인트를 참조하십시오.
`<YOUR_NEWRELIC_LICENSE_KEY>`	귀하의 New Relic 라이센스 키 .

NRDOT Collector 컨테이너를 시작하십시오.

오라클 컨테이너와 동일한 도커 네트워크에서 수집기를 실행하십시오:

bash

$docker run -d \
>  --name nrdot-collector \
>  --network <YOUR_DOCKER_NETWORK> \
>  --platform linux/amd64 \
>  -v "$PWD/oracle-config.yaml:/etc/nrdot-collector/oracle-config.yaml" \
>  newrelic/nrdot-collector:latest \
>  --config /etc/nrdot-collector/oracle-config.yaml

팁

--platform linux/amd64 오라클 이미지 자체가 일반적으로 AMD64용으로만 제공되는 Apple Silicon 및 기타 ARM64 호스트에서 아키텍처 불일치를 방지합니다. 호스트와 이미지가 이미 AMD64 네이티브인 경우 이를 제외하십시오.

수집기 컨테이너가 실행 중인지 확인하십시오:

bash

$docker ps --filter name=nrdot-collector

실행 중이 아니면 로그에서 오류를 확인하십시오. 가장 일반적인 원인은 oracle-config.yaml의 YAML 들여쓰기 문제 또는 연결할 수 없는 오라클 컨테이너입니다:

bash

$docker logs nrdot-collector

팁

oracle-config.yaml을(를) 변경한 후 변경 사항을 적용하려면 컨테이너를 다시 시작하십시오:

bash

$docker restart nrdot-collector

데이터 찾기 및 사용

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

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

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

온호스트 CDB 모니터링

온호스트 오라클 컨테이너 데이터베이스 모니터링을 위해 NRDOT Collector를 설치하고 구성하는 방법을 알아보십시오.

온호스트 PDB 모니터링

온호스트 오라클 플러그형 데이터베이스 모니터링을 위해 NRDOT Collector를 설치하고 설정하는 방법을 알아보십시오.

Ansible 설치

newrelic.newrelic_install을 사용하여 대규모로 오라클 데이터베이스 모니터링을 설치하고 구성하는 방법을 알아보십시오. Ansible 역할.

Chef 설치

newrelic-install Chef 쿡북을 사용하여 대규모로 오라클 데이터베이스 모니터링을 설치하고 구성하는 방법을 알아보십시오.

Helm 차트 설치

Helm 차트를 사용하여 Kubernetes에서 오라클 데이터베이스 모니터링을 설치하고 설정하는 방법을 알아보십시오.

문제점 해결

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

지표 참조

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

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

도커를 사용한 오라클 모니터링을 위한 NRDOT 설치 및 구성

가이드 설치

팁

전제 조건

데이터베이스 사용자를 구성하고 권한을 부여하십시오.

컨테이너 데이터베이스(CDB)

팁

플러그형 데이터베이스(PDB)

팁

팁

도커 네트워크 연결을 확인하십시오.

팁

NRDOT Collector 설정을 생성하십시오.

컨테이너 데이터베이스(CDB) 설정

전체 설정

플러거블 데이터베이스(PDB) 설정

전체 설정

구성 매개변수

NRDOT Collector 컨테이너를 시작하십시오.

팁

팁

데이터 찾기 및 사용

온호스트 CDB 모니터링

온호스트 PDB 모니터링

Ansible 설치

Chef 설치

Helm 차트 설치

문제점 해결

지표 참조

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

도커를 사용한 오라클 모니터링을 위한 NRDOT 설치 및 구성

가이드 설치

팁

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

데이터베이스 사용자를 구성하고 권한을 부여하십시오.

플러그형 데이터베이스(PDB)

도커 네트워크 연결을 확인하십시오.

팁

NRDOT Collector 설정을 생성하십시오.

컨테이너 데이터베이스(CDB) 설정

플러거블 데이터베이스(PDB) 설정

구성 매개변수

NRDOT Collector 컨테이너를 시작하십시오.

팁

팁

데이터 찾기 및 사용

관련 기사

온호스트 CDB 모니터링

온호스트 PDB 모니터링

Ansible 설치

Chef 설치

Helm 차트 설치

문제점 해결

지표 참조

전제 조건