이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Oracle용 에이전트 설정

Oracle 데이터베이스와 함께 호스트에 Google Cloud's Agent for Compute Workloads를 설정하여 측정항목을 수집하고 Oracle 데이터베이스 워크로드를 모니터링할 수 있습니다.

이 문서에서는 Oracle Database 워크로드를 실행하는 Compute Engine 인스턴스에 Compute 워크로드용 에이전트를 설치, 구성, 확인하는 방법을 보여줍니다.

에이전트는 Oracle 데이터베이스 성능 뷰 (예: V$DATABASE, V$INSTANCE, V$DATAGUARD_STATS) 및 데이터 사전 뷰 (예: DBA_DATA_FILES, DBA_FREE_SPACE)를 쿼리하여 다양한 Oracle 측정항목을 수집합니다. 이러한 측정항목은 시각화하고 분석할 수 있는 Cloud Monitoring으로 전송됩니다. 지원되는 측정항목을 참고하세요.

시스템 요구사항

운영체제	Oracle 버전	Oracle 버전
Red Hat Enterprise Linux 버전 7, 8, 9 Oracle Linux 버전 7, 8, 9	Oracle Database 19c Oracle Database 23ai* 참고: 에이전트는 Red Hat Enterprise Linux 7 또는 Oracle Linux 7에서 실행되는 Oracle Database 23ai에서 테스트되지 않았습니다.	Enterprise 버전 Standard 버전 Express (무료) 버전

기본 요건

Oracle 데이터베이스 워크로드를 모니터링하기 위해 Compute 워크로드용 에이전트를 설치하기 전에 다음 기본 요건을 충족해야 합니다.

Compute Engine 인스턴스가 없는 경우 인스턴스를 만듭니다. cloud-platform에 액세스 범위를 구성합니다.
Compute Engine 인스턴스에서 루트 액세스 권한 설정
공용 네트워크 액세스 또는 비공개 네트워크 액세스를 통해 Google Cloud API 엔드포인트에 대한 연결을 사용 설정합니다.
측정항목 수집을 사용 설정하려면 Secret Manager에서 보안 비밀을 만들어 이 가이드의 뒷부분에서 만들 데이터베이스 사용자의 데이터베이스 비밀번호를 저장합니다.

이 가이드의 예시에서는 wlmagent-password이라고 가정합니다.
서비스 계정에 Identity and Access Management (IAM) 역할을 부여합니다.

Google Cloud의 Compute 워크로드용 에이전트는 VM에 연결된 Identity and Access Management (IAM) 서비스 계정을 사용하여 Google Cloud 로 인증하고 Google Cloud 리소스에 액세스할 수 있는 권한을 얻습니다. 다음 IAM 역할이 포함된 새 서비스 계정을 사용합니다.

주의: Compute 워크로드용 에이전트에 Compute Engine 기본 서비스 계정을 사용하고 계정에 Secret Manager 액세스 권한을 부여하면 보안 위험이 크게 증가합니다. 대신 단일 목적 서비스 계정을 만들고 VM에 대한 사용자의 셸 액세스를 제한하는 것이 좋습니다.
- Compute 뷰어 (roles/compute.viewer)
- 모니터링 측정항목 작성자 (roles/monitoring.metricWriter)
- Secret Manager 보안 비밀 접근자 (roles/secretmanager.secretAccessor)
  
  최소 권한의 원칙을 따르려면 프로젝트 수준이 아닌 비밀 수준에서 Secret Manager Secret Accessor 역할을 부여하는 것이 좋습니다. 이렇게 하면 서비스 계정에 필요한 특정 보안 비밀에만 액세스할 수 있습니다.
역할을 부여하는 방법을 알아보려면 서비스 계정에 대한 액세스 관리를 참고하세요.
Google Cloud API 액세스를 사용 설정합니다.

Google Cloud API에 대한 액세스를 사용 설정하려면 VM 만들기 및 서비스 계정 연결을 참고하세요.

