Oracle 데이터베이스

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Oracle DB 통합에서는 Oracle DB 측정항목과 로그를 수집합니다. 측정항목은 관련 모니터링 뷰 쿼리를 통해 수집됩니다. 이 통합은 구조화된 trace 로그를 작성합니다.

Oracle DB에 대한 자세한 내용은 Oracle 데이터베이스 문서를 참조하세요.

기본 요건

Oracle DB 원격 분석을 수집하려면 버전 2.22.0 이상의 운영 에이전트를 설치해야 합니다.

이 통합에서는 Oracle DB 버전 12.2, 18c, 19c, 21c를 지원합니다.

Oracle DB 인스턴스 구성

측정항목을 수집하려면 모니터링 사용자에게 관련 모니터링 뷰에 대한 SELECT 액세스 권한이 필요합니다. 다음 sql 스크립트는 모니터링 사용자를 만들고 Oracle DB 인스턴스에 SYSDBA 또는 SYSOPER로 연결된 충분한 권한이 있는 사용자가 실행하는 경우 적절한 권한을 부여해야 합니다.

-- Create the monitoring user "otel"
CREATE USER otel IDENTIFIED BY ;

-- Grant the "otel" user the required permissions
GRANT CONNECT TO otel;
GRANT SELECT ON SYS.GV_$DATABASE to otel;
GRANT SELECT ON SYS.GV_$INSTANCE to otel;
GRANT SELECT ON SYS.GV_$PROCESS to otel;
GRANT SELECT ON SYS.GV_$RESOURCE_LIMIT to otel;
GRANT SELECT ON SYS.GV_$SYSMETRIC to otel;
GRANT SELECT ON SYS.GV_$SYSSTAT to otel;
GRANT SELECT ON SYS.GV_$SYSTEM_EVENT to otel;
GRANT SELECT ON SYS.V_$RMAN_BACKUP_JOB_DETAILS to otel;
GRANT SELECT ON SYS.V_$SORT_SEGMENT to otel;
GRANT SELECT ON SYS.V_$TABLESPACE to otel;
GRANT SELECT ON SYS.V_$TEMPFILE to otel;
GRANT SELECT ON SYS.DBA_DATA_FILES to otel;
GRANT SELECT ON SYS.DBA_FREE_SPACE to otel;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS to otel;
GRANT SELECT ON SYS.DBA_TABLESPACES to otel;
GRANT SELECT ON SYS.GLOBAL_NAME to otel;

Oracle DB용 운영 에이전트 구성

운영 에이전트 구성 가이드를 수행하여 Oracle DB 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

구성 예시

다음 명령어는 Oracle DB용 원격 분석을 수집하고 운영 에이전트를 다시 시작하는 구성을 만듭니다.

# Configures Ops Agent to collect telemetry from the app and restart Ops Agent.

set -e

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
  receivers:
    oracledb_audit:
      type: oracledb_audit
      oracle_home: /opt/oracle
    oracledb_alert:
      type: oracledb_alert
      oracle_home: /opt/oracle
  service:
    pipelines:
      oracledb:
        receivers:
          - oracledb_audit
          - oracledb_alert
metrics:
  receivers:
    oracledb:
      type: oracledb
      username: otel
      password: ora19c
      sid: ORCLCDB
      service_name: ORCLCDB
  service:
    log_level: debug
    pipelines:
      oracledb:
        receivers:
          - oracledb
EOF

sudo service google-cloud-ops-agent restart

로그 수집 구성

Oracle DB에서 로그를 수집하려면 Oracle DB에서 생성하는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

oracledb_audit 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
include_paths 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다. oracle_home 필드를 제공할 수 없습니다.
oracle_home include_paths$ORACLE_HOME/admin/*/adump/*.aud로 설정될 경우 환경에 대한 ORACLE_HOME의 위치입니다. include_paths 필드를 제공할 수 없습니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
type 값은 oracledb_audit여야 합니다.
wildcard_refresh_interval 60s include_path의 와일드 카드 파일 경로가 새로고침되는 간격입니다. time.ParseDuration으로 구문 분석할 수 있는 기간으로 제공됩니다(예: 30s 또는 2m). 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

oracledb_alert 로그의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
exclude_paths [] include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다.
include_paths 각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(*)를 경로에 사용할 수 있습니다. oracle_home 필드를 제공할 수 없습니다.
oracle_home include_paths$ORACLE_HOME/diag/rdbms/*/*/trace/alert_*.log로 설정될 경우 환경의 ORACLE_HOME 위치입니다. include_paths 필드를 제공할 수 없습니다.
record_log_file_path false true로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다.
type 값은 oracledb_alert여야 합니다.
wildcard_refresh_interval 60s include_path의 와일드 카드 파일 경로가 새로고침되는 간격입니다. time.ParseDuration으로 구문 분석할 수 있는 기간으로 제공됩니다(예: 30s 또는 2m). 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다.

로깅되는 내용

logName은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry 내의 자세한 필드는 다음과 같습니다.

oracledb_alert 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.message 문자열 로그 메시지
severity 문자열(LogSeverity) 로그 항목 수준(번역됨)

