このページは Cloud Translation API によって翻訳されました。

Oracle ワークロード用のエージェントを設定する

このドキュメントでは、Oracle Database ワークロードを実行する Compute Engine インスタンスに Agent for Compute Workloads をインストール、構成、検証する方法について説明します。

エージェントは、Oracle Database パフォーマンスビュー（V$DATABASE、V$INSTANCE、V$DATAGUARD_STATS など）とデータディクショナリビュー（DBA_DATA_FILES、DBA_FREE_SPACE など）をクエリして、さまざまな Oracle 指標を収集します。これらの指標は Cloud Monitoring に送信され、可視化と分析を行うことができます。サポートされている指標をご覧ください。

始める前に

Oracle Database ワークロードをモニタリングする Compute Workloads 用エージェントをインストールする前に、次の前提条件が満たされていることを確認してください。

Compute Engine インスタンスをまだ作成していない場合は作成します。アクセススコープを cloud-platform に構成します。
Compute Engine インスタンスで root アクセスを設定します。
システム要件を確認します。
サービスアカウントに IAM ロールを付与します。
パブリックネットワークアクセスまたはプライベートネットワークアクセスを使用して、 Google Cloud API エンドポイントへの接続を有効にします。
指標の収集を有効にする場合は、Secret Manager でシークレットを作成して、このガイドで後ほど作成するデータベースユーザーのデータベースパスワードを保存します。

このガイドの例では、wlmagent-password であると想定しています。

システム要件を確認する

次の表に、使用できる Oracle エディションとサポートされているオペレーティングシステムのバージョンを示します。

オペレーティングシステム	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 Edition Standard Edition Express（無料）エディション

サービスアカウントに IAM ロールを付与する

Agent for Compute Workloads は、コンピューティングインスタンスに関連付けられたサービスアカウントを使用して認証を行い、 Google Cloud リソースにアクセスします。

セキュリティを強化するため、Compute Engine のデフォルトのサービスアカウントを使用するのではなく、単一目的のサービスアカウントを使用することをおすすめします。

Agent for Compute Workloads がGoogle Cloud で認証を行い、 Google Cloud リソースにアクセスするために必要な権限がサービスアカウントに付与されるように、プロジェクトに対する次の IAM ロールをサービスアカウントに付与するよう管理者に依頼してください。

コンピューティング閲覧者（roles/compute.viewer）: コンピューティングインスタンスから指標を収集します。
Workload Manager Insights ライター（roles/workloadmanager.insightWriter）: データを Workload Manager データウェアハウスに書き込みます。
（推奨）ログ書き込み（roles/logging.logWriter）: エージェントログを Cloud Logging に送信します。
（省略可）Secret Manager のシークレットアクセサー（roles/secretmanager.secretAccessor）: Secret Manager を使用して Oracle インスタンスに接続するパスワードを保存する場合。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

管理者は、カスタムロールや他の事前定義ロールを使用して、必要な権限をサービスアカウントに付与することもできます。

Cloud APIs へのアクセスを有効にする

Compute Engine では、すべての Cloud APIs にすべてのアクセススコープを使用できるようにインスタンスを構成し、インスタンスサービスアカウントの IAM 権限のみを使用してGoogle Cloud リソースへのアクセスを制御することをおすすめします。詳細については、ユーザー管理のサービスアカウントを使用する VM を作成するをご覧ください。

Cloud APIs へのアクセスを制限する場合、Compute Workloads 用エージェントには、ホストコンピューティングインスタンスで次の最小 Cloud APIs アクセススコープが必要です。

https://www.googleapis.com/auth/cloud-platform

詳細については、スコープのベストプラクティスをご覧ください。

外部 IP アドレスを持たないコンピューティングインスタンスで Oracle アプリケーションを実行している場合は、インスタンスのサブネットで限定公開の Google アクセスを有効にして、Compute Workloads 用エージェントが Google API とサービスにアクセスできるようにする必要があります。限定公開の Google アクセスを有効にする方法については、限定公開の Google アクセスを構成するをご覧ください。

パッケージマネージャーを使用してエージェントをインストールして構成する

このセクションでは、パッケージマネージャーを使用して、コンピューティングインスタンスに Agent for Compute Workloads をインストールし、Oracle インスタンスに接続するように構成する方法について説明します。

Agent for Compute Workloads をインストールする手順は次のとおりです。

リポジトリ構成ファイルを作成します。

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 ワークロード用エージェントをインストールしたら、エージェントのインストールを確認します。

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

VM Extension Manager を設定する

VM Extension Manager を設定するには、次の操作を行います。

VM 拡張機能マネージャーのドキュメントで、始める前にのセクションを確認します。
VM Extension Manager ポリシーの作成と管理に必要な IAM ロールを設定します。詳しくは以下をご覧ください。