Google CloudAPI에 액세스하고 서비스 계정에 할당된 IAM 권한을 사용하여 액세스 제어를 관리하도록 VM 인스턴스를 구성하는 것이 좋습니다. 사용자 관리 서비스 계정 및 승인을 참고하세요.

외부 IP 주소가 없는 VM 인스턴스에서 Oracle 데이터베이스를 실행하는 경우 컴퓨팅 워크로드용 에이전트가Google Cloud API 및 서비스에 액세스할 수 있도록 VM의 서브넷에서 비공개 Google 액세스를 사용 설정합니다. 서브넷에서 비공개 Google 액세스를 사용 설정하려면 비공개 Google 액세스 구성을 참고하세요.

에이전트 설치

컴퓨팅 워크로드용 에이전트를 설치하려면 다음을 실행하세요.

저장소 구성 파일을 만듭니다.

sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Workload Agent
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-\$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

패키지 관리자의 메타데이터를 업데이트합니다.
```
sudo yum makecache
```
google-cloud-workload-agent rpm 패키지를 설치합니다.
```
sudo yum install google-cloud-workload-agent
```

Oracle용 에이전트를 설치한 후 에이전트 설치를 확인합니다.

에이전트 설치 확인

에이전트가 실행 중인지 확인하려면 운영체제를 선택한 후 다음 단계를 따르세요.

SSH를 사용하여 VM 인스턴스에 연결합니다.

다음 명령어를 실행합니다.

systemctl status google-cloud-workload-agent

에이전트가 올바르게 작동하는 경우 출력에 active (running)이 포함됩니다. 예를 들면 다음과 같습니다.

google-cloud-workload-agent.service - Google Cloud Workload Agent
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; preset: disabled)
Active: active (running) since Tue 2024-09-03 22:29:57 UTC; 3s ago
Main PID: 274972 (google_cloud_wo)
 Tasks: 10 (limit: 100440)
Memory: 51.2M (max: 1.0G limit: 1.0G available: 972.7M)
   CPU: 625ms
CGroup: /system.slice/google-cloud-workload-agent.service
       └─274972 /usr/bin/google_cloud_workload_agent startdaemon

Sep 03 22:29:57 my_gce_instance systemd[1]: Started Google Cloud Workload Agent.

에이전트가 실행되고 있지 않으면 에이전트를 다시 시작해 보세요.

에이전트 구성

컴퓨팅 워크로드용 에이전트를 설치한 후 필요에 따라 에이전트의 구성 파일을 업데이트하여 에이전트의 다른 기능을 사용 설정할 수 있습니다. Oracle 데이터베이스 워크로드에 대해 구성할 수 있는 매개변수 목록은 구성 매개변수를 참고하세요.

에이전트를 구성한 후 다시 설치를 확인하여 에이전트가 올바르게 구성되었는지 확인할 수 있습니다.

구성 매개변수

컴퓨팅 워크로드용 에이전트는 Oracle에 대해 다음 구성 매개변수를 지원합니다.

