このページでは、さまざまなカスタマイズ方法がサポートされている AlloyDB Omni のインストールをカスタマイズする方法について説明します。このページでは、一般的なカスタマイズについて説明します。
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 構成ファイルを変更する手順は次のとおりです。
- データベースのデータ ディレクトリ（
$PGDATA）でpostgresql.confファイルを見つけます。 AlloyDB Omni テレメトリーを無効にします。
omni_enable_telemetry = off
変更を適用するには、AlloyDB Omni コンテナを再起動します。テレメトリー エージェントは、使用状況の指標の収集と Google への送信を停止します。
ALTER SYSTEM を使用して実行時にテレメトリー フラグを設定する
テレメトリー フラグを設定し、再起動後も変更を維持する手順は次のとおりです。
psqlを使用して AlloyDB Omni インスタンスに接続します。psql -h HOST -U USER -d DATABASE
次のように置き換えます。
HOST: AlloyDB Omni インスタンスのホスト名または IP アドレス（127.0.0.1など）。USER: 接続するデータベース ユーザー（postgresなど）。DATABASE: 接続するデータベース（例:postgres）。
次のコマンドを実行します。
ALTER SYSTEM SET omni_enable_telemetry = 'off';
構成を再読み込みするか、インスタンスを再起動します。一部のコンテナ構成では、その変更がバックグラウンド ワーカーに確実に反映されるようにするために、インスタンスの再起動が必要となる場合があります。
SELECT pg_reload_conf();
テレメトリー エージェントは、使用状況の指標の収集と Google への送信を停止します。
テレメトリー報告を有効にする
以前に AlloyDB Omni テレメトリーを無効にした場合は、omni_enable_telemetry フラグを on に設定することで再度有効にできます。テレメトリー エージェントを有効にするには、postgresql.conf ファイルでフラグを設定するか、ALTER SYSTEM を使用して実行時にフラグを設定します。
postgresql.conf ファイルでテレメトリー フラグを設定する
- データベースのデータ ディレクトリ（
$PGDATA）でpostgresql.confファイルを見つけます。 次の行を設定します。
omni_enable_telemetry = on
変更を適用するには、AlloyDB Omni コンテナを再起動します。
ALTER SYSTEM を使用して実行時にテレメトリー フラグを設定する
psqlを使用して AlloyDB Omni インスタンスに接続します。次のコマンドを実行します。
ALTER SYSTEM SET omni_enable_telemetry = 'on';
変更を適用するには、AlloyDB Omni コンテナを再起動します。
docker restart CONTAINER_NAME
次のように置き換えます。
CONTAINER_NAME: AlloyDB Omni コンテナの名前（my-omni-1など）。
AlloyDB Omni テレメトリーのステータスを確認する
AlloyDB Omni テレメトリー エージェントのステータス（有効になっているかどうか、実行中かどうかなど）を確認できます。テレメトリー エージェントのアクティビティを確認することも可能です。
テレメトリー エージェントが有効か無効かを確認する
テレメトリー設定のステータスを確認する手順は次のとおりです。
- インスタンスに接続します。
- 以下のコマンドを実行します。
SHOW omni_enable_telemetry;
AlloyDB Omni テレメトリーを無効にしたか有効にしたかに応じて、出力は on または off を返します。
テレメトリー エージェントが実行されているかどうかを確認する
テレメトリー エージェントが実行されているかどうかを確認するには、コンテナホストで次のコマンドを実行します。
docker top CONTAINER_NAME
次のように置き換えます。
CONTAINER_NAME: AlloyDB Omni コンテナの名前（my-omni-1など）。
テレメトリーが有効で実行中の場合、出力には postgres: omni telemetry worker というテキストを含む行が含まれます。
テレメトリー エージェントのアクティビティを確認する
テレメトリー エージェントのアクティビティを確認するには、コンテナホストで次のコマンドを実行します。
docker logs CONTAINER_NAME 2>&1 | grep telemetry
次のように置き換えます。
CONTAINER_NAME: AlloyDB Omni コンテナの名前（my-omni-1など）。
テレメトリー エージェントが実行されている場合、ログには次のようなメッセージが含まれます。
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 インスタンスにローカルまたはリモートで接続できます。
ローカルで接続する
Docker
docker exec -it CONTAINER_NAME psql -U postgres
Docker
docker exec -it CONTAINER_NAME psql -U postgres
Podman
podman exec -it CONTAINER_NAME psql -U postgres
Podman
podman exec -it CONTAINER_NAME psql -U postgres
次の変数を置き換えます。
CONTAINER_NAME: AlloyDB Omni コンテナの名前（my-omni-1など）。
リモートから接続する
/usr/lib/postgresql/17/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 ステートメントを使用して有効にします。