VM フリートにエージェントをインストールする

VM 拡張機能マネージャーポリシーを使用して、特定のゾーン内の VM フリートに最新バージョンの Agent for Compute Workloads をインストールするには、次の操作を行います。

コンソール

Google Cloud コンソールで、[VM 拡張機能ポリシー] ページに移動します。

[VM 拡張機能ポリシー] に移動
[拡張機能ポリシーを作成] をクリックします。
[名前] フィールドに、ポリシーの名前を入力します。
省略可: [説明] フィールドに、ポリシーの説明を入力します。
[優先度] フィールドで、ポリシー間の競合を解決するための優先度番号を指定します。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。
[リージョン] リストと [ゾーン] リストで、このポリシーを適用するゾーンを選択します。
[拡張機能] セクションで [拡張機能を追加] をクリックし、次の操作を行います。
1. [拡張機能] リストから、[Google Cloud のコンピューティングワークロード用拡張機能] を選択します。
2. [バージョン] フィールドは空欄のままにします。
  
  これにより、ポリシーは Agent for Compute Workloads の最新バージョンをインストールするように指示されます。
3. [構成ファイルの内容] フィールドに、エージェントに適用する構成を入力します。
  
  Oracle ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
  
  注: Agent for Compute Workloads がすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーで設定した内容で既存のエージェントのバージョンと構成がオーバーライドされます。
  
  エージェントの既存の構成は、各 VM の /etc/google-cloud-workload-agent/ ディレクトリにある BAK ファイルに書き込まれます。
4. [完了] をクリックします。
省略可: ポリシーのロールアウトを必要な VM に制限するには、次の操作を行います。
1. [ラベルを追加] をクリックし、必要な VM を識別するラベルを追加します。
2. [完了] をクリックします。
[作成] をクリックします。

gcloud

gcloud beta compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

次のように置き換えます。

POLICY_NAME: VM 拡張機能ポリシーの名前。

指定した名前のポリシーがゾーンにすでに存在する場合、コマンドは失敗します。
ZONE: このポリシーを適用するゾーン。
CONFIG_FILE_PATH: Agent for Compute Workloads が Oracle ワークロードに接続するための構成を含む JSON ファイルのローカルパス。
- または、構成をインライン文字列として指定するには、--config-from-file ではなく --config フラグを使用します。例: --config=google-cloud-workload-extension="CONFIG"Google Cloud は --config-from-file の使用を推奨しています。
- --config-from-file または --config のいずれかを使用できますが、同じコマンドで両方を使用することはできません。
- Oracle ワークロードのエージェントでサポートされている構成パラメータについては、構成パラメータをご覧ください。
注: Agent for Compute Workloads がすでに実行されている VM に VM Extension Manager ポリシーを適用すると、ポリシーで設定した内容で既存のエージェントのバージョンと構成がオーバーライドされます。

エージェントの既存の構成は、各 VM の /etc/google-cloud-workload-agent/ ディレクトリにある BAK ファイルに書き込まれます。
DESCRIPTION: ポリシーの説明（省略可）。
KEY_1=VALUE_1: ポリシーが VM をターゲットにするために使用するラベルを定義する Key-Value ペアのカンマ区切りリスト。
- ポリシーの対象となる VM には、指定されたすべてのラベルが必要です。
- --inclusion-labels を複数回指定すると、ポリシーは指定されたセレクタのいずれかに一致する VM をターゲットにします（論理 OR）。このフラグを省略すると、ポリシーは指定されたゾーン内のすべての VM をターゲットにします。
PRIORITY: ポリシーの優先度を定義する 0 から 65535 までの整数。数字が小さいほど優先度が高くなります。デフォルト値は 1000 です。

例:

次のコマンドは、test-project という名前のGoogle Cloud プロジェクトに test-agent-policy という名前のポリシーを作成します。このポリシーは、ゾーン us-centrail-f にデプロイされたすべての VM に最新バージョンの Agent for Compute Workloads をインストールします。agent-config.json で指定された構成がエージェントに適用されます。

gcloud beta compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

エージェントのインストールを確認する

エージェントが期待どおりに動作していることを確認する手順は次のとおりです。

コンピューティングインスタンスと SSH 接続を確立します。

エージェントパッケージのステータスを確認します。

systemctl status google-cloud-workload-agent

エージェントパッケージが期待どおりに実行されている場合、出力には active (running) が含まれます。次に例を示します。

google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

構成パラメータ

