このページでは、さまざまなカスタマイズ方法がサポートされている AlloyDB Omni のインストールをカスタマイズする方法について説明します。このページでは、一般的なカスタマイズについて説明します。
AlloyDB Omni テレメトリーを有効または無効にする
AlloyDB Omni テレメトリーは、基本的な仮名化された指標のセットを収集し、Google が管理するエンドポイントに送信する軽量クライアント エージェントを実装します。
AlloyDB Omni は無料で提供されるダウンロード可能なプロダクトであるため、このテレメトリーは、実行中のインスタンスの一般的な導入環境とデプロイ環境に関する重要な非個人情報（非 PII）指標を Google に提供します。このデータは、プロダクト開発とサポートの優先順位付けに役立ちます。
収集される指標は次のとおりです。
- 一意のインストール ID（仮名化された UUID）
- AlloyDB Omni のバージョンと PostgreSQL のメジャー バージョン
- CPU 数、RAM、稼働時間などのホストシステム情報
テレメトリー報告を無効にする
テレメトリー エージェントが実行されて使用状況指標が報告されないようにするには、PostgreSQL 構成パラメータ omni_enable_telemetry を off に設定します。postgresql.conf ファイルでテレメトリー フラグを設定するか、ALTER SYSTEM を使用して実行時にフラグを設定することで、テレメトリー エージェントを無効にできます。
postgresql.conf ファイルでテレメトリー フラグを設定する
PostgreSQL 構成ファイルを変更する手順は次のとおりです。
- データベースのデータ ディレクトリで
postgresql.confファイルを見つけます。デフォルトは/var/lib/postgresql/MAJOR_VERSION/dataです。 AlloyDB Omni テレメトリーを無効にします。
omni_enable_telemetry = off
変更を適用するには、AlloyDB Omni サービスを再起動します。テレメトリー エージェントは、使用状況の指標の収集と Google への送信を停止します。
systemctl restart alloydbomniMAJOR_VERSION
ALTER SYSTEM を使用して実行時にテレメトリー フラグを設定する
テレメトリー フラグを設定し、再起動後も変更を維持する手順は次のとおりです。
psqlを使用して AlloyDB Omni インスタンスに接続します。/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
次のコマンドを実行します。
ALTER SYSTEM SET omni_enable_telemetry = 'off';
データベース サービスを再起動して、変更がバックグラウンド ワーカーによって完全に反映されるようにします。
systemctl restart alloydbomni18
テレメトリー エージェントは、使用状況の指標の収集と Google への送信を停止します。
テレメトリー報告を有効にする
以前に AlloyDB Omni テレメトリーを無効にした場合は、omni_enable_telemetry フラグを on に設定することで再度有効にできます。テレメトリー エージェントを有効にするには、postgresql.conf ファイルでフラグを設定するか、ALTER SYSTEM を使用して実行時にフラグを設定します。
postgresql.conf ファイルでテレメトリー フラグを設定する
- データベースのデータ ディレクトリで
postgresql.confファイルを見つけます。 次の行を設定します。
omni_enable_telemetry = on
変更を適用するには、AlloyDB Omni サービスを再起動します。
systemctl restart alloydbomni18
ALTER SYSTEM を使用して実行時にテレメトリー フラグを設定する
psqlを使用して AlloyDB Omni インスタンスに接続します。次のコマンドを実行します。
ALTER SYSTEM SET omni_enable_telemetry = 'on';
変更を適用するには、AlloyDB Omni サービスを再起動します。
systemctl restart alloydbomni18
AlloyDB Omni テレメトリーのステータスを確認する
AlloyDB Omni テレメトリー エージェントのステータス（有効になっているかどうか、無効になっているかどうかなど）を確認できます。テレメトリー エージェントのアクティビティを確認することも可能です。
テレメトリー エージェントが有効か無効かを確認する
テレメトリー設定のステータスを確認する手順は次のとおりです。
- インスタンスに接続します。
- 以下のコマンドを実行します。
SHOW omni_enable_telemetry;
AlloyDB Omni テレメトリーを無効にしたか有効にしたかに応じて、出力は on または off を返します。
テレメトリー エージェントが実行されているかどうかを確認する
テレメトリー エージェントが実行されているかどうかを確認するには、ホストで次のコマンドを実行します。
ps -ef | grep "omni telemetry worker"
テレメトリーが有効で実行中の場合、出力には postgres: omni telemetry worker というテキストを含む行が含まれます。
テレメトリー エージェントのアクティビティを確認する
テレメトリー エージェントのアクティビティを確認するには、ホストで次のコマンドを実行します。
journalctl -u alloydbomni18 | grep telemetry
テレメトリー エージェントが実行されている場合、ログには次のようなメッセージが含まれます。
LOG: [telemetry_agent_worker.cc:143] Started telemetry worker LOG: [telemetry_agent_worker.cc:161] Running telemetry reporting agent telemetry_agent: Uploading telemetry data to https://cloud.google.com/log.
インスタンスに接続する
環境に応じて、AlloyDB Omni インスタンスにローカルまたはリモートで接続できます。
ローカルで接続する
AlloyDB Omni インスタンスにローカルで接続するには、次のコマンドを実行します。/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost
リモートから接続する
/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN
次の変数を置き換えます。
HOST_PORT: インストール時に使用した TCP ポート。IP_ADDRESS_OR_FQDN: AlloyDB Omni が実行されているホストの IP アドレスまたは完全修飾ドメイン名。
拡張機能を有効にする
AlloyDB Omni で使用可能な拡張機能の一覧については、サポートされているデータベース拡張機能をご覧ください。PostGIS と Orafce は AlloyDB Omni には含まれていませんが、次の手順でインストールできます。
インストールされた拡張機能は、拡張機能を有効にするで説明されているように、標準の PostgreSQL CREATE EXTENSION ステートメントを使用して有効にします。