매개변수		설명
`log_level`	`String` 에이전트의 로깅 수준을 설정하려면 로그 수준을 추가합니다. 사용 가능한 로그 수준은 다음과 같습니다. `DEBUG` `INFO` `WARNING` `ERROR` 기본값은 `INFO`입니다.
`log_to_cloud`	`Boolean` 에이전트 로그를 Cloud Logging으로 리디렉션하려면 `true`를 지정합니다. 기본값은 `true`입니다.
`oracle_configuration.enabled`	`Boolean` (선택사항) Oracle 서비스가 활성 상태인지 확인합니다. `true`로 설정된 경우 또는 설정되지 않았고 워크로드가 있는 경우 검색 및 측정항목 수집을 구성할 수 있습니다. `false`로 설정하면 Oracle 서비스와 관련 기능이 사용 중지됩니다.
다음 하위 매개변수는 `oracle_configuration.enabled: true`를 지정할 때만 적용됩니다.
`oracle_configuration.oracle_discovery.enabled`	`Boolean` (선택사항) Oracle Discovery가 활성 상태인지 여부를 결정합니다. 기본값은 `true`입니다.
`oracle_configuration.oracle_discovery.update_frequency`	`Int` (선택사항) 컴퓨팅 워크로드용 에이전트가 검색 프로세스를 실행하는 빈도를 결정하는 샘플 간격(초)을 지정합니다. 기본값은 3,600초 (1시간)입니다. 값이 초를 나타내는 소문자 's'로 끝나야 합니다. 예를 들면 `30s`입니다.
`oracle_configuration.oracle_metrics.enabled`	`Boolean` (선택사항) Compute 워크로드용 에이전트가 Oracle 모니터링 측정항목을 수집하도록 사용 설정하려면 `true`를 지정합니다. 기본값은 `false`입니다.
다음 하위 매개변수는 `oracle_metrics.enabled: true`를 지정할 때만 적용됩니다.
`oracle_configuration.oracle_metrics.collection_frequency`	`Int` (선택사항) 컴퓨팅 워크로드용 에이전트가 Oracle 모니터링 측정항목을 수집하기 위해 Oracle 데이터베이스 인스턴스를 쿼리하는 빈도를 결정하는 샘플 간격(초)을 지정합니다. 기본값은 60초입니다. 값이 초를 나타내는 소문자 's'로 끝나야 합니다. 예를 들면 `30s`입니다.
`oracle_configuration.oracle_metrics.query_timeout`	`String` (선택사항) Oracle 데이터베이스 인스턴스에 수행되는 각 쿼리의 제한 시간을 지정합니다. 기본값은 10초입니다. 값이 초를 나타내는 소문자 's'로 끝나야 합니다. 예를 들면 `30s`입니다.
`oracle_configuration.oracle_metrics.connection_parameters.username`	`String` Oracle 데이터베이스 인스턴스를 쿼리하는 데 사용되는 사용자 계정을 지정합니다. 이 사용자에게 Oracle 데이터베이스의 성능 뷰를 읽을 수 있는 필수 권한이 있는지 확인합니다.
`oracle_configuration.oracle_metrics.connection_parameters.host`	`String` 데이터베이스 인스턴스를 호스팅하는 로컬 머신의 식별자를 지정합니다.
`oracle_configuration.oracle_metrics.connection_parameters.port`	`Int` Oracle Database 인스턴스가 쿼리를 허용하는 포트를 지정합니다.
`oracle_configuration.oracle_metrics.connection_parameters.service_name`	`String` 에이전트가 모니터링할 Oracle 데이터베이스 인스턴스의 서비스 이름을 지정합니다.
`oracle_configuration.oracle_metrics.connection_parameters.secret.project_id`	`String` 데이터베이스에 쿼리를 실행하는 사용자의 비밀번호를 가져올 Secret Manager의 프로젝트 ID를 지정합니다.
`oracle_configuration.oracle_metrics.connection_parameters.secret.secret_name`	`String` 사용자 계정의 비밀번호를 저장하는 Secret Manager의 보안 비밀 이름을 지정합니다.

Oracle 측정항목 수집 및 보기

Oracle Database 워크로드의 측정항목 수집을 사용 설정할 수 있습니다. 지원되는 측정항목을 참고하세요.

측정항목 수집 사용 설정

컴퓨팅 워크로드용 에이전트를 사용하여 Oracle 측정항목 수집을 사용 설정하려면 다음 단계를 따르세요.

SSH를 사용하여 VM 인스턴스에 연결합니다.
Oracle OS 사용자로 oraenv 도구를 실행하여 환경 변수를 설정합니다. /etc/oratab 파일에 oracle 사용자 및 ORACLE_SID가 이미 정의되어 있다고 가정합니다.
```
sudo su - oracle
export PATH=$PATH:/usr/local/bin
. oraenv
sqlplus / as sysdba
```
SYSDBA 또는 SYSOPER 사용자로 Oracle 데이터베이스에서 기본 요건에서 만든 보안 비밀과 일치하는 비밀번호로 모니터링할 사용자를 만듭니다.

