AlloyDB Omni の管理とモニタリング

ドキュメントのバージョンを選択してください。

このページでは、AlloyDB Omni ユーザーロールの管理、AlloyDB Omni サーバーのアクティビティのモニタリング、AlloyDB Omni インストールの更新または削除の方法について説明します。

ユーザーロールを管理する

AlloyDB Omni では次のロールを使用します。

AlloyDB Omni には、alloydbadmin という名前のスーパーユーザーロールと、alloydbmetadata という名前の非スーパーユーザーロールが含まれています。
デフォルトの postgres ユーザーにはスーパーユーザーロールがあります。
他の事前定義されたユーザーロールには権限がありません。将来の使用のために予約されています。

AlloyDB Omni のデータベースを設定する

AlloyDB Omni データベースを設定する際は、次の手順に沿って操作することをおすすめします。

postgres ユーザーロールを使用して、データベースを定義またはインポートします。新規インストールでは、このロールにはスーパーユーザー権限があります。
再度、postgres ユーザーロールを使用して、アプリケーションのテーブルへの適切なアクセス権を持つ新しいユーザーロールを作成します。
これらの新しいアクセス制限付きロールを使用して、データベースに接続するようにアプリケーションを構成します。

新しいユーザーロールは、必要な数だけ作成して定義できます。AlloyDB Omni に付属するユーザーロールは変更したり、削除しないでください。

詳細については、AlloyDB Omni のユーザーとロールを管理するをご覧ください。

AlloyDB Omni モニターをインストールして起動する

AlloyDB Omni モニターは、エンドポイントで指標を公開するオプションコンポーネントです。モニタリングサーバーを構成して、このエンドポイントから指標サンプルを取得し、モニタリングスタックに統合できます。

モニターをインストールして起動するには、AlloyDB Omni サービスを実行している各ホストで次の操作を行います。

モニターパッケージをインストールします。
```
 sudo dnf install alloydbomni_monitor
```

モニターサービスを有効にして起動します。

 sudo systemctl enable alloydbomni_monitor
 sudo systemctl start alloydbomni_monitor

AlloyDB Omni モニターを構成する

デフォルトでは、モニターは標準の AlloyDB Omni サービス名とデータディレクトリで動作するように構成されています。インストールでカスタム値を使用する場合は、systemd オーバーライドファイルを使用してモニターを構成する必要があります。

/usr/lib/systemd/system/alloydbomni_monitor.service でデフォルト構成を確認します。
- OMNI_SERVICE_NAME: AlloyDB Omni systemd サービスの名前。デフォルトは alloydbomni18 です。
- PG_DATA_DIR: データベースデータディレクトリのパス。デフォルトは /var/lib/postgresql/18/data です。
  
  データベースデータディレクトリを見つけるには、次のコマンドを実行します。
```
sudo -u postgres /usr/lib/postgresql/18/bin/psql -h localhost -c "SHOW data_directory;"
```
インストールでデフォルト以外の値を使用する場合は、オーバーライドディレクトリと override.conf ファイルを作成します。
```
 sudo mkdir -p /etc/systemd/system/alloydbomni_monitor.service.d
 sudo touch /etc/systemd/system/alloydbomni_monitor.service.d/override.conf
```
次のコンテンツを /etc/systemd/system/alloydbomni_monitor.service.d/override.conf に追加します。プレースホルダの値をカスタム構成に置き換えます。
```
 [Service]
 Environment="OMNI_SERVICE_NAME=SERVICE_NAME"
 Environment="PG_DATA_DIR=PG_DATA_DIR"
```
次のように置き換えます。
- SERVICE_NAME: AlloyDB Omni systemd サービスの名前（alloydbomni18 など）。
- PG_DATA_DIR: データベースデータディレクトリのパス。たとえば、スタンドアロン RPM を使用して AlloyDB Omni をインストールし、PGDATA=/data を指定した場合は、/data を指定します。
systemd デーモンを再読み込みします。
```
 sudo systemctl daemon-reload
```
モニターサービスを再起動します。
```
 sudo systemctl restart alloydbomni_monitor
```

AlloyDB Omni モニターを確認する

モニターサービスが実行されていることを確認します。
```
 sudo systemctl status alloydbomni_monitor
```
指標エンドポイントに HTTP 呼び出しを行って、モニターが指標を公開していることを確認します。
```
curl http://localhost:9187/metrics
```

モニターの制限事項

AlloyDB Omni の CPU とメモリの上限に関連する指標は、環境で alloydbomni18 systemd サービスの CPU とメモリの上限が設定されている場合にのみ表示されます。次の指標が影響を受けます。

alloydb_omni_memory_limit_byte
alloydb_omni_memory_available_byte
alloydb_omni_node_cpu_mcpu

CPU とメモリの上限を設定する場合は、systemd ユニットファイルを構成します。次の例では、CPUQuota を 90% に、MemoryMax を 90% に構成します。 systemd ユニットファイルの詳細については、 systemd ユニットファイルを操作するをご覧ください。

systemd オーバーライド構成ファイルを作成します。

/etc/systemd/system/alloydbomni18.service.d ディレクトリに override.conf ファイルを作成します。
override.conf ファイルに次のコンテンツを追加します。
```
 [Service]
 CPUQuota=90%
 MemoryMax=90%
```
systemd デーモンを再読み込みします。
```
 sudo systemctl daemon-reload
```
AlloyDB Omni サービスを再起動します。
```
 sudo systemctl restart alloydbomni18
```

AlloyDB Omni をモニタリングする

AlloyDB Omni のインストールのモニタリングには、AlloyDB Omni 指標の取得と分析が含まれます。

AlloyDB Omni のログを取得するには、次のコマンドを実行します。

  sudo journalctl -u alloydbomni18

AlloyDB Omni をアンインストールする

AlloyDB Omni をアンインストールするには、次のコマンドを実行します。

  sudo dnf remove alloydbomni_monitor