Agent for Compute Workloads は、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` 省略可。Agent for Compute Workloads が Oracle モニタリング指標を収集できるようにするには、`true` を指定します。デフォルト値は `false` です。
次の子パラメータは、`oracle_metrics.enabled: true` を指定した場合にのみ適用されます。
`oracle_configuration.oracle_metrics.collection_frequency`	`Int` 省略可。サンプル間隔を秒単位で指定します。これにより、Compute Workloads 用エージェントが Oracle Database インスタンスにクエリを実行して Oracle モニタリング指標を収集する頻度を決定します。デフォルト値は 60 秒です。値の末尾が秒を示す小文字の「s」になっていることを確認します。例: `30s`。
`oracle_configuration.oracle_metrics.query_timeout`	`String` 省略可。Oracle Database インスタンスに対して実行する各クエリのタイムアウトを指定します。デフォルト値は 10 秒です。値の末尾が秒を示す小文字の「s」になっていることを確認します。例: `30s`。
`oracle_configuration.oracle_metrics.connection_parameters.username`	`String` Oracle Database インスタンスのクエリに使用するユーザーアカウントを指定します。このユーザーに、Oracle Database のパフォーマンスビューを読み取るために必要な権限があることを確認してください。
`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 Database インスタンスのサービス名を指定します。
`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 Database で、前提条件で作成したシークレットと一致するパスワードを使用して、モニタリング用のユーザーを作成します。

注: Oracle Multitenant コンテナデータベースがある場合は、ユーザー名の前に 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 ユーザーを終了します。
root ユーザーとして、任意のエディタを使用してエージェントの構成ファイルを編集します。
```
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 のパフォーマンスとステータスをモニタリングするには、Metrics Explorer を使用するか、カスタムダッシュボードをインポートします。

Metrics Explorer で指標を表示する

Metrics Explorer で Oracle 指標を表示する手順は次のとおりです。

Google Cloud コンソールで [Monitoring] に移動します。
[Metrics Explorer] をクリックします。
[リソースタイプと指標を見つける] で、次の操作を行います。
1. [Resource type] に [VM Instance] を選択します。
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 にカスタムダッシュボードが作成されます。ダッシュボードを表示する方法については、ダッシュボードを検索して表示するをご覧ください。

サポートされている指標

Agent for Compute Workloads によって収集されたすべての 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

エージェントを管理する

エージェントを再起動する

Compute Workloads 用エージェントが停止するか、構成を更新した場合は、エージェントを再起動します。

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 ログレベルを設定すると、特定の問題のトラブルシューティングに役立つ追加情報が含まれますが、ログのサイズが大幅に大きくなります。

デフォルトでは、Agent for Compute Workloads のログは 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 権限がない

問題: Agent for Compute Workloads のログに IAM 権限不足のエラーが表示される。

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

原因: エージェントが使用するサービスアカウントに、 Google Cloud API にアクセスするために必要な IAM 権限がないか、Secret Manager に Oracle ユーザーのパスワードがありません。

解決策: この問題を解決するには、VM サービスアカウントに前提条件で説明されている IAM ロールと権限があることを確認します。

認証スコープが不十分

問題: Agent for Compute Workloads のログに認証スコープが不足していることが示される。

googleapi: Error 403: Request had insufficient authentication scopes.

原因: エージェントで使用されるサービスアカウントに必要なアクセススコープがありません。

解決策: この問題を解決するには、VM のアクセススコープを cloud-platform に構成します。

指標が Cloud Monitoring に表示されない

問題: Agent for Compute Workloads の指標が Cloud Monitoring に表示されない。

原因:

この問題の原因として考えられるのは次のとおりです。

Agent for Compute Workloads で使用されるサービスアカウントに必要な 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 ワークロード用のエージェントを設定する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

システム要件を確認する

サービス アカウントに IAM ロールを付与する

Cloud APIs へのアクセスを有効にする

パッケージ マネージャーを使用してエージェントをインストールして構成する

VM Extension Manager を使用して VM フリートにエージェントをインストールして管理する

VM Extension Manager を設定する

VM フリートにエージェントをインストールする

コンソール

gcloud

エージェントのインストールを確認する

構成パラメータ

Oracle 指標を収集して表示する

指標の収集を有効にする

指標を表示する

Metrics Explorer で指標を表示する

カスタム ダッシュボードをインポートする

サポートされている指標

エージェントを管理する

エージェントを再起動する

エージェントのバージョンを確認する

更新を確認する

エージェントを更新する

エージェントのログを表示する

Cloud Logging でエージェントログを構成する

トラブルシューティング

十分な IAM 権限がない

認証スコープが不十分

指標が Cloud Monitoring に表示されない

構成ファイルを読み込めませんでした

データ収集を初期化できませんでした

Oracle ワークロード用のエージェントを設定する

サービスアカウントに IAM ロールを付与する

パッケージマネージャーを使用してエージェントをインストールして構成する

カスタムダッシュボードをインポートする