참고: Oracle 멀티테넌트 컨테이너 데이터베이스가 있는 경우 사용자 이름에 common_user_prefix(일반적으로 c##)를 접두사로 지정하여 공통 사용자를 만듭니다. 예를 들어 wlmagent는 c##wlmagent이 됩니다.
```
CREATE USER wlmagent IDENTIFIED BY password;
```
SYSDBA 또는 SYSOPER 사용자로 성능 뷰를 쿼리할 모니터링 사용자에게 다음 권한을 부여합니다.
- SESSION
- SELECT_CATALOG_ROLE
- SYSDG
```
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO wlmagent;
```
sqlplus 및 oracle 사용자를 종료합니다.
루트 사용자로 원하는 편집기를 사용하여 에이전트의 구성 파일을 수정합니다.
```
sudo nano /etc/google-cloud-workload-agent/configuration.json
```
구성 파일에서 oracle_metrics 섹션을 수정하여 다음과 같이 업데이트합니다.
1. enabled 매개변수를 true로 설정합니다.
2. service_name 매개변수를 설정하여 에이전트가 모니터링할 Oracle 인스턴스의 서비스 이름을 지정합니다.
3. 에이전트가 데이터베이스에 연결할 Oracle 사용자 이름을 지정합니다.
4. 상담사가 데이터베이스에 연결할 수 있도록 host 및 port 매개변수를 설정합니다.
5. 에이전트가 사용자 이름의 비밀번호를 가져오도록 secret 매개변수를 설정합니다.
  - project_id: Secret Manager 데이터가 포함된 프로젝트의 ID입니다.
  - secret_name: Secret Manager의 보안 비밀 이름입니다.
다음은 구성 파일의 예시입니다.
```
{
  "log_level": "INFO",
  "common_discovery": {"collection_frequency": "3600s" },
  "oracle_configuration": {
    "enabled": true,
    "oracle_metrics": {
      "enabled": true,
      "collection_frequency": "30s",
      "connection_parameters": [
        {
          "host": "localhost",
          "port": 1521,
          "service_name": "orcl",
          "username": "wlmagent",
          "secret": {
            "project_id": "my-project",
            "secret_name": "wlmagent_password"
          }
        }
      ]
    }
  }
}
```
구성 파일을 저장합니다.
새 설정이 적용되도록 에이전트를 다시 시작합니다.

측정항목 보기

측정항목 탐색기를 사용하거나 커스텀 대시보드를 가져와 수집된 측정항목을 보고 Oracle 성능과 상태를 모니터링할 수 있습니다.

측정항목 탐색기에서 측정항목 보기

측정항목 탐색기에서 Oracle 측정항목을 보려면 다음을 수행하세요.

Google Cloud 콘솔에서 Monitoring으로 이동합니다.
측정항목 탐색기를 클릭합니다.
리소스 유형 및 측정항목 찾기에서 다음을 실행합니다.
1. 리소스 유형에서 VM 인스턴스를 선택합니다.
2. 측정항목에서 보려는 Oracle 측정항목을 선택합니다.

필요에 따라 필터와 집계를 사용하여 선택한 Oracle 측정항목의 실시간 데이터와 이전 데이터를 볼 수 있습니다.

맞춤 대시보드 가져오기

에이전트가 수집한 Oracle 측정항목을 보려면 커스텀 대시보드 만들기 및 관리의 안내에 따라 커스텀 Cloud Monitoring 대시보드를 만드세요.

샘플 대시보드 oracle-status-overview.json와 가져오는 방법을 설명하는 안내를 제공합니다. oracle-status-overview.json 대시보드에는 다음 Oracle 측정항목 차트가 표시됩니다.

데이터베이스 시간 분류
데이터베이스 메모리 사용량
대기 클래스별 평균 활성 세션
디스크 I/O
CPU 사용률
네트워크 트래픽

oracle-status-overview.json 대시보드를 가져오려면 다음 단계를 따르세요.

gcloud CLI가 설치되어 있고 최신 상태인지 확인합니다. 자세한 내용은 gcloud CLI 설치를 참고하세요.

컴퓨트 워크로드용 에이전트 GitHub 저장소에서 oracle-status-overview.json 대시보드를 다운로드합니다.

$ curl -H "Accept: application/vnd.github.v3.raw" -o oracle-status-overview.json https://api.github.com/repos/GoogleCloudPlatform/workloadagent/contents/observability/dashboards/oracle-status-overview.json

다음 명령어를 실행하여 대시보드를 가져옵니다.
```
gcloud alpha monitoring dashboards create --config-from-file=oracle-status-overview.json
```
명령어를 실행하면 Cloud Monitoring에 커스텀 대시보드가 생성됩니다. 대시보드를 보는 방법을 알아보려면 대시보드 찾기 및 보기를 참고하세요.

지원되는 측정항목

컴퓨팅 워크로드용 에이전트에서 수집한 모든 Oracle 측정항목은 workload.googleapis.com/oracle 경로에서 확인할 수 있습니다.

다음은 지원되는 Oracle 측정항목과 그에 해당하는 Cloud Monitoring 경로 목록입니다.

프로세스 메모리
- 사용 중인 프로세스(PGA) 메모리(바이트)입니다.
  
  process/pga_memory/total_used_size
- 할당된 프로세스(PGA) 메모리(바이트)
  
  process/pga_memory/total_allocated_size
공유 메모리
- 공유 메모리(SGA) 항목의 크기(바이트)
  
  process/sga_memory/size
시스템 대기 이벤트
- 등록된 대기 클래스의 총 대기 수
  
  sys_wait/count
- 이 대기 클래스에서 소비된 집계 시간(초)
  
  sys_wait/time
- 이 대기 클래스의 총 포그라운드 대기 수
  
  sys_wait/foreground/count
- 이 대기 클래스의 집계된 포그라운드 대기 시간(초)
  
  sys_wait/foreground/time
시스템 경과 시간
- 데이터베이스 사용자 수준 호출을 실행하는 데 걸린 시간(초)
  
  sys_time/db_time
- 데이터베이스 사용자 수준 호출에 사용된 CPU 시간(초)
  
  sys_time/db_cpu
- SQL 문이 실행되는 경과 시간
  
  sys_time/sql_execute_elapsed_time
- SQL 문을 파싱하는 데 걸린 시간
  
  sys_time/parse_time_elapsed
- PL/SQL 인터프리터를 실행하는 데 소요된 시간
  
  sys_time/pl_sql_execution_elapsed_time
- 데이터베이스 백그라운드 프로세스에서 사용된 경과 시간(초)
  
  sys_time/background_elapsed_time
I/O 통계
- 읽기 작업의 총 개수 (소규모 + 대규모)
  
  iostat/read_ops_count
- 쓰기 작업의 총 개수 (소규모 + 대규모)
  
  iostat/write_ops_count
- 읽은 총 바이트 수
  
  iostat/read_bytes_count
- 작성된 총 바이트 수
  
  iostat/write_bytes_count
- I/O 작업당 평균 지연 시간
  
  iostat/average_latency_seconds
데이터 파일
- 데이터 파일의 할당된 크기(바이트)
  
  data_files/total_bytes
- 사용 중인 데이터 파일 공간(바이트)
  
  data_files/bytes_used
- 데이터 파일 여유 공간(바이트)
  
  data_files/available_bytes
- 데이터 파일 자동 확장 한도(바이트)
  
  data_files/max_bytes
- 사용된 데이터 파일의 비율
  
  data_files/percent_used
데이터베이스 인스턴스
- 인스턴스 업타임(초)
  
  instance/uptime
- 인스턴스 상태
  
  instance/status
  
  이 측정항목은 다음 값을 가질 수 있습니다.
  
  UNKNOWN 0
  
  STARTED 1
  
  MOUNTED 2
  
  OPEN 3
  
  OPEN MIGRATE 4
- 열기 모드
  
  instance/db_open_mode
  
  이 측정항목은 다음 값을 가질 수 있습니다.
  
  UNKNOWN 0
  
  MOUNTED 1
  
  READ WRITE 2
  
  READ ONLY 3
  
  READ ONLY WITH APPLY 4
Oracle Data Guard
- 다시 실행 적용 지연 시간(초)
  
  dataguard/apply_lag
- 전송 지연 시간(초) 다시 실행
  
  dataguard/transport_lag

에이전트 관리

에이전트 다시 시작

컴퓨팅 워크로드용 에이전트 작동이 중지되거나 구성을 업데이트할 경우 에이전트를 다시 시작합니다.

SSH를 사용하여 VM 인스턴스에 연결합니다.

다음 명령어를 실행합니다.

sudo systemctl restart google-cloud-workload-agent

에이전트 버전 확인

에이전트 버전을 확인하려면 다음 단계를 수행합니다.

SSH를 사용하여 VM 인스턴스에 연결합니다.
다음 명령어를 실행합니다.
```
yum info google-cloud-workload-agent
```

업데이트 확인

SSH를 사용하여 VM 인스턴스에 연결합니다.

다음 명령어를 실행합니다.

sudo yum check-update google-cloud-workload-agent

에이전트 업데이트

최신 버전의 에이전트를 사용하려면 정기적으로 업데이트를 확인하고 에이전트를 업데이트하세요.

SSH를 사용하여 VM 인스턴스에 연결합니다.

다음 명령어를 실행합니다.

sudo yum --nogpgcheck update google-cloud-workload-agent

에이전트 로그 보기

컴퓨팅 워크로드용 에이전트 로그는 /var/log/google-cloud-workload-agent.log에서 확인할 수 있습니다.

로그 상세도는 log_level 매개변수로 제어됩니다. DEBUG 로그 수준을 설정하면 특정 문제를 해결하기 위한 추가 정보가 포함되지만 로그가 훨씬 커집니다.

기본적으로 Compute 워크로드용 에이전트 로그는 VM 인스턴스에서 Cloud Logging으로 리디렉션됩니다.

Logging에서 에이전트 로그를 보려면 다음 단계를 수행합니다.

Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

로그 탐색기로 이동
쿼리 창으로 이동합니다.
리소스 드롭다운 메뉴에서 전역을 선택한 후 적용을 클릭합니다.
쿼리 편집기에 google-cloud-workload-agent를 입력합니다.
쿼리 실행을 클릭합니다.

모든 VM 인스턴스에서 실행되는 에이전트에서 생성된 로그를 볼 수 있습니다. 특정 인스턴스의 로그를 필터링할 수 있습니다.

Cloud Logging에서 에이전트 로그 구성

에이전트 로그의 Cloud Logging으로의 기본 리디렉션을 사용 중지하려면 다음 단계를 따르세요.

SSH를 사용하여 VM 인스턴스에 연결합니다.

에이전트의 구성 파일을 엽니다.

/etc/google-cloud-workload-agent/configuration.json

log_to_cloud 속성의 경우 값을 false로 업데이트합니다.
구성 파일을 저장합니다.
이 변경사항을 적용하려면 에이전트를 다시 시작합니다.

문제 해결

다음 섹션에서는 Oracle Database 워크로드용 에이전트 사용과 관련된 일반적인 문제, 원인, 해결 방법을 설명합니다.

IAM 권한 부족

문제: 컴퓨팅 워크로드용 에이전트 로그에 IAM 권한 부족 오류가 표시됩니다.

googleapi: Error 403: The client is not authorized to make this request.

원인: 에이전트가 사용하는 서비스 계정에 Google Cloud API에 액세스하는 데 필요한 IAM 권한이 없거나 Secret Manager의 Oracle 사용자 비밀번호가 없습니다.

해결 방법: 이 문제를 해결하려면 VM 서비스 계정에 기본 요건에 언급된 IAM 역할과 권한이 있는지 확인합니다.

부족한 인증 범위

문제: Compute 워크로드용 에이전트 로그에 인증 범위가 부족하다고 표시됩니다.

googleapi: Error 403: Request had insufficient authentication scopes.

원인: 에이전트에서 사용하는 서비스 계정에 필요한 액세스 범위가 없습니다.

해결 방법: 이 문제를 해결하려면 VM의 액세스 범위를 cloud-platform로 구성하세요.

Cloud Monitoring에 측정항목이 표시되지 않음

문제: Compute 워크로드용 에이전트의 측정항목이 Cloud Monitoring에 표시되지 않습니다.

원인:

이 문제의 가능한 원인은 다음과 같습니다.

컴퓨팅 워크로드용 에이전트에서 사용하는 서비스 계정에 필요한 IAM 권한이 없습니다.
에이전트에서 사용하는 Oracle 사용자에게 성능 뷰를 쿼리할 수 있는 충분한 권한이 없습니다.
에이전트 구성에 오류가 있습니다.

해결 방법:

서비스 계정의 권한 부족 문제를 해결하려면 다음 단계를 따르세요.
1. Google Cloud 콘솔에서 VM 인스턴스 세부정보 페이지로 이동하여 에이전트를 실행하는 인스턴스에서 사용 중인 서비스 계정을 확인합니다.
2. IAM 및 관리자 페이지로 이동하여 서비스 계정에 기본 요건에 언급된 모든 필수 역할과 권한이 있는지 확인합니다. 서비스 계정에 필요한 누락된 역할을 부여합니다.
Oracle 사용자의 권한이 부족한 문제를 해결하려면 다음 단계를 따르세요.
1. Oracle 사용자에게 성능 뷰를 쿼리하는 데 필요한 다음 권한이 있는지 확인합니다.
  - SESSION
  - SELECT_CATALOG_ROLE
  - SYSDG
2. 다음 SQL 명령어를 실행하여 누락된 권한을 부여합니다.
```
-- Grant the "wlmagent" user the required permissions
GRANT CREATE SESSION,SELECT_CATALOG_ROLE,SYSDG TO USERNAME;
```
에이전트의 잘못된 구성을 해결하려면 다음 단계를 따르세요.
1. SSH를 사용하여 VM 인스턴스에 연결합니다.
2. 에이전트의 로그를 검토하여 측정항목 수집을 방해하는 오류나 문제가 있는지 확인합니다. /var/log/google-cloud-workload-agent.log에서 로그를 확인할 수 있습니다.
  
  권한 오류, 잘못된 구성 또는 연결 문제를 찾습니다.
3. 오류를 해결합니다.
4. 에이전트를 다시 시작하고 측정항목 수집이 시작되는지 확인합니다.

구성 파일을 로드할 수 없음

문제: 구성 파일에 잘못된 값이 있으면 다음 오류가 표시됩니다.

"Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown
field "{field_name}"

해결 방법: 이 문제를 해결하려면 구성 매개변수의 세부정보를 사용하여 구성 파일을 업데이트하세요.

데이터 수집을 초기화할 수 없음

문제: 에이전트를 설치한 후 구성 파일이 업데이트되지 않으면 다음 오류가 표시됩니다.

"Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"

해결 방법: 이 문제를 해결하려면 구성 매개변수를 사용하여 사용자 인증 정보 구성을 초기화하세요.

`UNKNOWN`	`0`
`STARTED`	`1`
`MOUNTED`	`2`
`OPEN`	`3`
`OPEN MIGRATE`	`4`

`UNKNOWN`	`0`
`MOUNTED`	`1`
`READ WRITE`	`2`
`READ ONLY`	`3`
`READ ONLY WITH APPLY`	`4`

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

시스템 요구사항

기본 요건

에이전트 설치

에이전트 설치 확인

에이전트 구성

구성 매개변수

Oracle 측정항목 수집 및 보기

측정항목 수집 사용 설정

측정항목 보기

측정항목 탐색기에서 측정항목 보기

맞춤 대시보드 가져오기

지원되는 측정항목

에이전트 관리

에이전트 다시 시작

에이전트 버전 확인

업데이트 확인

에이전트 업데이트

에이전트 로그 보기

Cloud Logging에서 에이전트 로그 구성

문제 해결

IAM 권한 부족

부족한 인증 범위

Cloud Monitoring에 측정항목이 표시되지 않음

구성 파일을 로드할 수 없음

데이터 수집을 초기화할 수 없음

Oracle용 에이전트 설정