Oracle DB 통합에서는 Oracle DB 측정항목과 로그를 수집합니다. 측정항목은 관련 모니터링 뷰를 쿼리하여 수집됩니다. 이 통합은 구조화된 trace 로그를 작성합니다.
Oracle DB에 대한 자세한 내용은 Oracle 데이터베이스 문서를 참조하세요.
기본 요건
Oracle DB 원격 분석을 수집하려면 운영 에이전트를 설치해야 합니다.
- 측정항목의 경우 버전 2.22.0 이상을 설치합니다.
- 로그에는 버전 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용 원격 분석을 수집 및 처리하고 운영 에이전트를 다시 시작하는 구성을 만듭니다.
로그 수집 구성
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_paths 의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: 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_paths 의 와일드 카드 파일 경로가 새로 고쳐지는 간격입니다. 기간(예: 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에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.
이 수신자는 구성에서 여러 인스턴스 모니터링과 같은 여러 인스턴스의 사용을 지원하지 않습니다. 이러한 모든 인스턴스는 동일한 시계열에 기록되며, Cloud Monitoring은 이를 구분할 수 있는 방법이 없습니다.
oracledb
측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.
필드 | 기본값 | 설명 |
---|---|---|
collection_interval |
60s |
기간 값(예: 30s 또는 5m )입니다. |
endpoint |
localhost:1521 |
Oracle DB 인스턴스에 연결하는 데 사용되는 엔드포인트입니다. 이 필드는 host:port 또는 Unix 소켓 경로를 지원합니다. |
insecure |
true |
보안 TLS 연결을 사용할지 여부를 설정합니다. false 로 설정하면 TLS가 사용 설정됩니다. |
insecure_skip_verify |
false |
인증서 확인을 건너뛸지 여부를 설정합니다. insecure 이 true 로 설정된 경우 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
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name
|
workload.googleapis.com/oracle.buffer.cache.ratio
|
|
GAUGE , DOUBLE gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.cursor.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.cursor.current
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.disk.operation.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system direction global_name instance_id
|
workload.googleapis.com/oracle.disk.operation.size
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system direction global_name instance_id
|
workload.googleapis.com/oracle.logon.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.logon.current
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.network.data
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system direction global_name instance_id target
|
workload.googleapis.com/oracle.process.count
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.process.limit
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.process.pga_memory.size
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id program state
|
workload.googleapis.com/oracle.row.cache.ratio
|
|
GAUGE , DOUBLE gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.service.response_time
|
|
GAUGE , DOUBLE gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.session.count
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.session.limit
|
|
GAUGE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.sort.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id type
|
workload.googleapis.com/oracle.sort.row.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.tablespace.count
|
|
GAUGE , INT64 gce_instance |
contents database_id db_system global_name status
|
workload.googleapis.com/oracle.tablespace.size
|
|
GAUGE , INT64 gce_instance |
contents database_id db_system global_name state tablespace_name
|
workload.googleapis.com/oracle.user.calls
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.user.commits
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.user.rollbacks
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id
|
workload.googleapis.com/oracle.wait.count
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id type wait_class
|
workload.googleapis.com/oracle.wait.time
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id type wait_class
|
workload.googleapis.com/oracle.wait.timeouts
|
|
CUMULATIVE , INT64 gce_instance |
database_id db_system global_name instance_id type wait_class
|
구성 확인
이 섹션에서는 Oracle DB 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 운영 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.
Oracle DB 로그가 Cloud Logging으로 전송되고 있는지 확인하려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Logging인 결과를 선택합니다.
- 편집기에 다음 쿼리를 입력한 후 쿼리 실행을 클릭합니다.
resource.type="gce_instance" (log_id("oracledb_alert") OR log_id("oracledb_audit"))
Oracle DB 측정항목이 Cloud Monitoring으로 전송되고 있는지 확인하려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 leaderboard 측정항목 탐색기 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- 쿼리 빌더 창의 툴바에서 이름이 code MQL 또는 code MQL인 버튼을 선택합니다.
- MQL 전환 버튼에 MQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.
- 편집기에 다음 쿼리를 입력한 후 쿼리 실행을 클릭합니다.
fetch gce_instance | metric 'workload.googleapis.com/oracle.logon.count' | every 1m
대시보드 보기
Oracle DB 측정항목을 보려면 차트나 대시보드가 구성되어 있어야 합니다. Oracle DB 통합에는 대시보드가 하나 이상 포함됩니다. 통합을 구성하고 운영 에이전트가 측정항목 데이터 수집을 시작한 후 모든 대시보드가 자동으로 설치됩니다.
통합을 설치하지 않고도 대시보드의 정적 미리보기를 볼 수 있습니다.
설치된 대시보드를 보려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- 대시보드 목록 탭을 선택한 후 통합 카테고리를 선택합니다.
- 확인할 대시보드의 이름을 클릭합니다.
통합을 구성했지만 대시보드가 설치되지 않은 경우 운영 에이전트가 실행 중인지 확인합니다. 대시보드에 차트의 측정항목 데이터가 없으면 대시보드 설치가 실패합니다. 운영 에이전트가 측정항목 수집을 시작하면 대시보드가 자동으로 설치됩니다.
대시보드의 정적 미리보기를 보려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 통합 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Compute Engine 배포 플랫폼 필터를 클릭합니다.
- Oracle DB 항목을 찾고 세부정보 보기를 클릭합니다.
- 정적 미리보기를 보려면 대시보드 탭을 선택합니다. 대시보드가 설치되어 있으면 대시보드 보기를 클릭하여 대시보드로 이동할 수 있습니다.
Cloud Monitoring의 대시보드에 대한 자세한 내용은 대시보드 및 차트를 참조하세요.
통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.
알림 정책 설치
알림 정책은 지정된 조건이 발생할 때 Cloud Monitoring에서 알림을 받도록 지시합니다. Oracle DB 통합에는 사용할 알림 정책이 하나 이상 포함됩니다. Monitoring의 통합 페이지에서 이러한 알림 정책을 보고 설치할 수 있습니다.
사용 가능한 알림 정책에 대한 설명을 보고 설치하려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 통합 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Oracle DB 항목을 찾고 세부정보 보기를 클릭합니다.
- 알림 탭을 선택합니다. 이 탭에는 사용 가능한 알림 정책에 대한 설명과 이를 설치하기 위한 인터페이스가 제공됩니다.
- 알림 정책을 설치합니다. 알림 정책은 경고가 트리거되었다는 알림을 전송할 위치를 알아야 하므로, 설치 시 사용자에게 해당 정보를 요청합니다.
알림 정책을 설치하려면 다음을 수행합니다.
- 사용 가능한 알림 정책 목록에서 설치할 정책을 선택합니다.
알림 구성 섹션에서 알림 채널을 하나 이상 선택합니다. 알림 채널 사용을 중지할 수 있지만 사용 중지하면 알림 정책이 자동으로 실행됩니다. Monitoring에서 상태를 확인할 수 있지만 알림이 수신되지 않습니다.
알림 채널에 대한 자세한 내용은 알림 채널 관리를 참조하세요.
- 정책 만들기를 클릭합니다.
Cloud Monitoring의 알림 정책에 대한 자세한 내용은 알림 소개를 참조하세요.
통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.
다음 단계
Ansible을 사용하여 운영 에이전트를 설치하고, 서드파티 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 서드파티 애플리케이션 문제 해결 동영상을 참조하세요.