oracledb_audit 로그에는 LogEntry의 다음 필드가 포함됩니다.

필드 유형 설명
jsonPayload.action 문자열 감사 로그에 로깅되는 작업
jsonPayload.action_number 숫자 로깅되는 작업 유형을 식별하는 숫자
jsonPayload.client_terminal 문자열 작업이 시작된 클라이언트 터미널의 식별자
jsonPayload.client_user 문자열 감사 대상의 클라이언트 사용자
jsonPayload.database_user 문자열 감사 대상의 데이터베이스 사용자
jsonPayload.dbid 숫자 데이터베이스 식별자
jsonPayload.length 숫자 로깅되는 작업을 나타내는 문자열의 길이
jsonPayload.privilege 문자열 작업이 실행된 데이터베이스 권한
jsonPayload.sessionid 숫자 세션 식별자
jsonPayload.status 문자열 작업 상태
jsonPayload.user_host 문자열 감사된 작업이 시작된 호스트
severity 문자열(LogSeverity) 로그 항목 수준(번역됨)

측정항목 수집 구성

Oracle DB에서 측정항목을 수집하려면 Oracle DB에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

oracledb 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드 기본값 설명
collection_interval 60s 기간 값(예: 30s 또는 5m)입니다.
endpoint localhost:1521 Oracle DB 인스턴스에 연결하는 데 사용되는 엔드포인트입니다. 이 필드에서는 host:port 또는 Unix 소켓 경로를 지원합니다.
insecure true 보안 TLS 연결을 사용할지 여부를 설정합니다. false로 설정하면 TLS가 사용 설정됩니다.
insecure_skip_verify false 인증서 확인을 건너뛸지 여부를 설정합니다. insecuretrue로 설정된 경우 insecure_skip_verify 값이 사용되지 않습니다.
password 인스턴스 연결에 사용되는 비밀번호입니다.
service_name 모니터링 중인 Oracle 데이터베이스의 서비스 이름입니다. 이 필드 또는 sid 필드를 적절히 사용합니다.
sid 모니터링 중인 Oracle 데이터베이스의 SID입니다. 이 필드 또는 service_name 필드를 적절히 사용합니다.
type 값은 oracledb여야 합니다.
username 인스턴스 연결에 사용되는 시용자 이름입니다.
wallet 인증 및 연결 보호에 선택적으로 사용되는 Oracle 월렛이 포함된 디렉터리의 경로입니다.

모니터링 대상

다음 표에서는 운영 에이전트가 Oracle DB 인스턴스에서 수집하는 측정항목 목록을 제공합니다.

측정항목 유형
종류, 유형
모니터링 리소스
라벨
workload.googleapis.com/oracle.backup.latest
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
workload.googleapis.com/oracle.buffer.cache.ratio
GAUGEDOUBLE
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.cursor.count
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.cursor.current
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.disk.operation.count
CUMULATIVEINT64
gce_instance
database_id
db_system
direction
global_name
instance_id
workload.googleapis.com/oracle.disk.operation.size
CUMULATIVEINT64
gce_instance
database_id
db_system
direction
global_name
instance_id
workload.googleapis.com/oracle.logon.count
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.logon.current
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.network.data
CUMULATIVEINT64
gce_instance
database_id
db_system
direction
global_name
instance_id
target
workload.googleapis.com/oracle.process.count
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.process.limit
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.process.pga_memory.size
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
program
state
workload.googleapis.com/oracle.row.cache.ratio
GAUGEDOUBLE
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.service.response_time
GAUGEDOUBLE
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.session.count
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.session.limit
GAUGEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.sort.count
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
type
workload.googleapis.com/oracle.sort.row.count
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.tablespace.count
GAUGEINT64
gce_instance
contents
database_id
db_system
global_name
status
workload.googleapis.com/oracle.tablespace.size
GAUGEINT64
gce_instance
contents
database_id
db_system
global_name
state
tablespace_name
workload.googleapis.com/oracle.user.calls
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.user.commits
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.user.rollbacks
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
workload.googleapis.com/oracle.wait.count
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
type
wait_class
workload.googleapis.com/oracle.wait.time
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
type
wait_class
workload.googleapis.com/oracle.wait.timeouts
CUMULATIVEINT64
gce_instance
database_id
db_system
global_name
instance_id
type
wait_class

샘플 대시보드

Oracle DB 측정항목을 보려면 차트나 대시보드가 구성되어 있어야 합니다. Cloud Monitoring은 사전 구성된 차트가 포함된 통합용 샘플 대시보드 라이브러리를 제공합니다. 이러한 대시보드 설치에 대한 자세한 내용은 샘플 대시보드 설치를 참조하세요.

구성 확인

이 섹션에서는 Oracle DB 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 작업 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 Oracle DB 로그를 봅니다.

resource.type="gce_instance"
(log_id("oracledb_alert") OR log_id("oracledb_audit"))

측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.

fetch gce_instance
| metric 'workload.googleapis.com/oracle.logon.count'
| every 1m

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.