本頁說明如何自訂 AlloyDB Omni 安裝作業，支援各種形式的自訂。本頁列出一些常見的自訂項目。
啟用及停用 AlloyDB Omni 遙測功能
AlloyDB Omni 遙測功能會實作輕量型用戶端代理程式，只在 AlloyDB Omni 容器映像檔中執行。這個代理程式會定期收集一組基本的匿名指標，並傳送至 Google 代管的端點。
AlloyDB Omni 是可免費下載的產品，因此這項遙測功能會提供 Google 重要的非個人識別資訊 (非 PII) 指標，瞭解執行個體的一般採用和部署環境。這類資料有助於產品開發，並決定支援服務的優先順序。
收集的指標包括：
- 專屬安裝 ID (去識別化 UUID)
- AlloyDB Omni 版本和 PostgreSQL 主要版本
- 主機系統資訊，例如 CPU 數量、RAM 和運作時間
- 資料庫設定和功能使用資訊，包括資料庫旗標、Grand Unified Configuration 或 GUC 參數，以及與 AlloyDB Omni 功能和資料庫功能使用情形相關的匯總統計資料
停用遙測回報功能
如要防止遙測代理程式執行及回報用量指標，請將 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;
輸出內容會傳回 on 或 off，視您是否停用或啟用 AlloyDB Omni 遙測功能而定。
檢查遙測代理程式是否正在執行
如要檢查遙測代理程式是否正在執行，請在容器主機中執行下列指令：
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/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 提供的擴充功能清單，請參閱「支援的資料庫擴充功能」。雖然 AlloyDB Omni 未內建 PostGIS 和 Orafce，但您可以按照下列操作說明安裝這兩者：
如要啟用已安裝的擴充功能，請使用標準 PostgreSQL CREATE EXTENSION 陳述式，詳情請參閱「啟用擴充功能」。