AlloyDB Omni 설치 맞춤설정

문서 버전을 선택합니다.

이 페이지에서는 다양한 형태의 맞춤설정을 지원하는 AlloyDB Omni 설치를 맞춤설정하는 방법을 설명합니다. 이 페이지에서는 몇 가지 일반적인 맞춤설정을 보여줍니다.

AlloyDB Omni 원격 분석 사용 설정 및 중지

AlloyDB Omni 원격 분석은 가명처리된 기본 측정항목 집합을 수집하여 Google 관리 엔드포인트로 전송하는 경량 클라이언트 에이전트를 구현합니다.

AlloyDB Omni는 무료로 제공되는 다운로드 가능한 제품이므로 이 원격 분석은 실행 중인 인스턴스의 일반적인 도입 및 배포 환경에 관한 필수적인 개인 식별이 불가능한 정보 측정항목을 Google에 제공합니다. 이 데이터는 제품 개발 및 지원 우선순위를 결정하는 데 도움이 됩니다.

수집되는 측정항목은 다음과 같습니다.

  • 고유 설치 ID(가명처리된 UUID)
  • AlloyDB Omni 버전 및 PostgreSQL 메이저 버전
  • CPU 수, RAM, 업타임과 같은 호스트 시스템 정보

원격 분석 보고 중지

원격 분석 에이전트가 실행되고 사용량 측정항목을 보고하지 않도록 하려면 PostgreSQL 구성 파라미터 omni_enable_telemetry를 off로 설정합니다. postgresql.conf 파일에서 원격 분석 플래그를 설정하거나 ALTER SYSTEM을 사용하여 런타임에 플래그를 설정하여 원격 분석 에이전트를 중지할 수 있습니다.

postgresql.conf 파일에서 원격 분석 플래그 설정

PostgreSQL 구성 파일을 수정하려면 다음 단계를 따르세요.

  1. 데이터베이스의 데이터 디렉터리에서 postgresql.conf 파일을 찾습니다. 기본적으로 /var/lib/postgresql/MAJOR_VERSION/data입니다.

  2. AlloyDB Omni 원격 분석을 중지합니다.

    omni_enable_telemetry = off

  3. 변경사항을 적용하려면 AlloyDB Omni 서비스를 다시 시작합니다. 원격 분석 에이전트가 사용량 측정항목 수집과 Google로의 전송을 중지합니다.

    systemctl restart alloydbomniMAJOR_VERSION

ALTER SYSTEM을 사용하여 런타임에 원격 분석 플래그 설정

원격 분석 플래그를 설정하고 다시 시작한 후에도 변경사항이 유지되도록 하려면 다음 단계를 따르세요.

  1. psql을 사용하여 AlloyDB Omni 인스턴스에 연결합니다.

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

  2. 다음 명령어를 실행합니다.

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. 백그라운드 작업자가 변경사항을 완전히 반영하도록 데이터베이스 서비스를 다시 시작합니다.

    systemctl restart alloydbomni18

    원격 분석 에이전트가 사용량 측정항목 수집과 Google로의 전송을 중지합니다.

원격 분석 보고 사용 설정

이전에 AlloyDB Omni 원격 분석을 중지한 경우 omni_enable_telemetry 플래그를 on으로 설정하여 다시 사용 설정할 수 있습니다. postgresql.conf 파일에서 플래그를 설정하거나 ALTER SYSTEM을 사용하여 런타임에 플래그를 설정하여 원격 분석 에이전트를 사용 설정합니다.

postgresql.conf 파일에서 원격 분석 플래그 설정

  1. 데이터베이스의 데이터 디렉터리에서 postgresql.conf 파일을 찾습니다.

  2. 다음 줄을 설정합니다.

    omni_enable_telemetry = on

  3. 변경사항을 적용하려면 AlloyDB Omni 서비스를 다시 시작합니다.

    systemctl restart alloydbomni18

ALTER SYSTEM을 사용하여 런타임에 원격 분석 플래그 설정

  1. psql을 사용하여 AlloyDB Omni 인스턴스에 연결합니다.

  2. 다음 명령어를 실행합니다.

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. 변경사항을 적용하려면 AlloyDB Omni 서비스를 다시 시작합니다.

    systemctl restart alloydbomni18

AlloyDB Omni 원격 분석 상태 확인

AlloyDB Omni 원격 분석 에이전트의 상태를 확인하여 사용 설정되었는지 또는 중지되었는지 여부를 알 수 있습니다. 또한 원격 분석 에이전트의 활동 상태도 확인할 수 있습니다.

원격 분석 에이전트가 사용 설정되었는지 또는 중지되었는지 확인

원격 분석 설정 상태를 확인하려면 다음 단계를 따르세요.

  1. 내 인스턴스에 연결합니다.
  2. 다음을 실행합니다.
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 문을 사용하여 사용 설정됩니다.